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

Что вы можете делать с MCP

С подключенными серверами MCP вы можете попросить Claude Code:
  • Реализовать функции из трекеров проблем: “Добавьте функцию, описанную в задаче JIRA ENG-4521, и создайте PR на GitHub.”
  • Анализировать данные мониторинга: “Проверьте Sentry и Statsig, чтобы проверить использование функции, описанной в ENG-4521.”
  • Запрашивать базы данных: “Найдите адреса электронной почты 10 случайных пользователей, которые использовали функцию ENG-4521, на основе нашей базы данных Postgres.”
  • Интегрировать дизайны: “Обновите наш стандартный шаблон электронного письма на основе новых дизайнов Figma, которые были опубликованы в Slack”
  • Автоматизировать рабочие процессы: “Создайте черновики Gmail, приглашающие этих 10 пользователей на сеанс обратной связи о новой функции.”

Популярные серверы MCP

Вот некоторые часто используемые серверы MCP, которые вы можете подключить к Claude Code:
Используйте серверы MCP третьих сторон на свой риск - Anthropic не проверил корректность или безопасность всех этих серверов. Убедитесь, что вы доверяете серверам MCP, которые устанавливаете. Будьте особенно осторожны при использовании серверов MCP, которые могут получать ненадежный контент, так как это может подвергнуть вас риску инъекции подсказок.

Development & Testing Tools

Monitor errors, debug production issuesCommand
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
Security analysis for dependenciesCommand
claude mcp add --transport http socket https://mcp.socket.dev/
Provides access to Hugging Face Hub information and Gradio AI ApplicationsCommand
claude mcp add --transport http hugging-face https://huggingface.co/mcp
Debug faster with AI agents that can access Jam recordings like video, console logs, network requests, and errorsCommand
claude mcp add --transport http jam https://mcp.jam.dev/mcp

Project Management & Documentation

Interact with your Asana workspace to keep projects on trackCommand
claude mcp add --transport sse asana https://mcp.asana.com/sse
Manage your Jira tickets and Confluence docsCommand
claude mcp add --transport sse atlassian https://mcp.atlassian.com/v1/sse
Task management, project trackingCommand
claude mcp add --transport stdio clickup --env CLICKUP_API_KEY=YOUR_KEY --env CLICKUP_TEAM_ID=YOUR_ID -- npx -y @hauptsache.net/clickup-mcp
Access real-time customer conversations, tickets, and user dataCommand
claude mcp add --transport http intercom https://mcp.intercom.com/mcp
Integrate with Linear's issue tracking and project managementCommand
claude mcp add --transport http linear https://mcp.linear.app/mcp
Read docs, update pages, manage tasksCommand
claude mcp add --transport http notion https://mcp.notion.com/mcp
Ask questions about your enterprise content, get insights from unstructured data, automate content workflowsCommand
claude mcp add --transport http box https://mcp.box.com/
Extract valuable insights from meeting transcripts and summariesCommand
claude mcp add --transport http fireflies https://api.fireflies.ai/mcp
Manage monday.com boards by creating items, updating columns, assigning owners, setting timelines, adding CRM activities, and writing summariesCommand
claude mcp add --transport http monday https://mcp.monday.com/mcp

Databases & Data Management

Read/write records, manage bases and tablesCommand
claude mcp add --transport stdio airtable --env AIRTABLE_API_KEY=YOUR_KEY -- npx -y airtable-mcp-server
Supplies high quality fundamental financial data sourced from SEC Filings, investor presentationsCommand
claude mcp add --transport http daloopa https://mcp.daloopa.com/server/mcp
Access and manage HubSpot CRM data by fetching contacts, companies, and deals, and creating and updating recordsCommand
claude mcp add --transport http hubspot https://mcp.hubspot.com/anthropic

Payments & Commerce

Integrate PayPal commerce capabilities, payment processing, transaction managementCommand
claude mcp add --transport http paypal https://mcp.paypal.com/mcp
Analyze, troubleshoot, and optimize Plaid integrations. Banking data, financial account linkingCommand
claude mcp add --transport sse plaid https://api.dashboard.plaid.com/mcp/sse
Use an agent to build on Square APIs. Payments, inventory, orders, and moreCommand
claude mcp add --transport sse square https://mcp.squareup.com/sse
Payment processing, subscription management, and financial transactionsCommand
claude mcp add --transport http stripe https://mcp.stripe.com

Design & Media

Generate better code by bringing in full Figma contextVisit developers.figma.com for local server setup.Command
claude mcp add --transport http figma-remote-mcp https://mcp.figma.com/mcp
Upload, manage, transform, and analyze your media assetsMultiple services available. See documentation for specific server URLs.
Build video creation capabilities into your applicationsCommand
claude mcp add --transport sse invideo https://mcp.invideo.io/sse
Browse, summarize, autofill, and even generate new Canva designs directly from ClaudeCommand
claude mcp add --transport http canva https://mcp.canva.com/mcp

Infrastructure & DevOps

Build applications, analyze traffic, monitor performance, and manage security settings through CloudflareMultiple services available. See documentation for specific server URLs. Claude Code can use the Cloudflare CLI if installed.
Create, deploy, and manage websites on Netlify. Control all aspects of your site from creating secrets to enforcing access controls to aggregating form submissionsCommand
claude mcp add --transport http netlify https://netlify-mcp.netlify.app/mcp
Configure and manage Stytch authentication services, redirect URLs, email templates, and workspace settingsCommand
claude mcp add --transport http stytch http://mcp.stytch.dev/mcp
Vercel's official MCP server, allowing you to search and navigate documentation, manage projects and deployments, and analyze deployment logs—all in one placeCommand
claude mcp add --transport http vercel https://mcp.vercel.com/

Automation & Integration

Access any application, workflows or data via Workato, made accessible for AIMCP servers are programmatically generated
Connect to nearly 8,000 apps through Zapier's automation platformGenerate a user-specific URL at mcp.zapier.com
Нужна конкретная интеграция? Найдите сотни других серверов MCP на GitHub, или создайте свой собственный, используя MCP SDK.

Установка серверов MCP

Серверы MCP можно настроить тремя различными способами в зависимости от ваших потребностей:

Вариант 1: Добавьте удаленный HTTP-сервер

HTTP-серверы - это рекомендуемый вариант для подключения к удаленным серверам MCP. Это наиболее широко поддерживаемый транспорт для облачных сервисов.
# Базовый синтаксис
claude mcp add --transport http <name> <url>

# Реальный пример: подключение к Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Пример с токеном Bearer
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

Вариант 2: Добавьте удаленный SSE-сервер

Транспорт SSE (Server-Sent Events) устарел. Используйте вместо этого HTTP-серверы, где они доступны.
# Базовый синтаксис
claude mcp add --transport sse <name> <url>

# Реальный пример: подключение к Asana
claude mcp add --transport sse asana https://mcp.asana.com/sse

# Пример с заголовком аутентификации
claude mcp add --transport sse private-api https://api.company.com/sse \
  --header "X-API-Key: your-key-here"

Вариант 3: Добавьте локальный сервер stdio

Серверы Stdio работают как локальные процессы на вашем компьютере. Они идеальны для инструментов, которым нужен прямой доступ к системе или пользовательские скрипты.
# Базовый синтаксис
claude mcp add --transport stdio <name> <command> [args...]

# Реальный пример: добавление сервера Airtable
claude mcp add --transport stdio airtable --env AIRTABLE_API_KEY=YOUR_KEY \
  -- npx -y airtable-mcp-server
Понимание параметра ”—”: -- (двойной дефис) отделяет собственные флаги CLI Claude от команды и аргументов, которые передаются серверу MCP. Все, что находится перед --, - это параметры для Claude (например, --env, --scope), а все, что находится после --, - это фактическая команда для запуска сервера MCP.Например:
  • claude mcp add --transport stdio myserver -- npx server → запускает npx server
  • claude mcp add --transport stdio myserver --env KEY=value -- python server.py --port 8080 → запускает python server.py --port 8080 с KEY=value в окружении
Это предотвращает конфликты между флагами Claude и флагами сервера.

Управление вашими серверами

После настройки вы можете управлять своими серверами MCP с помощью этих команд:
# Список всех настроенных серверов
claude mcp list

# Получить детали для конкретного сервера
claude mcp get github

# Удалить сервер
claude mcp remove github

# (в Claude Code) Проверить статус сервера
/mcp
Советы:
  • Используйте флаг --scope для указания места хранения конфигурации:
    • local (по умолчанию): Доступно только вам в текущем проекте (в старых версиях называлось project)
    • project: Общий доступ для всех в проекте через файл .mcp.json
    • user: Доступно вам во всех проектах (в старых версиях называлось global)
  • Установите переменные окружения с флагами --env (например, --env KEY=value)
  • Настройте время ожидания запуска сервера MCP, используя переменную окружения MCP_TIMEOUT (например, MCP_TIMEOUT=10000 claude устанавливает тайм-аут 10 секунд)
  • Claude Code отобразит предупреждение, когда выходные данные инструмента MCP превышают 10 000 токенов. Чтобы увеличить это ограничение, установите переменную окружения MAX_MCP_OUTPUT_TOKENS (например, MAX_MCP_OUTPUT_TOKENS=50000)
  • Используйте /mcp для аутентификации с удаленными серверами, требующими аутентификации OAuth 2.0
Пользователи Windows: На нативной Windows (не WSL) локальные серверы MCP, которые используют npx, требуют обертки cmd /c для обеспечения правильного выполнения.
# Это создает command="cmd", который Windows может выполнить
claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package
Без обертки cmd /c вы столкнетесь с ошибками “Connection closed”, потому что Windows не может напрямую выполнить npx. (См. примечание выше для объяснения параметра --.)

Серверы MCP, предоставляемые плагинами

Плагины могут включать серверы MCP, автоматически предоставляя инструменты и интеграции при включении плагина. Серверы MCP плагинов работают идентично пользовательским настроенным серверам. Как работают серверы MCP плагинов:
  • Плагины определяют серверы MCP в .mcp.json в корне плагина или встроенные в plugin.json
  • Когда плагин включен, его серверы MCP запускаются автоматически
  • Инструменты MCP плагина отображаются рядом с вручную настроенными инструментами MCP
  • Серверы плагинов управляются через установку плагина (не через команды /mcp)
Пример конфигурации MCP плагина: В .mcp.json в корне плагина:
{
  "database-tools": {
    "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
    "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
    "env": {
      "DB_URL": "${DB_URL}"
    }
  }
}
Или встроенные в plugin.json:
{
  "name": "my-plugin",
  "mcpServers": {
    "plugin-api": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/api-server",
      "args": ["--port", "8080"]
    }
  }
}
Функции MCP плагинов:
  • Автоматический жизненный цикл: Серверы запускаются при включении плагина, но вы должны перезагрузить Claude Code, чтобы применить изменения сервера MCP (включение или отключение)
  • Переменные окружения: Используйте ${CLAUDE_PLUGIN_ROOT} для путей относительно плагина
  • Доступ к окружению пользователя: Доступ к тем же переменным окружения, что и вручную настроенные серверы
  • Несколько типов транспорта: Поддержка транспортов stdio, SSE и HTTP (поддержка транспорта может варьироваться в зависимости от сервера)
Просмотр серверов MCP плагинов:
# В Claude Code см. все серверы MCP, включая серверы плагинов
/mcp
Серверы плагинов отображаются в списке с индикаторами, показывающими, что они поступают из плагинов. Преимущества серверов MCP плагинов:
  • Упакованное распределение: Инструменты и серверы упакованы вместе
  • Автоматическая настройка: Не требуется ручная конфигурация MCP
  • Согласованность команды: Все получают одинаковые инструменты при установке плагина
См. справочник компонентов плагина для получения подробной информации о включении серверов MCP в плагины.

Области установки MCP

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

Локальная область

Серверы с локальной областью представляют уровень конфигурации по умолчанию и хранятся в параметрах пользователя, специфичных для проекта. Эти серверы остаются приватными для вас и доступны только при работе в текущем каталоге проекта. Эта область идеальна для личных серверов разработки, экспериментальных конфигураций или серверов, содержащих конфиденциальные учетные данные, которые не должны быть общими.
# Добавить сервер с локальной областью (по умолчанию)
claude mcp add --transport http stripe https://mcp.stripe.com

# Явно указать локальную область
claude mcp add --transport http stripe --scope local https://mcp.stripe.com

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

Серверы с областью проекта обеспечивают командное сотрудничество, сохраняя конфигурации в файле .mcp.json в корневом каталоге вашего проекта. Этот файл предназначен для проверки в системе контроля версий, обеспечивая всем членам команды доступ к одним и тем же инструментам и сервисам MCP. Когда вы добавляете сервер с областью проекта, Claude Code автоматически создает или обновляет этот файл с соответствующей структурой конфигурации.
# Добавить сервер с областью проекта
claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp
Полученный файл .mcp.json следует стандартизированному формату:
{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}
По соображениям безопасности Claude Code запрашивает одобрение перед использованием серверов с областью проекта из файлов .mcp.json. Если вам нужно сбросить эти выборы одобрения, используйте команду claude mcp reset-project-choices.

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

Серверы с областью пользователя обеспечивают доступность между проектами, делая их доступными во всех проектах на вашем компьютере, оставаясь приватными для вашей учетной записи пользователя. Эта область хорошо подходит для личных служебных серверов, инструментов разработки или сервисов, которые вы часто используете в разных проектах.
# Добавить сервер пользователя
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

Выбор правильной области

Выберите вашу область на основе:
  • Локальная область: Личные серверы, экспериментальные конфигурации или конфиденциальные учетные данные, специфичные для одного проекта
  • Область проекта: Серверы, общие для команды, инструменты, специфичные для проекта, или сервисы, необходимые для сотрудничества
  • Область пользователя: Личные утилиты, необходимые в нескольких проектах, инструменты разработки или часто используемые сервисы

Иерархия областей и приоритет

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

Расширение переменных окружения в .mcp.json

Claude Code поддерживает расширение переменных окружения в файлах .mcp.json, позволяя командам делиться конфигурациями, сохраняя гибкость для путей, специфичных для машины, и конфиденциальных значений, таких как ключи API. Поддерживаемый синтаксис:
  • ${VAR} - Расширяется до значения переменной окружения VAR
  • ${VAR:-default} - Расширяется до VAR, если установлена, иначе использует default
Места расширения: Переменные окружения можно расширить в:
  • command - Путь к исполняемому файлу сервера
  • args - Аргументы командной строки
  • env - Переменные окружения, передаваемые серверу
  • url - Для типов HTTP-сервера
  • headers - Для аутентификации HTTP-сервера
Пример с расширением переменной:
{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}
Если требуемая переменная окружения не установлена и не имеет значения по умолчанию, Claude Code не сможет разобрать конфигурацию.

Практические примеры

Пример: Мониторинг ошибок с помощью Sentry

# 1. Добавьте сервер MCP Sentry
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# 2. Используйте /mcp для аутентификации с вашей учетной записью Sentry
> /mcp

# 3. Отладка проблем в производстве
> "What are the most common errors in the last 24 hours?"
> "Show me the stack trace for error ID abc123"
> "Which deployment introduced these new errors?"

Пример: Подключение к GitHub для проверки кода

# 1. Добавьте сервер MCP GitHub
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# 2. В Claude Code аутентифицируйтесь, если необходимо
> /mcp
# Выберите "Authenticate" для GitHub

# 3. Теперь вы можете попросить Claude работать с GitHub
> "Review PR #456 and suggest improvements"
> "Create a new issue for the bug we just found"
> "Show me all open PRs assigned to me"

Пример: Запрос к базе данных PostgreSQL

# 1. Добавьте сервер базы данных со строкой подключения
claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:[email protected]:5432/analytics"

# 2. Запрашивайте вашу базу данных естественным образом
> "What's our total revenue this month?"
> "Show me the schema for the orders table"
> "Find customers who haven't made a purchase in 90 days"

Аутентификация с удаленными серверами MCP

Многие облачные серверы MCP требуют аутентификации. Claude Code поддерживает OAuth 2.0 для безопасных соединений.
1

Добавьте сервер, требующий аутентификации

Например:
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
2

Используйте команду /mcp в Claude Code

В Claude Code используйте команду:
> /mcp
Затем следуйте инструкциям в браузере для входа.
Советы:
  • Токены аутентификации хранятся безопасно и автоматически обновляются
  • Используйте “Clear authentication” в меню /mcp для отзыва доступа
  • Если ваш браузер не открывается автоматически, скопируйте предоставленный URL
  • Аутентификация OAuth работает с HTTP-серверами

Добавление серверов MCP из конфигурации JSON

Если у вас есть конфигурация JSON для сервера MCP, вы можете добавить ее напрямую:
1

Добавьте сервер MCP из JSON

# Базовый синтаксис
claude mcp add-json <name> '<json>'

# Пример: добавление HTTP-сервера с конфигурацией JSON
claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'

# Пример: добавление сервера stdio с конфигурацией JSON
claude mcp add-json local-weather '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'
2

Проверьте, что сервер был добавлен

claude mcp get weather-api
Советы:
  • Убедитесь, что JSON правильно экранирован в вашей оболочке
  • JSON должен соответствовать схеме конфигурации сервера MCP
  • Вы можете использовать --scope user для добавления сервера в конфигурацию пользователя вместо конфигурации, специфичной для проекта

Импорт серверов MCP из Claude Desktop

Если вы уже настроили серверы MCP в Claude Desktop, вы можете их импортировать:
1

Импортируйте серверы из Claude Desktop

# Базовый синтаксис 
claude mcp add-from-claude-desktop 
2

Выберите, какие серверы импортировать

После запуска команды вы увидите интерактивный диалог, который позволит вам выбрать, какие серверы вы хотите импортировать.
3

Проверьте, что серверы были импортированы

claude mcp list 
Советы:
  • Эта функция работает только на macOS и Windows Subsystem for Linux (WSL)
  • Она читает файл конфигурации Claude Desktop из его стандартного местоположения на этих платформах
  • Используйте флаг --scope user для добавления серверов в конфигурацию пользователя
  • Импортированные серверы будут иметь те же имена, что и в Claude Desktop
  • Если серверы с одинаковыми именами уже существуют, они получат числовой суффикс (например, server_1)

Используйте Claude Code как сервер MCP

Вы можете использовать сам Claude Code как сервер MCP, к которому могут подключаться другие приложения:
# Запустите Claude как сервер MCP stdio
claude mcp serve
Вы можете использовать это в Claude Desktop, добавив эту конфигурацию в claude_desktop_config.json:
{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}
Советы:
  • Сервер предоставляет доступ к инструментам Claude, таким как View, Edit, LS и т. д.
  • В Claude Desktop попробуйте попросить Claude прочитать файлы в каталоге, внести изменения и многое другое.
  • Обратите внимание, что этот сервер MCP просто предоставляет инструменты Claude Code вашему клиенту MCP, поэтому ваш собственный клиент отвечает за реализацию подтверждения пользователем для отдельных вызовов инструментов.

Ограничения выходных данных MCP и предупреждения

Когда инструменты MCP производят большие выходные данные, Claude Code помогает управлять использованием токенов, чтобы предотвратить перегрузку контекста вашего разговора:
  • Порог предупреждения выходных данных: Claude Code отображает предупреждение, когда выходные данные любого инструмента MCP превышают 10 000 токенов
  • Настраиваемое ограничение: Вы можете отрегулировать максимальное количество разрешенных токенов выходных данных MCP, используя переменную окружения MAX_MCP_OUTPUT_TOKENS
  • Ограничение по умолчанию: Максимум по умолчанию составляет 25 000 токенов
Чтобы увеличить ограничение для инструментов, которые производят большие выходные данные:
# Установите более высокое ограничение для выходных данных инструмента MCP
export MAX_MCP_OUTPUT_TOKENS=50000
claude
Это особенно полезно при работе с серверами MCP, которые:
  • Запрашивают большие наборы данных или базы данных
  • Генерируют подробные отчеты или документацию
  • Обрабатывают обширные файлы журналов или информацию отладки
Если вы часто встречаете предупреждения о выходных данных с конкретными серверами MCP, рассмотрите возможность увеличения ограничения или настройки сервера для разбиения на страницы или фильтрации его ответов.

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

Серверы MCP могут предоставлять ресурсы, на которые вы можете ссылаться, используя упоминания @, аналогично тому, как вы ссылаетесь на файлы.

Ссылка на ресурсы MCP

1

Список доступных ресурсов

Введите @ в вашу подсказку, чтобы увидеть доступные ресурсы от всех подключенных серверов MCP. Ресурсы отображаются рядом с файлами в меню автодополнения.
2

Ссылка на конкретный ресурс

Используйте формат @server:protocol://resource/path для ссылки на ресурс:
> Can you analyze @github:issue://123 and suggest a fix?
> Please review the API documentation at @docs:file://api/authentication
3

Несколько ссылок на ресурсы

Вы можете ссылаться на несколько ресурсов в одной подсказке:
> Compare @postgres:schema://users with @docs:file://database/user-model
Советы:
  • Ресурсы автоматически получаются и включаются как вложения при ссылке на них
  • Пути ресурсов поддерживают нечеткий поиск в автодополнении упоминания @
  • Claude Code автоматически предоставляет инструменты для перечисления и чтения ресурсов MCP, когда серверы их поддерживают
  • Ресурсы могут содержать любой тип контента, который предоставляет сервер MCP (текст, JSON, структурированные данные и т. д.)

Использование подсказок MCP как команд слэша

Серверы MCP могут предоставлять подсказки, которые становятся доступными как команды слэша в Claude Code.

Выполнение подсказок MCP

1

Откройте доступные подсказки

Введите / для просмотра всех доступных команд, включая команды с серверов MCP. Подсказки MCP отображаются в формате /mcp__servername__promptname.
2

Выполните подсказку без аргументов

> /mcp__github__list_prs
3

Выполните подсказку с аргументами

Многие подсказки принимают аргументы. Передавайте их через пробел после команды:
> /mcp__github__pr_review 456
> /mcp__jira__create_issue "Bug in login flow" high
Советы:
  • Подсказки MCP динамически обнаруживаются из подключенных серверов
  • Аргументы анализируются на основе определенных параметров подсказки
  • Результаты подсказки вводятся непосредственно в разговор
  • Имена серверов и подсказок нормализуются (пробелы становятся подчеркиваниями)

Конфигурация MCP для предприятия

Для организаций, которым требуется централизованный контроль над серверами MCP, Claude Code поддерживает управляемые предприятием конфигурации MCP. Это позволяет администраторам IT:
  • Контролировать, к каким серверам MCP могут получить доступ сотрудники: Развертывание стандартизированного набора одобренных серверов MCP по всей организации
  • Предотвращать несанкционированные серверы MCP: Опционально ограничить пользователей от добавления собственных серверов MCP
  • Отключить MCP полностью: Полностью удалить функциональность MCP, если необходимо

Настройка конфигурации MCP для предприятия

Системные администраторы могут развернуть файл конфигурации MCP для предприятия рядом с файлом управляемых параметров:
  • macOS: /Library/Application Support/ClaudeCode/managed-mcp.json
  • Windows: C:\ProgramData\ClaudeCode\managed-mcp.json
  • Linux: /etc/claude-code/managed-mcp.json
Файл managed-mcp.json использует тот же формат, что и стандартный файл .mcp.json:
{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "sentry": {
      "type": "http",
      "url": "https://mcp.sentry.dev/mcp"
    },
    "company-internal": {
      "type": "stdio",
      "command": "/usr/local/bin/company-mcp-server",
      "args": ["--config", "/etc/company/mcp-config.json"],
      "env": {
        "COMPANY_API_URL": "https://internal.company.com"
      }
    }
  }
}

Ограничение серверов MCP с помощью списков разрешений и запретов

В дополнение к предоставлению управляемых предприятием серверов администраторы могут контролировать, какие серверы MCP пользователи могут настраивать, используя allowedMcpServers и deniedMcpServers в файле managed-settings.json:
  • macOS: /Library/Application Support/ClaudeCode/managed-settings.json
  • Windows: C:\ProgramData\ClaudeCode\managed-settings.json
  • Linux: /etc/claude-code/managed-settings.json
{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverName": "sentry" },
    { "serverName": "company-internal" }
  ],
  "deniedMcpServers": [
    { "serverName": "filesystem" }
  ]
}
Поведение списка разрешений (allowedMcpServers):
  • undefined (по умолчанию): Нет ограничений - пользователи могут настраивать любой сервер MCP
  • Пустой массив []: Полная блокировка - пользователи не могут настраивать никакие серверы MCP
  • Список имен серверов: Пользователи могут настраивать только указанные серверы
Поведение списка запретов (deniedMcpServers):
  • undefined (по умолчанию): Никакие серверы не блокируются
  • Пустой массив []: Никакие серверы не блокируются
  • Список имен серверов: Указанные серверы явно блокируются во всех областях
Важные примечания:
  • Эти ограничения применяются ко всем областям: пользователь, проект, локальный и даже серверы предприятия из managed-mcp.json
  • Список запретов имеет абсолютный приоритет: Если сервер появляется в обоих списках, он будет заблокирован
Приоритет конфигурации предприятия: Конфигурация MCP предприятия имеет наивысший приоритет и не может быть переопределена конфигурациями пользователя, локальными или проектными, когда включен useEnterpriseMcpConfigOnly.