MCP

Как подключить к агенту внешние сервисы через Model Context Protocol — попросить агента, отредактировать .mcp.json вручную, какие бывают серверы и как хранить их ключи.

MCP (Model Context Protocol) — открытый стандарт, по которому внешние сервисы дают агенту свои инструменты: таблицы, CRM, трекеры задач, базы данных, соцсети, биржи. Подключил MCP-сервер — и у агента появились новые действия, например «создай задачу в трекере» или «прочитай строки из таблицы».

Где действует

MCP-серверы, как и навыки, подключаются к оркестратору или к конкретному проекту. Сервер проекта доступен агенту только в этом проекте. Настройки хранятся в файле .mcp.json в папке проекта (или оркестратора).

Подключить через агента

Самый простой путь — попросить в чате, указав, что это за сервер:

«Подключи MCP-сервер Notion. Запуск: npx -y @notionhq/notion-mcp-server, токен я вставлю сам».

«Подключи MCP по адресу https://mcp.example.com/mcp с заголовком Authorization: Bearer …».

Агент добавит сервер в .mcp.json текущего проекта, и его инструменты станут доступны сразу, в том же разговоре.

Подключить вручную

Настройки → MCP. Справа вверху выбери оркестратора или проект. Экран показывает подключённые серверы, а внизу — сам файл .mcp.json для редактирования. После правки нажми Сохранить .mcp.json.

Формат — такой же, как у Cursor и Claude Desktop:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": { "NOTION_TOKEN": "secret_…" }
    },
    "tracker": {
      "url": "https://mcp.example.com/mcp",
      "headers": { "Authorization": "Bearer …" }
    }
  }
}

Два вида серверов

Вид	Как задаётся	Где работает
Локальный (stdio)	`command`, `args`, `env`	Запускается внутри воркспейса как программа. Обычно через `npx` или `uvx`
Удалённый (HTTP)	`url`, `headers`	Работает у поставщика сервиса, агент обращается к нему по сети

Если у сервиса есть оба варианта, удалённый обычно проще: ничего не нужно устанавливать.

Как агент пользуется MCP

Агент видит список подключённых серверов и их инструментов и вызывает их, когда задача этого требует. Можно направить явно: «через MCP трекера посмотри мои задачи на сегодня».

Если не работает

Попроси агента: «проверь MCP-сервер tracker» — он покажет ошибку запуска или ответа.
Для локального сервера проверь, что команда запускается: пакет существует, версия Node или Python подходит.
Для удалённого проверь адрес и заголовок авторизации.
Если воркспейс в облаке был во сне, первый запрос к локальному серверу может занять лишние секунды, пока он запускается.

#Где действует

#Подключить через агента

#Подключить вручную

#Два вида серверов

#Как агент пользуется MCP

#Если не работает