Паветта
Как подключить MCP-сервер к Claude Code
Claude Code подключает MCP-серверы командой claude mcp add: локальные через stdio, удалённые по HTTP. Статус каждого сервера видно в claude mcp list и командой /mcp внутри сессии.
Где лежит конфиг
~/.claude.jsonТолько у вас, в текущем проекте (local, по умолчанию).mcp.json в корне проектаДля всей команды через git (project)~/.claude.jsonДля всех ваших проектов (user)Как добавить сервер
1
Локальный сервер
claude mcp add --env KEY=value --transport stdio myserver -- npx server. Всё, что стоит после --, уходит серверу без изменений.
2
Удалённый сервер
claude mcp add --transport http notion https://mcp.notion.com/mcp. Токен передаётся флагом --header "Authorization: Bearer your-token" после адреса.
3
Готовый JSON
claude mcp add-json example '{"command":"npx","args":["-y","@example/mcp-server"]}'. Для удалённого сервера в JSON обязателен "type".
4
Из Claude Desktop
claude mcp add-from-claude-desktop переносит серверы из Claude Desktop. Команда работает на macOS и в WSL.
Как проверить и удалить
Проверкаclaude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Удалениеclaude mcp remove <имя>. Если сервер удалённый и вы хотите отозвать токены OAuth у сервера авторизации, сначала выполните claude mcp logout <имя>.
Порядок флагов--env принимает несколько пар KEY=value подряд. Имя сервера сразу после --env CLI прочитает как ещё одну пару и отклонит, поэтому ставьте между ними --transport stdio.
Область подключенияФлаг --scope со значением local, project или user. При совпадении имён local важнее project, project важнее user.
Переменные в .mcp.json${VAR} подставляет значение переменной, ${VAR:-default} подставляет default, если переменная не задана. Удобно для токенов в headers.
Вход через OAuthВведите /mcp в сессии и пройдите вход в браузере. Из терминала: claude mcp login <имя>, сброс входа: claude mcp logout <имя>.
Тайм-ауты и объём ответаMCP_TIMEOUT=10000 claude даёт серверу 10 секунд на запуск. MAX_MCP_OUTPUT_TOKENS меняет предел ответа инструмента.
Готовые конфиги для Claude Code
Нажмите на сервер, чтобы раскрыть конфиг в формате Claude Code.
Playwright MCPДаёт агенту настоящий браузер
claude mcp add --transport stdio playwright \
-- npx @playwright/mcp@latest
GitHub MCPПодключает агента к GitHub
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
--header 'Authorization: Bearer <GitHub PAT>'
Context7 MCPПодтягивает в контекст агента свежую документацию и примеры кода…
claude mcp add --transport http context7 https://mcp.context7.com/mcp \
--header 'Authorization: Bearer <ключ Context7>'
Figma MCPПодключает агента к макетам Figma
claude mcp add --env 'FIGMA_API_KEY=<ваш токен Figma>' --transport stdio figma \
-- npx -y figma-developer-mcp --stdio
Chrome DevTools MCPДаёт агенту живой Chrome с инструментами DevTools
claude mcp add --transport stdio chrome-devtools \
-- npx -y chrome-devtools-mcp@latest
Filesystem MCPОткрывает агенту доступ к файлам в папках, которые вы перечислили при…
claude mcp add --transport stdio filesystem \
-- npx -y @modelcontextprotocol/server-filesystem /Users/username/Desktop /path/to/other/allowed/dir
Fetch MCPДаёт агенту читать веб-страницы
claude mcp add --transport stdio fetch \
-- uvx mcp-server-fetch
Memory MCPДаёт агенту долгую память между чатами
claude mcp add --env 'MEMORY_FILE_PATH=<полный путь>/memory.jsonl' --transport stdio memory \
-- npx -y @modelcontextprotocol/server-memory
Supabase MCPПодключает агента к проектам Supabase
claude mcp add --transport http supabase https://mcp.supabase.com/mcp
Notion MCPЛокальный сервер Notion поверх Notion API
claude mcp add --env 'NOTION_TOKEN=ntn_<токен интеграции>' --transport stdio notion \
-- npx -y @notionhq/notion-mcp-server
Blender MCPСвязывает агента с запущенным Blender
claude mcp add --transport stdio blender \
-- uvx mcp-for-blender
1С MCPПоказывает агенту метаданные и содержимое базы 1С:Предприятие
claude mcp add --transport http 1c http://<веб-сервер>/<имя публикации>/hs/mcp/ \
--header 'Authorization: Basic <логин и пароль пользователя 1С>'Ограничения
!
Транспорт SSE устарел: если сервер умеет HTTP, подключайте его по HTTP.
!
Ответ инструмента ограничен 25 000 токенов, предупреждение появляется после 10 000.
!
Серверы из .mcp.json проекта запускаются в интерактивной сессии только после вашего подтверждения.
!
Имя сервера в claude mcp — только буквы, цифры, дефис и подчёркивание.
Если не работает
claude mcp add ругается на имя сервера после --env
Поставьте --transport stdio между --env и именем сервера.
Сервер в claude mcp list со статусом ✘ Failed to connect
Claude Code не смог подключиться к самому серверу. Проверьте команду запуска или адрес.
Запись из add-json с url не работает
Запись без type Claude Code считает stdio-сервером. Добавьте "type": "http".
Сервер не успевает запуститься
Увеличьте время запуска переменной MCP_TIMEOUT, например MCP_TIMEOUT=10000 claude.
Частые вопросы
Куда Claude Code записывает сервер после claude mcp add?
По умолчанию в ~/.claude.json, и сервер виден только в текущем проекте. С --scope project он попадёт в .mcp.json в корне проекта, с --scope user станет доступен во всех проектах.
Как подключить сервер, которому нужен ключ API?
Для локального сервера передайте ключ флагом --env KEY=value перед --transport. Для удалённого добавьте --header "Authorization: Bearer ваш-токен" после адреса.
Как поделиться серверами с командой?
Добавьте их с --scope project: Claude Code создаст .mcp.json в корне проекта. Файл кладут в git, а токены оставляют в переменных вида ${API_KEY}.
Можно перенести серверы из Claude Desktop?
Да, командой claude mcp add-from-claude-desktop на macOS или в WSL. Серверы с пробелами и другими символами в имени команда пропустит.
Источники: code.claude.com, code.claude.com