MCP-серверы

Подключите Command Code к внешним инструментам и источникам данных через MCP-серверы. MCP — открытый протокол, который позволяет Command Code взаимодействовать с внешними сервисами: базами данных, API, трекерами задач и другими.

Что такое MCP

MCP (Model Context Protocol) — открытый протокол, который позволяет ИИ-агентам подключаться к внешним инструментам и сервисам. С MCP Command Code может работать с базами данных, API, инструментами разработки и многим другим — всё через стандартизованный интерфейс.

Вместо собственных интеграций вы подключаете MCP-серверы, а Command Code сам обнаруживает их инструменты и использует их.

Что можно делать

С подключёнными MCP-серверами вы можете попросить Command Code:

Вести проектную работу: «Создай задачу в GitHub по найденному багу и назначь её на меня».
Запрашивать базы данных: «Покажи всех пользователей, зарегистрировавшихся за последние 7 дней, из нашей базы Postgres».
Интегрироваться с сервисами: «Найди в Notion документ с дизайном API и перескажи его».
Автоматизировать процессы: «Проверь PR #123 на GitHub, затем опубликуй сводку в Slack».

Быстрый старт

Добавьте первый MCP-сервер в Command Code меньше чем за минуту.

Шаг 1. Добавьте MCP-сервер. Выберите транспорт:

bash

cmd mcp add --transport http <name> <url>

Пример:

bash

cmd mcp add --transport http notion https://mcp.notion.com/mcp

Шаг 2. Авторизуйтесь, если попросят. Некоторые удалённые серверы требуют OAuth. Откройте меню MCP:

bash

/mcp

Следуйте приглашению в браузере, чтобы войти. Токены хранятся безопасно и обновляются автоматически.

При необходимости передайте заголовки аутентификации:

bash

cmd mcp add --transport http private-api https://api.company.com/mcp \
  --header "X-API-Key: your-key-here"

Все опции (--transport, --env, --scope, --header) должны идти перед именем сервера. -- отделяет имя сервера от локальной команды для stdio-серверов.

Шаг 3. Проверьте подключение. Покажите список настроенных серверов:

bash

cmd mcp list

Или посмотрите один сервер:

bash

cmd mcp get notion

Внутри сессии /mcp показывает статус подключения и доступные инструменты.

Шаг 4. Попробуйте в деле. Запустите сессию:

bash

cmd

Затем попросите обычным языком:

text

Create a note on Notion named "API Design v2".

Command Code автоматически находит и вызывает нужные MCP-инструменты по вашему запросу.

Шаг 5. Опционально: добавьте MCP-серверы из JSON. Для сложных настроек используйте JSON:

bash

cmd mcp add-json my-server '{
  "transport": "http",
  "url": "https://api.example.com/mcp",
  "headers": {
    "Authorization": "Bearer ${API_KEY}"
  }
}'

Пример:

bash

cmd mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer ghp_xxx"}}'

Для переноса конфигураций между машинами или для скриптов:

JSON принимает type как синоним transport.
Переменные окружения в значениях конфигурации (например, ${API_KEY} или ${API_KEY:-default}) разворачиваются во время выполнения — в headers для http и в env для stdio. Значение по умолчанию применяется, когда переменная не задана или пуста, как в оболочке. Переменная, которая не задана и не имеет значения по умолчанию, останавливает этот сервер с ошибкой, в которой названо имя переменной. Напишите $${NAME}, чтобы отправить текст ${NAME} буквально.

Шаг 6. Опционально: импортируйте из другого агента. Если вы уже настроили MCP-серверы в другом агенте для кодинга, перенесите их слэш-командой /import внутри сессии. Без аргумента она забирает из всех обнаруженных источников:

bash

/import

Чтобы взять один источник, назовите его. Каждый аргумент соответствует только этому агенту, поэтому выберите тот, в котором реально лежит ваша конфигурация MCP:

bash

/import claude # Claude Code
/import codex # Codex
/import cursor # Cursor
/import opencode # OpenCode
/import gemini # Gemini CLI

Она импортирует MCP-серверы вместе с навыками, агентами, пользовательскими командами и памятью. См. Import.

Добавление MCP-серверов

HTTP-транспорт (удалённые серверы)

Используйте --transport http, чтобы подключаться к удалённым MCP-серверам:

bash

cmd mcp add --transport http notion https://mcp.notion.com/mcp

Stdio-транспорт (локальные процессы)

Stdio — транспорт по умолчанию. Используйте --, чтобы отделить имя сервера от команды:

bash

cmd mcp add my-tool -- npx @my-org/mcp-server

Порядок опций

Все флаги (--transport, --scope, --env, --header) должны идти перед именем сервера. -- отделяет имя сервера от stdio-команды и её аргументов.

Опции команды

Флаг	Описание	По умолчанию
`-t, --transport <type>`	Тип транспорта: `stdio` или `http`	`stdio`
`-s, --scope <scope>`	Где хранить: `local`, `project` или `user`	`local`
`-e, --env <KEY=value>`	Переменная окружения (можно повторять)	-
`-H, --header <Header: value>`	HTTP-заголовок (можно повторять, только http)	-

Справочник команд

Всё управление MCP идёт через cmd mcp <subcommand>.

Команда	Описание	Пример
`cmd mcp add`	Добавить сервер опциями CLI	`cmd mcp add --transport http notion https://mcp.notion.com/mcp`
`cmd mcp add-json`	Добавить сервер из JSON-конфигурации	`cmd mcp add-json github '{"type":"http","url":"https://..."}'`
`cmd mcp list`	Показать все настроенные серверы	`cmd mcp list`
`cmd mcp get <name>`	Показать детали сервера	`cmd mcp get notion`
`cmd mcp remove <name>`	Удалить сервер из конфигурации	`cmd mcp remove notion`
`cmd mcp auth <server>`	Аутентифицироваться через OAuth (открывает браузер)	`cmd mcp auth notion`
`cmd mcp auth --status <server>`	Проверить статус аутентификации	`cmd mcp auth --status notion`
`cmd mcp auth --list`	Перечислить все серверы с сохранёнными токенами	`cmd mcp auth --list`
`cmd mcp auth --clear <server>`	Очистить сохранённые токены	`cmd mcp auth --clear notion`

Конфигурация и области хранения

MCP-серверы можно хранить в трёх областях с разной видимостью:

Область	Расположение файла	Назначение
`local`	`~/.commandcode/projects/<slug>/mcp.json`	Личная, для конкретного проекта (по умолчанию)
`project`	`.mcp.json` в корне проекта	Общая, под контролем версий
`user`	`~/.commandcode/mcp.json`	Личная, доступна во всех проектах

Приоритет: когда один и тот же сервер есть в нескольких областях, local переопределяет project, а project переопределяет user.

bash

cmd mcp add --transport http notion https://mcp.notion.com/mcp

Контроль версий

Область project сохраняет в .mcp.json в корне проекта, который предполагается коммитить в Git. Секреты OAuth-клиента автоматически вырезаются из этого файла и хранятся безопасно в ~/.commandcode/mcp-tokens.json.

Локальная область (по умолчанию)

Хранится в ~/.commandcode/. Доступна только вам и только для текущего проекта.

bash

cmd mcp add --transport http stripe https://mcp.stripe.com
# Explicit:
cmd mcp add --transport http stripe --scope local https://mcp.stripe.com

Область проекта

Хранится в .mcp.json в корне проекта. Попадает в контроль версий — доступна вашей команде.

bash

cmd mcp add --transport http stripe --scope project https://mcp.stripe.com

Команда создаёт или обновляет .mcp.json:

json

{
  "mcpServers": {
    "stripe": {
      "transport": "http",
      "url": "https://mcp.stripe.com"
    }
  }
}

Область пользователя

Хранится в ~/.commandcode/mcp.json. Доступна вам во всех проектах.

bash

cmd mcp add --transport http stripe --scope user https://mcp.stripe.com

Схема конфигурации

Файлы конфигурации следуют такой схеме:

json

{
  "mcpServers": {
    "my-server": {
      "transport": "http",
      "enabled": true,
      "url": "https://api.example.com/mcp",
      "headers": { "Authorization": "Bearer token" },
      "env": { "API_KEY": "value" }
    }
  }
}

Аутентификация

Поток OAuth

Command Code поддерживает OAuth 2.0 Authorization Code с PKCE для HTTP-серверов.

Добавьте сервер, которому нужен OAuth.
bash
```
cmd mcp add --transport http my-server https://api.example.com/mcp
```
Если серверу нужна аутентификация, Command Code сам это определяет и запускает поток OAuth.
Авторизуйтесь через браузер. Откроется окно браузера для выдачи доступа. После предоставления доступа токены безопасно сохраняются в ~/.commandcode/mcp-tokens.json.
Аутентифицироваться можно и позже:
bash
```
cmd mcp auth my-server
```
Или используйте меню /mcp внутри сессии, чтобы авторизоваться интерактивно.
Токены обновляются автоматически. Токены обновляются автоматически при истечении срока. Если обновление не удалось, аутентифицируйтесь заново через cmd mcp auth <server>.
bash
```
cmd mcp auth --status my-server
```

Поток OAuth (удалённые серверы)

Многие удалённые MCP-серверы поддерживают OAuth 2.0. Используйте /mcp внутри Command Code, чтобы авторизоваться:

bash

/mcp

Выберите сервер и пройдите вход в браузере. Токены хранятся безопасно и обновляются автоматически.

Советы:

используйте «Clear authentication» в /mcp, чтобы отозвать доступ;
если браузер не открывается автоматически, скопируйте предложенный URL;
OAuth работает с серверами на транспортах HTTP и SSE.

OAuth с JSON

bash

cmd mcp add-json my-server \
  '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' \
  --client-secret

Аутентификация по API-ключу

Для серверов, которые используют API-ключи, передавайте их как переменные окружения или заголовки:

bash

# Via env
cmd mcp add --transport stdio --env API_KEY=your-key my-server \
  -- npx -y my-mcp-server

# Via header
cmd mcp add --transport http my-server https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

Меню `/mcp`

Внутри сессии Command Code наберите /mcp, чтобы открыть интерактивный менеджер MCP.

bash

/mcp

Меню показывает:

все настроенные серверы со статусом подключения;
цветовые индикаторы: зелёный (подключён), голубой (аутентифицирован), жёлтый (требуется аутентификация), красный (ошибка);
количество инструментов у каждого подключённого сервера;
действия: подключить, аутентифицировать или удалить сервер.

Использование MCP-инструментов

Когда сервер подключён, его инструменты появляются рядом со встроенными. Они следуют соглашению об именовании mcp__<server>__<tool>:

text

mcp__notion__search_page
mcp__github__create_issue

Запоминать имена инструментов не нужно. Просто опишите, что хотите:

text

Search for the API design doc on Notion.

Command Code находит и вызывает нужный MCP-инструмент автоматически.

Примеры серверов

Список полезных MCP-серверов и того, как добавить их в Command Code. Эти серверы расширяют Command Code доступом к внешним инструментам, документации и сервисам.

Notion

Поиск, чтение и создание страниц в вашем рабочем пространстве Notion.

bash

cmd mcp add --transport http notion https://mcp.notion.com/mcp

После добавления аутентифицируйтесь через меню /mcp внутри сессии Command Code.

GitHub

Управляйте GitHub сверх того, что умеет git: задачи, PR, поиск по коду и другое. Нужен ваш GitHub Personal Access Token (PAT).

Fine-grained токен (рекомендуется) — ограничен конкретными репозиториями, минимальные разрешения:

Перейдите в GitHub > Settings > Developer settings > Personal access tokens > Fine-grained tokens.
Нажмите Generate new token.
Назовите его commandcode-mcp, задайте срок действия по необходимости.
Repository access → выберите «All repositories» или «Only select repositories».
Permissions → Repository permissions → раскройте и настройте:
- Contents: Read and write (для операций с файлами);
- Issues: Read and write (для работы с задачами);
- Pull requests: Read and write (для работы с PR);
- Metadata: Read-only (включается автоматически).
Сгенерируйте токен и скопируйте его.

Классический токен — более широкий доступ, проще настройка:

Перейдите в GitHub > Settings > Developer settings > Personal access tokens > Tokens (classic).
Назовите его commandcode-mcp, задайте срок действия по необходимости.
Отметьте область repo (включает все разрешения на репозитории).
Сгенерируйте токен и скопируйте его.

Замените YOUR_GITHUB_PAT на сгенерированный токен:

bash

cmd mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}'

Подробности — в инструкциях документации по установке GitHub MCP Server.

Playwright

Управляйте браузером и исследуйте его с помощью Playwright. Пишите и запускайте браузерные тесты, делайте скриншоты и автоматизируйте взаимодействие с вебом.

bash

cmd mcp add playwright -- npx -y @playwright/mcp@latest

Sentry

Доступ к логам Sentry, мониторинг ошибок и отладка проблем в продакшене.

bash

cmd mcp add --transport http sentry https://mcp.sentry.dev/mcp

После добавления аутентифицируйтесь через меню /mcp внутри сессии Command Code.

OpenAI Docs

Ищите и читайте документацию для разработчиков OpenAI прямо из ваших промптов.

bash

cmd mcp add --transport http openai-docs https://developers.openai.com/mcp

Context7

Подключение к актуальной документации для разработчиков. Динамически загружает документацию и примеры кода для конкретных версий из официальных источников.

bash

cmd mcp add context7 -- npx -y @upstash/context7-mcp

Добавьте в промпт use context7, чтобы подтянуть свежую документацию по любой библиотеке.

Figma

Доступ к вашим дизайнам Figma. Доступен и как удалённый, и как локальный сервер.

bash

cmd mcp add --transport http figma https://mcp.figma.com/mcp

Для удалённого сервера аутентифицируйтесь через меню /mcp после добавления. Локальному серверу нужен запущенный десктопный клиент Figma.

Chrome DevTools

Управляйте Chrome и исследуйте его из Command Code. Отладка страниц, скриншоты, взаимодействие с DOM.

bash

cmd mcp add chrome-devtools -- npx -y chrome-devtools-mcp@latest

Предварительное условие

Chrome должен быть запущен с флагом --remote-debugging-port=9222, иначе MCP-сервер не сможет подключиться.

Добавление любого MCP-сервера

Большинство MCP-серверов подключаются тремя способами: как удалённый HTTP-сервер, как локальный stdio-процесс или из JSON-конфигурации.

bash

cmd mcp add --transport http <name> <url>

Устранение неполадок

Сервер не подключается:

проверьте, что URL или команда верны: cmd mcp get <name>;
для stdio убедитесь, что команда установлена и есть в вашем PATH;
используйте /mcp, чтобы увидеть сообщение об ошибке подключения.

Проблемы с аутентификацией:

аутентифицируйтесь заново: cmd mcp auth <server>;
очистите и повторите: cmd mcp auth --clear <server>, затем cmd mcp auth <server>;
проверьте статус токена: cmd mcp auth --status <server>.

Инструменты не появляются:

убедитесь через /mcp, что сервер подключён;
серверу может понадобиться несколько секунд на инициализацию после запуска;
проверьте, что сервер вообще предоставляет инструменты (некоторые предоставляют только ресурсы).

Дальнейшие шаги

Справочник CLI по всем командам Command Code.
Слэш-команды для пользовательских промптов.
Спецификация протокола MCP, чтобы написать собственный MCP-сервер.
Присоединяйтесь к нашему сообществу в Discord за поддержкой.

Источник

Сверено с оригиналом 13 ноября 2026.

MCP-серверы ​

Что такое MCP ​

Что можно делать ​

Быстрый старт ​

Добавление MCP-серверов ​

HTTP-транспорт (удалённые серверы) ​

Stdio-транспорт (локальные процессы) ​

Опции команды ​

Справочник команд ​

Конфигурация и области хранения ​

Локальная область (по умолчанию) ​

Область проекта ​

Область пользователя ​

Схема конфигурации ​

Аутентификация ​

Поток OAuth ​

Поток OAuth (удалённые серверы) ​

OAuth с JSON ​

Аутентификация по API-ключу ​

Меню /mcp ​

Использование MCP-инструментов ​

Примеры серверов ​

Notion ​

GitHub ​

Playwright ​

Sentry ​

OpenAI Docs ​

Context7 ​

Figma ​

Chrome DevTools ​

Добавление любого MCP-сервера ​

Устранение неполадок ​

Дальнейшие шаги ​

MCP-серверы

Что такое MCP

Что можно делать

Быстрый старт

Добавление MCP-серверов

HTTP-транспорт (удалённые серверы)

Stdio-транспорт (локальные процессы)

Опции команды

Справочник команд

Конфигурация и области хранения

Локальная область (по умолчанию)

Область проекта

Область пользователя

Схема конфигурации

Аутентификация

Поток OAuth

Поток OAuth (удалённые серверы)

OAuth с JSON

Аутентификация по API-ключу

Меню `/mcp`

Использование MCP-инструментов

Примеры серверов

Notion

GitHub

Playwright

Sentry

OpenAI Docs

Context7

Figma

Chrome DevTools

Добавление любого MCP-сервера

Устранение неполадок

Дальнейшие шаги