Руководство

Где лежит файл конфигурации MCP: Claude, Cursor, VS Code

6 мин чтенияОт команды Delta MCP

Сетка из двенадцати ИИ-приложений, включая Claude, Cursor, VS Code и Windsurf, со значком Delta MCP, рядом с ключами конфигурации mcpServers, servers и context_servers.

Короткий ответ

Большинство ИИ-приложений хранят MCP-серверы в одном JSON-файле под ключом mcpServers. VS Code использует servers, Zed — context_servers, а Codex — таблицу TOML. Найдите своё приложение ниже, отредактируйте его файл, затем закройте и снова откройте приложение. Лимиты инструментов встречаются редко: в VS Code — 128 на запрос, в Windsurf — 100.

В этом руководстве

Где находится файл конфигурации MCP в каждом приложении?

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

Где находится файл конфигурации MCP в каждом приложении?
ПриложениеФайл конфигурацииКлюч
Claude Codeclaude mcp add или /mcp в сессии
  • Все проекты~/.claude.json
  • Один проект.mcp.json
Ваши собственные серверы и серверы каждого проекта лежат в ~/.claude.json. Файл проекта .mcp.json предназначен для того, чтобы делиться им с командой.
mcpServers
Claude DesktopSettings, Developer, Edit Config
  • macOS~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows%APPDATA%\Claude\claude_desktop_config.json
Только локальные серверы. Claude Desktop доступен для macOS и Windows.
mcpServers
Cursor
  • Все проекты~/.cursor/mcp.json
  • Один проект.cursor/mcp.json
mcpServers
VS CodeКоманда: MCP: Open User Configuration
  • macOS~/Library/Application Support/Code/User/mcp.json
  • Windows%APPDATA%\Code\User\mcp.json
  • Linux~/.config/Code/User/mcp.json
  • Один проект.vscode/mcp.json
serversСобственный формат VS Code. Переносимый файл .mcp.json в корне проекта использует mcpServers.
WindsurfДокументация Windsurf теперь находится в разделе Devin Desktop
  • macOS · Linux~/.config/devin/mcp_config.json
  • Windows%APPDATA%\devin\mcp_config.json
  • ~/.codeium/windsurf/mcp_config.json
Первый путь — текущий, в разделе Devin Desktop. Последний используют прежние версии Windsurf.
mcpServers
Gemini CLI
  • Все проекты~/.gemini/settings.json
  • Один проект.gemini/settings.json
mcpServers
Codexcodex mcp add <name> -- <command>
  • Все проекты~/.codex/config.toml
  • Один проект.codex/config.toml
Файл проекта действует только для доверенных проектов.
[mcp_servers.<name>]Таблица TOML на каждый сервер.
LM StudioВкладка Program, Install, Edit mcp.json
  • ~/.lmstudio/mcp.json
mcpServers
ClineЗначок MCP Servers, вкладка Configure, Configure MCP Servers
  • ~/.cline/data/settings/cline_mcp_settings.json
  • …/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Чтобы перенести файл, задайте CLINE_MCP_SETTINGS_PATH. Внутри VS Code он лежит в папке пользовательских настроек.
mcpServers
Roo CodeMCP settings, Edit Global MCP или Edit Project MCP
  • Все проекты…/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
  • Один проект.roo/mcp.json
Файл проекта имеет приоритет над глобальным.
mcpServers
Amazon QПанель чата, значок инструментов
  • Все проекты~/.aws/amazonq/default.json
  • Один проект.amazonq/default.json
Панель записывает default.json. Более старые ~/.aws/amazonq/mcp.json и .amazonq/mcp.json по умолчанию по-прежнему читаются.
mcpServersВ более старом mcp.json.
ZedКоманда: zed: open settings file
  • macOS · Linux~/.config/zed/settings.json
  • Windows%APPDATA%\Zed\settings.json
context_servers

~ — ваша домашняя папка: C:\Users\you в Windows.

Как настроить удалённый MCP-сервер в каждом приложении?

Удалённому (HTTP) серверу нужен URL, но каждое приложение называет поля по-своему. Одна и та же запись не переносится из одного приложения в другое.

Как настроить удалённый MCP-сервер в каждом приложении?
ПриложениеПоляПолезно знать
Claude Code
  • "type": "http"
  • "url"
Claude Desktop — В этот файл не записывается. Добавьте его как пользовательский коннектор в разделе Connectors в настройках приложения.
Cursor
  • "url"
  • "headers"необязательно
VS Code
  • "type": "http"
  • "url"
Windsurf
  • "serverUrl"
  • "url"
  • "headers"необязательно
Для адреса подходит любое из двух имён.
Gemini CLI
  • "httpUrl"
  • "url"
  • "headers"необязательно
httpUrl — это streamable HTTP, url — SSE.
Codex
  • url
  • bearer_token_env_varнеобязательно
  • http_headersнеобязательно
Записывается в таблицу TOML сервера.
LM Studio
  • "url"
  • "headers"необязательно
Cline
  • "type": "streamableHttp"
  • "url"
  • "headers"необязательно
Для более старого транспорта используйте sse.
Roo Code
  • "type": "streamable-http"
  • "url"
  • "headers"необязательно
Для более старого транспорта используйте sse.
Amazon Q — Задаётся в панели MCP: выберите транспорт http, затем URL и необязательные заголовки.
Zed
  • "url"
  • "headers"необязательно

Какой лимит MCP-инструментов в каждом приложении?

Лимиты инструментов встречаются редко. Два приложения указывают такой лимит. Остальные справляются с длинными списками инструментов по-своему.

Какой лимит MCP-инструментов в каждом приложении?
ПриложениеЛимитЧто делается с длинными списками инструментов
VS Code 128 инструментов на запрос Сверх этого VS Code сообщает Cannot have more than 128 tools per request. Снимите выбор с инструментов или целых серверов в окне выбора инструментов или задайте github.copilot.chat.virtualTools.threshold, чтобы VS Code группировал похожие инструменты.
Windsurf 100 инструментов одновременно Отключайте инструменты по одному через disabledTools в записи сервера.
Cursor Не указан Часто называют лимит в 40 инструментов. В документации Cursor лимит не указан, а в записи от января 2026 года описана загрузка описаний MCP-инструментов по требованию.
Claude Code Не указан Tool Search включён по умолчанию: в контекст попадают только имена инструментов, пока инструмент не понадобится.
Codex Не указан Каждый сервер принимает списки enabled_tools и disabled_tools.
Amazon Q Не указан Для каждого инструмента задаётся Ask, Always allow или Deny.

Для Claude Desktop, Gemini CLI, LM Studio, Cline, Roo Code и Zed лимит инструментов не указан.

Лимит говорит о том, сколько инструментов помещается. Сколько эти инструменты стоят в токенах — другой вопрос, и ответ на него даёт руководство ниже. Почему MCP тратит так много токенов

Почему ваш MCP-сервер не появляется?

Идите по этому списку сверху вниз. Он составлен по руководству по устранению неполадок проекта MCP, написанному для Claude Desktop. Первые четыре шага подходят любому приложению.

  1. Полностью закройте приложение и откройте его снова

    В руководстве Claude Desktop сказано полностью закрыть его и запустить заново после правки файла. Другие приложения могут перезагружаться сами: если сервер не появился, откройте своё заново.

  2. Проверьте JSON и ключ

    Синтаксическая ошибка, например пропущенная кавычка или лишняя запятая, может помешать приложению прочитать файл. Затем проверьте ключ: mcpServers в большинстве приложений, servers в VS Code, context_servers в Zed.

  3. Используйте абсолютные пути

    Пути в args должны быть абсолютными, а не относительными.

  4. Запустите команду сами

    Вставьте команду сервера и её аргументы в терминал. Если там она не запускается, приложение тоже не сможет её запустить.

  5. Прочитайте логи

    Claude Desktop пишет mcp.log и по одному mcp-server-NAME.log на каждый сервер: в ~/Library/Logs/Claude на macOS и в %APPDATA%\Claude\logs в Windows.

  6. В Windows проверьте APPDATA

    Если в логе внутри пути видно ${APPDATA}, добавьте APPDATA в env сервера с полным значением, например C:\Users\you\AppData\Roaming\.

Нужно ли править эти файлы вручную?

Чтобы увидеть их все в одном месте — нет. Delta MCP читает настройки MCP двенадцати ИИ-приложений, перечисленных в таблицах выше, ничего не меняя, и показывает каждый найденный сервер.

Чтобы приложение работало с этими серверами через Delta MCP, он переключает его, добавляя одну запись с именем mcpdelta. Он отключает прямую запись каждого перенесённого сервера и сохраняет оригинал, чтобы вернуть всё как было. Десять приложений переключаются за вас; Codex и Zed пока настраиваются вручную. Перед каждым изменением он сохраняет копию файла с датой.

Поддерживаемые приложения — подробно

Вопросы

Где находится claude_desktop_config.json?

В macOS это ~/Library/Application Support/Claude/claude_desktop_config.json, а в Windows — %APPDATA%\Claude\claude_desktop_config.json. Быстрее всего через Settings, Developer, Edit Config: эта команда создаёт файл, если его нет. Claude Desktop доступен для macOS и Windows.

Где находится mcp.json в Cursor?

~/.cursor/mcp.json хранит серверы для всех ваших проектов, а .cursor/mcp.json внутри проекта — серверы этого проекта. Оба используют ключ mcpServers.

Где находится mcp.json в VS Code?

У проекта это .vscode/mcp.json. Ваш собственный лежит в папке вашего пользовательского профиля: выполните MCP: Open User Configuration, чтобы открыть его. VS Code записывает серверы под ключом servers, а не mcpServers.

Какой лимит MCP-инструментов в VS Code?

В запросе чата может быть включено не больше 128 инструментов одновременно, а при превышении VS Code сообщает Cannot have more than 128 tools per request. Снимите выбор с инструментов или серверов в окне выбора инструментов или задайте github.copilot.chat.virtualTools.threshold, чтобы VS Code группировал похожие инструменты.

Есть ли в Cursor лимит MCP-инструментов?

В документации лимит не указан; чаще всего называют 40 инструментов. В январе 2026 года Cursor описал загрузку описаний MCP-инструментов по требованию.

Почему моя конфигурация MCP не работает в другом приложении?

Ключ и поля удалённого сервера различаются. Большинство приложений используют mcpServers; VS Code — servers, Zed — context_servers, Codex — таблицу TOML. Удалённый сервер — это url в Cursor, serverUrl или url в Windsurf, httpUrl или url в Gemini CLI и type плюс url в Claude Code и VS Code.

Может ли Claude Desktop использовать удалённые MCP-серверы из файла конфигурации?

Нет. Удалённые серверы добавляются как пользовательские коннекторы в настройках приложения. Серверы в claude_desktop_config.json — отдельный механизм, и они недоступны в Cowork и на claude.ai.

Где Claude Code хранит MCP-серверы?

Ваши собственные серверы и серверы каждого проекта находятся в ~/.claude.json. Файл .mcp.json в корне проекта предназначен для того, чтобы делиться им с командой. Добавить сервер можно командой claude mcp add или через /mcp в сессии. Оба файла используют ключ mcpServers.

Где находится mcp_config.json в Windsurf?

Документация Windsurf теперь находится в разделе Devin Desktop и указывает ~/.config/devin/mcp_config.json на macOS и Linux и %APPDATA%\devin\mcp_config.json в Windows. В более ранних версиях Windsurf используется ~/.codeium/windsurf/mcp_config.json. Серверы записываются под ключом mcpServers, а Windsurf допускает одновременно 100 инструментов.

Источники

  1. Claude Code, Connect Claude Code to tools via MCP (documentation) Файлы ~/.claude.json и .mcp.json, ключ mcpServers, тип http, Tool Search включён по умолчанию.
  2. Model Context Protocol, Connect to local MCP servers Пути к файлам Claude Desktop, Edit Config, перезапуск, шаги по устранению неполадок и папки с логами.
  3. Claude Help Center, Get started with custom connectors using remote MCP Удалённые серверы — это пользовательские коннекторы, отдельно от claude_desktop_config.json.
  4. Cursor, Model Context Protocol (documentation) Глобальный и проектный файлы mcp.json, mcpServers, url и headers; лимит инструментов не указан.
  5. Cursor, Dynamic context discovery (6 янв. 2026 г.) Описания MCP-инструментов загружаются по требованию.
  6. Cursor forum, About limitation of the number of MCP tools Сообщение пользователя о лимите в 40 инструментов.
  7. VS Code, Add and manage MCP servers in VS Code (documentation) Файлы mcp.json рабочей области и пользователя, ключ servers, переносимый .mcp.json, тип http.
  8. VS Code, Use tools with agents (documentation) Лимит в 128 инструментов и его ошибка, окно выбора инструментов, виртуальные инструменты.
  9. Windsurf, Cascade MCP Configuration (documentation, now on Devin Desktop’s site) Путь к конфигурации, mcpServers, serverUrl или url, лимит в 100 инструментов, disabledTools.
  10. Gemini CLI, MCP servers with Gemini CLI (documentation) Файлы settings.json, mcpServers, httpUrl и url.
  11. OpenAI Codex, Model Context Protocol (documentation) config.toml, таблица mcp_servers, url, enabled_tools и disabled_tools, codex mcp add.
  12. LM Studio, Use MCP Servers (documentation) Edit mcp.json, mcpServers, url и headers.
  13. Cline, MCP (documentation) cline_mcp_settings.json и его папка, вкладка Configure, streamableHttp.
  14. Roo Code, Using MCP in Roo Code (documentation) Глобальный mcp_settings.json и проектный .roo/mcp.json, streamable-http.
  15. AWS, MCP configuration for Q Developer in the IDE default.json и более старый mcp.json, транспорт http, разрешения для инструментов.
  16. Zed, Model Context Protocol (documentation) Пути к settings.json, context_servers, url и headers.
  17. Delta MCP, Supported AI apps (documentation) Двенадцать приложений, которые распознаёт Delta MCP, файлы, которые он читает, и то, как он переключает каждое из них.

Читайте дальше

Попробуйте Delta MCP на своих задачах

Бесплатно, настройка за две минуты, и всё можно вернуть на место одним щелчком.

Бесплатно · Без аккаунта · Чип Apple или Intel

Бесплатно · Без аккаунта

Бесплатно · Без аккаунта

Следить за запуском

Для Mac, Windows и Linux. Аккаунт не нужен.

Скоро

Delta MCP совсем скоро

Бесплатное приложение для Mac, Windows и Linux скоро выйдет. Оставьте почту, и вы узнаете о выходе в ту же минуту. Аккаунт не нужен.

Адрес нужен лишь для одного письма о выходе Delta MCP. Без рассылок. Конфиденциальность