Что такое MCP?

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

Как пользоваться

  1. Выберите клиент — ассистент или редактор, которым вы пользуетесь.
  2. Задайте имя сервера из букв, цифр, дефисов и подчёркиваний.
  3. Для локального сервера введите команду, которая его запускает (например, npx, uvx или docker), её аргументы по одному в строке и нужные переменные окружения, например ключи API, в виде KEY=value. Если вы вставили в поле команды целую командную строку, кнопка разделения внутри поля перенесёт всё, что идёт после первого слова, в аргументы.
  4. Для удалённого сервера выберите Удалённый URL и введите URL сервера и нужные заголовки, например Authorization: Bearer <token>.
  5. Скопируйте конфигурацию в файл, указанный в разделе Куда добавляется, или скачайте её. Если в файле уже есть серверы, добавьте новую запись рядом с ними внутри mcpServers ([mcp_servers] в Codex), а не заменяйте весь файл.
  6. Перезапустите приложение или перезагрузите его серверы MCP.

Для Claude Code, Codex CLI, Gemini CLI и VS Code в поле Команда также приводится команда для терминала, которая добавит сервер за вас.

Клиенты

Клиент Файл конфигурации Полезно знать
Claude Desktop claude_desktop_config.json Содержит только локальные серверы. Удалённые серверы добавляются в самом приложении: Настройки > Коннекторы > Добавить пользовательский коннектор.
Claude Code .mcp.json в корне проекта Команда claude mcp add вместо этого сохраняет серверы в ~/.claude.json — только для вас.
Cursor .cursor/mcp.json в проекте или ~/.cursor/mcp.json
VS Code с GitHub Copilot .mcp.json в корне рабочей области или ~/.copilot/mcp-config.json Старый формат servers в .vscode/mcp.json предназначен только для устаревшей локальной среды VS Code.
Codex CLI ~/.codex/config.toml Файл TOML. Заголовки удалённого сервера можно задать только в файле, но не с помощью codex mcp add.
Gemini CLI .gemini/settings.json в проекте или ~/.gemini/settings.json Удалённые серверы используют httpUrl.
Devin Desktop (Windsurf) ~/.config/devin/mcp_config.json или .devin/mcp_config.json Windsurf переименован в Devin Desktop. Личные ключи хранятся в .devin/mcp_config.local.json, который не попадает в систему контроля версий.

Chrome сохраняет скачанный файл .mcp.json под именем mcp.json, поэтому верните точку в начале имени, когда будете перемещать файл на место.

Безопасность ключей

В файлах конфигурации ключи API хранятся в виде обычного текста. Не добавляйте файл проекта с настоящими ключами в общий репозиторий. Большинство клиентов умеют брать ключ из переменных окружения, а не из файла, — у каждого свой синтаксис, описанный в его документации.

Всё собирается в вашем браузере, поэтому введённые вами команды, URL и ключи никуда не отправляются.