Документация → Claude

Подключение к Claude

Как настроить MCP-сервер Яндекс Директа в Claude Desktop и Claude Code.

Требования

Claude Desktop

1

Откройте настройки Claude Desktop

Меню Claude → Settings → Developer → Edit Config. Откроется файл claude_desktop_config.json.

2

Добавьте MCP-сервер

Вставьте конфигурацию в файл, заменив ВАШ_API_КЛЮЧ на ключ из личного кабинета:

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

Перезапустите Claude Desktop

Полностью закройте и откройте приложение. В новом чате вы увидите иконку MCP-инструментов внизу поля ввода.

Совет: готовый конфиг с вашим ключом можно скопировать прямо из личного кабинета — не нужно ничего вводить вручную.

Claude Code (CLI)

В Claude Code подключить MCP-сервер можно одной командой:

Terminal 
claude mcp add yandex-direct \
  --transport http \
  --url http://192.168.100.220:3001/mcp \
  --header "Authorization: Bearer ВАШ_API_КЛЮЧ"

Или добавьте в файл .mcp.json в корне проекта:

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

Проверка подключения

После подключения напишите в чат:

Промпт 
Покажи мои рекламные кампании в Яндекс Директе

Claude вызовет инструмент get_campaigns и покажет список ваших кампаний с бюджетами и статусами.

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

MCP-инструменты не появляются

Проверьте, что файл конфига сохранён, JSON валиден и Claude Desktop полностью перезапущен (не просто свёрнут).

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

Убедитесь, что API-ключ скопирован правильно, без лишних пробелов. Актуальный ключ всегда доступен в личном кабинете.

Ошибка Yandex Direct API

Проверьте, что в личном кабинете указан валидный OAuth-токен Яндекса и что доступ к API для приложения одобрен.