глава 05

Шпаргалка

Где какой конфиг

| Клиент | Где лежит конфиг | | --- | --- | | Claude Desktop | claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) | | Проект | .mcp.json в корне проекта | | Cursor | Настройки MCP в интерфейсе (Settings, раздел MCP) | | Codex | Конфиг Codex, секция MCP-серверов |

Формат записи везде один: блок mcpServers с command, args и при необходимости env.

Глоссарий

tool
Действие или функция, которую сервер даёт модели: поиск, отправка, запрос к базе. Модель вызывает tool сама, когда решает, что он нужен.
resource
Данные или файл, которые модель может прочитать для контекста: файл, запись, документ. В отличие от tool - не действие, а чтение.
prompt
Готовая заготовка запроса, которую сервер предлагает пользователю как быструю команду.
transport (транспорт)
Способ связи клиента и сервера. stdio - локальный процесс через стандартный ввод-вывод. HTTP/SSE - удалённый сервер по сети.
host / client (хост, клиент)
Приложение с языковой моделью: Claude Desktop, Cursor, Codex. Запускает серверы и вызывает их возможности.
server (сервер)
Программа, которая объявляет возможности (tools, resources, prompts) и исполняет запросы клиента.

Быстрый чек-лист подключения

  1. Нашли конфиг своего клиента.
  2. Добавили блок mcpServers с командой запуска сервера.
  3. Секреты (токены) - в env или локальный конфиг, не в общий репозиторий.
  4. Перезапустили клиент полностью.
  5. Проверили сервер в списке MCP и дали проверочную задачу.

Дальше по базе знаний