# MCP

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

Source: https://eggent.ai/r/docs/mcp/

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

## Где действует {#scope}

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

## Подключить через агента {#via-agent}

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

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

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

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

> [!WARNING]
> Токены и ключи сервисов попадают в `.mcp.json`. Этот файл не синхронизируется с компьютером, но если вставить ключ прямо в сообщение, он останется в истории чата. Лучше вписать секрет в **Настройки → MCP** вручную.

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

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

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

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

## Два вида серверов {#types}

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

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

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

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

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

- Попроси агента: «проверь MCP-сервер tracker» — он покажет ошибку запуска или ответа.
- Для локального сервера проверь, что команда запускается: пакет существует, версия Node или Python подходит.
- Для удалённого проверь адрес и заголовок авторизации.
- Если воркспейс в облаке был во [сне](https://eggent.ai/r/docs/sleep.md), первый запрос к локальному серверу может занять лишние секунды, пока он запускается.