Контролируйте доступ к серверам MCP для вашей организации

• Выбрать шаблон, который соответствует необходимому вам уровню контроля
• Развернуть фиксированный набор серверов с помощью managed-mcp.json, включая то, как полностью отключить MCP
• Предоставить серверы через управляемые параметры, пока пользователи сохраняют свои собственные
• Контролировать серверы с помощью списков разрешений и списков запретов
• Сообщить пользователям, чего ожидать, когда ограничение блокирует сервер
• Отслеживать, какие серверы фактически использует ваша организация

​

Выберите шаблон

​

Исключительный контроль с помощью managed-mcp.json

• Серверы, которые определяет файл
• Серверы, которые вы предоставляете через managedMcpServers
• Встроенные серверы, которые регистрирует приложение, запустившее сеанс, такие как собственный сервер расширения VS Code или коннекторы, которые поставляет настольное приложение
• Встроенный сервер Claude in Chrome, если вы разрешите его наряду с управляемым набором

​

Развёртывание managed-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.example.com"
      }
    }
  }
}

​

Аутентификация с помощью учётных данных для каждого пользователя

• Расширение ${VAR} для чтения секретов из окружения каждого пользователя.
• OAuth или заголовки для каждого пользователя, чтобы каждый пользователь аутентифицировался как сам себя.
• headersHelper для создания учётных данных во время подключения.

​

Серверы, переданные с помощью --mcp-config или --strict-mcp-config

• На рабочей станции Claude Code завершает работу при запуске с сообщением You cannot dynamically configure MCP servers when an enterprise MCP config is present.
• В облачных сеансах на хосте, где развёрнут файл, например на самостоятельно размещённом runner, Claude Code запускается только с управляемыми серверами и пропускает коннекторы claude.ai и другие серверы, которые облачный хост доставляет через --mcp-config. Ничто в сеансе не сообщает пользователю, какие серверы были исключены. Claude Code называет их в предупреждении на своём stderr, которое самостоятельно размещённый runner записывает на уровне логирования debug.

​

Как списки разрешений и запретов применяются к управляемому набору

• deniedMcpServers применяется и к управляемым серверам, поэтому управляемый сервер, соответствующий записи, не будет загружен.
• Собственный deniedMcpServers пользователя объединяется из его параметров, поэтому пользователи могут заблокировать управляемый сервер для себя.

​

Проверка конфигурации

1. claude mcp list показывает только серверы в managed-mcp.json, плюс любые, которые вы предоставляете через managedMcpServers. Два других результата означают, что что-то не так:
   • Если собственные серверы пользователя по-прежнему отображаются, Claude Code не читает файл, поэтому проверьте его путь и разрешения на его родительских каталогах.
   • Если серверы файла не отображаются и раздел MCP config diagnostics отмечает конфигурацию предприятия как не удалось разобрать, Claude Code не может прочитать или разобрать файл. Исправьте ошибку, которую называет этот раздел, затем попросите пользователя перезагрузить Claude Code.
2. claude mcp add --transport http test https://example.com/mcp завершается с ошибкой Cannot add MCP server: enterprise MCP configuration is active and has exclusive control over MCP servers. URL не обязательно должен указывать на реальный сервер, так как проверка политики отклоняет команду перед тем, как что-либо будет контактировано.

​

Отключение MCP полностью

{
  "mcpServers": {}
}

​

Разрешение коннекторов claude.ai наряду с управляемым набором

​

Разрешение Claude in Chrome наряду с управляемым набором

​

Предоставление серверов через управляемые параметры

{
  "managedMcpServers": {
    "search": {
      "type": "http",
      "url": "https://search.example.com/mcp"
    },
    "records": {
      "type": "http",
      "url": "https://records.example.com/mcp",
      "headers": {
        "X-Records-Key": "key-issued-for-all-claude-code-users"
      }
    }
  }
}

​

Что может содержать запись

• type — это http или sse. Как в .mcp.json, streamable-http принимается как псевдоним для http.
• url — это URL https://. Claude Code отказывает в обычном URL http://, включая тот, который указывает на localhost.
• Запись не содержит членов command, args, env или headersHelper, поэтому документ управляемых параметров никогда не называет программу для запуска на машине пользователя.
• Ни одно значение не содержит ссылку ${VAR}. Claude Code не расширяет переменные окружения в этих записях, поэтому пишите буквальные значения.
• Имя сервера содержит только буквы, цифры, дефисы и подчёркивания, и ни один ключ или значение не содержит управляющих или невидимых символов форматирования.

​

Как загружаются предоставленные серверы

• Предоставленный сервер имеет приоритет над сервером с тем же именем в локальной, проектной или пользовательской области, а также над сервером плагина или коннектором claude.ai, который указывает на тот же URL.
• Если вы также развёртываете managed-mcp.json, Claude Code загружает его серверы и предоставленные серверы вместе, и запись файла имеет приоритет, когда оба определяют имя.
• Предоставленные серверы продолжают загружаться, когда strictPluginOnlyCustomization блокирует поверхность mcp.
• deniedMcpServers применяется к предоставленным серверам, включая записи из собственных параметров пользователя, поэтому пользователь может заблокировать один для себя. Предоставленные серверы не требуют записи allowedMcpServers.

• Сервер, который пользователь передаёт с --mcp-config под тем же именем, заменяет предоставленный на этот запуск и проверяется против allowedMcpServers.
• --strict-mcp-config исключает предоставленные серверы вместе со всеми остальными настроенными серверами.

​

Что пользователи могут видеть и изменять

• claude mcp remove сообщает, что сервер предоставлен организацией.
• Когда вы также не развёртываете managed-mcp.json, запись, которую пользователь добавляет под тем же именем, сохраняется, но не используется, пока присутствует ваша.
• Пользователи всё ещё могут отключить предоставленный сервер для себя в /mcp, который перечисляет предоставленные серверы в разделе Managed MCPs.

​

Где применяется managedMcpServers

​

Когда подключаются предоставленные серверы

• На машине с кэшированными параметрами Claude Code удерживает кэшированную копию этого ключа до тех пор, пока сервер не подтвердит параметры для сеанса, и ждёт этого подтверждения перед загрузкой MCP серверов. Если подтверждение не удаётся, сеанс продолжается без предоставленных серверов и /status говорит, что они удерживаются.
• При первом запуске машины, когда ещё ничего не кэшировано, интерактивный сеанс, который начинается до прибытия параметров, подключает предоставленные серверы, как только они прибывают, и запуск claude -p, который уже начался, может завершиться без них.

• Добавить сервер: Claude Code подключает его, когда прибывают обновлённые параметры, без перезагрузки.
• Изменить запись сервера: эти сеансы переподключаются к нему с новым определением.
• Удалить сервер: запущенный интерактивный сеанс отключает его, как только он прочитает изменённые параметры. Неинтерактивный запуск (-p) сохраняет его до конца.

​

Контроль на основе политик с использованием списков разрешений и запретов

​

Сопоставление серверов по URL, команде или имени

• В deniedMcpServers serverName принимает любую непустую строку без начальных или конечных пробелов, поэтому вы можете блокировать соединители claude.ai по их отображаемому имени. Например, { "serverName": "claude.ai Slack" } блокирует соединитель Slack. Предпочитайте запись serverUrl, когда вам нужно, чтобы запрет был устойчив к переименованиям, или когда имя соединителя конфликтует и получает суффикс (N).
• В allowedMcpServers serverName ограничен буквами, цифрами, дефисами и подчеркиваниями. Используйте serverUrl для добавления в список разрешений соединителя claude.ai, который Claude Code загружает сам; для соединителей, которые облачный хост доставляет в самостоятельно размещаемые сеансы, используйте вместо этого записи, указанные в разделе Трафик соединителя покидает вашу сеть.

​

Как оценивается сервер

1. Объедините списки. Записи списка разрешений и запретов из каждой области параметров объединяются в один список разрешений и один список запретов. Когда allowManagedMcpServersOnly имеет значение true, сохраняется только управляемый список разрешений; список запретов всегда объединяется из каждой области. Когда присутствует более одного управляемого источника, раздел Ключи, читаемые из каждого источника администратора указывает, какие из них предоставляют списки управляемой области.
2. Проверьте список запретов. Сервер, который совпадает с любой записью списка запретов по URL, команде или имени, блокируется. Ничто не переопределяет совпадение списка запретов.
3. Проверьте список разрешений. Если allowedMcpServers не установлен нигде, каждый сервер, прошедший список запретов, загружается. Если он установлен, то, с чем должен совпадать сервер, зависит от его типа, показанного в таблице ниже. Три группы серверов пропускают эту проверку:
   • Собственные серверы организации: каждая запись managedMcpServers и любая запись managed-mcp.json, значения которой не используют расширение ${VAR}.
   • Встроенные серверы, такие как Claude в Chrome, сервер ide, к которому Claude Code подключается в работающей IDE VS Code или JetBrains, и серверы, которые сам CLI настраивает.
   • Инструменты Slack сеанса Claude Tag: серверы, которые он использует для чтения потока и публикации своих ответов, загружаются без записи в список разрешений.
   Сервер managed-mcp.json, который использует расширение ${VAR} в своей команде, аргументах, env, URL или заголовках, все еще проверяется. Так же как и каждый сервер, добавленный пользователем, плагином, claude.ai, и каждый сервер, переданный пользователем с --mcp-config.

• Команды совпадают точно. Каждый аргумент по порядку. ["npx", "-y", "server"] не совпадает с ["npx", "server"] или ["npx", "-y", "server", "--flag"].
• Значения serverCommand и serverUrl расширяются перед сопоставлением. Как запись политики, так и настроенное значение сервера проходят через расширение ${VAR} и ${VAR:-default}, поэтому запись, написанная как ["${HOME}/bin/server"], совпадает с конфигурацией сервера, которая использует либо ту же ссылку, либо расширенный путь. В Windows ссылайтесь на переменную окружения, установленную там, такую как ${USERPROFILE} вместо ${HOME}. Значения serverName совпадают буквально и никогда не расширяются. Две стороны читают разные окружения; раздел Как расширяются записи политики охватывает, какие и как записи списка разрешений и запретов отличаются.
• URL поддерживают подстановочные знаки * в любом месте шаблона, включая схему. Сопоставление имени хоста не учитывает регистр и игнорирует конечную точку FQDN, поэтому https://Mcp.Example.com/* совпадает с https://mcp.example.com/api. Пути остаются чувствительными к регистру.

​

Как расширяются записи политики

​

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

{
  "allowedMcpServers": [
    { "serverUrl": "https://api.githubcopilot.com/*" },
    { "serverUrl": "https://mcp.sentry.dev/*" },
    { "serverCommand": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "."] },
    { "serverCommand": ["python", "/usr/local/bin/approved-server.py"] },
    { "serverUrl": "https://mcp.example.com/*" },
    { "serverUrl": "https://*.internal.example.com/*" }
  ],
  "deniedMcpServers": [
    { "serverName": "dangerous-server" },
    { "serverCommand": ["npx", "-y", "unapproved-package"] },
    { "serverUrl": "https://*.untrusted.example.com/*" }
  ]
}

• Строка 3: первая запись serverUrl. Как только она существует, каждый удаленный сервер должен совпадать с шаблоном URL, поэтому пользователь не может получить неуказанный удаленный сервер, дав ему разрешенное имя.
• Строка 5: первая запись serverCommand. Тот же эффект для серверов stdio, поэтому каждый локальный сервер должен совпадать с указанной командой точно.
• Строка 11: запись serverName в списке запретов. Записи списка запретов всегда применяются, поэтому любой сервер с именем dangerous-server блокируется независимо от его URL или команды.

{
  "allowedMcpServers": [
    { "serverUrl": "https://mcp.example.com/*" },
    { "serverUrl": "https://*.internal.example.com/*" }
  ]
}

{
  "allowedMcpServers": [
    { "serverCommand": ["npx", "-y", "approved-package"] }
  ]
}

{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverCommand": ["npx", "-y", "approved-package"] }
  ]
}

{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverName": "internal-tool" }
  ]
}

{
  "allowedMcpServers": [
    { "serverUrl": "https://*.example.com/*" }
  ],
  "deniedMcpServers": [
    { "serverUrl": "https://staging.example.com/*" }
  ]
}

​

Ограничить список разрешений только управляемыми параметрами

{
  "allowManagedMcpServersOnly": true,
  "allowedMcpServers": [
    { "serverUrl": "https://api.githubcopilot.com/*" },
    { "serverUrl": "https://*.internal.example.com/*" }
  ]
}

​

Как ограничения отображаются пользователям

​

Мониторинг использования MCP

​

Сводка конфигурации

​

Связанные ресурсы

• Decide what to enforce: ограничения MCP наряду с правилами разрешений, песочницей и другими элементами управления администратора
• Connect Claude Code to tools via MCP: полная справка MCP, включая транспорты, области и аутентификацию
• Settings: иерархия настроек и способ приоритета управляемых настроек
• Server-managed settings: доставка allowedMcpServers и deniedMcpServers из консоли администратора Claude.ai
• Security: модель угроз, которую защищают эти элементы управления
• Claude Enterprise Administrator Guide: SSO, SCIM, управление местами и сценарий развертывания