Подключение к любому ИИ

Общие настройки для подключения MCP-сервера Яндекс Директа к любому MCP-совместимому клиенту.

Параметры подключения

Для подключения к MCP-серверу вам нужны три параметра:

Параметр	Значение
URL сервера	`http://192.168.100.220:3001/mcp`
Транспорт	Streamable HTTP (HTTP + SSE)
Авторизация	Заголовок `Authorization: Bearer ВАШ_API_КЛЮЧ`

API-ключ можно получить в личном кабинете после регистрации и подключения Yandex-токена.

Формат конфигурации

Большинство MCP-клиентов используют JSON-конфигурацию. Стандартный формат:

mcp.json / mcp_config.json

{
  "mcpServers": {
    "yandex-direct": {
      "url": "http://192.168.100.220:3001/mcp",
      "headers": {
        "Authorization": "Bearer ВАШ_API_КЛЮЧ"
      }
    }
  }
}

Совет: если клиент просит указать тип транспорта, выберите http или streamable-http (не stdio). Наш сервер работает через HTTP.

Совместимые MCP-клиенты

MCP-сервер Яндекс Директа работает с любым клиентом, поддерживающим Streamable HTTP транспорт:

Cursor

IDE с ИИ-ассистентом

Windsurf

IDE от Codeium

Cline

Расширение VS Code

Cherry Studio

Десктопный MCP-клиент

Claude Desktop

Отдельная инструкция

ChatGPT

Отдельная инструкция

Как это работает

Протокол MCP (Model Context Protocol) позволяет ИИ-моделям взаимодействовать с внешними сервисами через стандартизированный интерфейс:

Подключение — клиент устанавливает HTTP-соединение с сервером
Обнаружение — клиент вызывает tools/list и получает список доступных инструментов с описаниями и схемами параметров
Вызов — когда пользователь задаёт вопрос, ИИ выбирает нужный инструмент и вызывает tools/call с параметрами
Ответ — сервер выполняет запрос к Yandex Direct API и возвращает результат

Пример HTTP-запроса

Если ваш клиент не поддерживает MCP напрямую, запросы можно отправлять вручную:

HTTP Request

POST http://192.168.100.220:3001/mcp
Content-Type: application/json
Authorization: Bearer ВАШ_API_КЛЮЧ

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/list",
  "params": {}
}

Возможные проблемы

Клиент не поддерживает HTTP-транспорт

Некоторые MCP-клиенты поддерживают только stdio (локальный процесс). В этом случае можно использовать mcp-proxy для преобразования HTTP в stdio.

CORS-ошибки

Сервер поддерживает CORS для всех доменов. Если вы видите CORS-ошибки, проверьте, что клиент отправляет запросы напрямую на сервер, а не через прокси.

Ошибка авторизации (401)

Убедитесь, что заголовок Authorization передаётся в формате Bearer ВАШ_КЛЮЧ с пробелом после Bearer. Актуальный ключ доступен в личном кабинете.