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

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

​

Выбор шаблона

​

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

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

{
  "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 для создания учетных данных во время подключения.

​

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

1. claude mcp list показывает только серверы в managed-mcp.json. Если собственные серверы пользователя все еще отображаются, файл не читается; проверьте путь и разрешения.
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 наряду с управляемым набором

​

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

​

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

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

​

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

1. Объедините списки. Записи списка разрешений и запретов из каждого источника настроек объединяются в один список разрешений и один список запретов. Когда allowManagedMcpServersOnly имеет значение true, сохраняется только управляемый список разрешений; список запретов всегда объединяется из каждого источника.
2. Проверьте список запретов. Сервер, который совпадает с любой записью списка запретов по URL, команде или имени, блокируется. Ничто не переопределяет совпадение списка запретов.
3. Проверьте список разрешений. Если allowedMcpServers не установлен нигде, каждый сервер, который прошел список запретов, загружается. Если он установлен, то, с чем должен совпадать сервер, зависит от его типа, показанного в таблице ниже.

• Команды совпадают точно. Каждый аргумент по порядку. ["npx", "-y", "server"] не совпадает с ["npx", "server"] или ["npx", "-y", "server", "--flag"].
• serverCommand и serverUrl значения расширяются перед сопоставлением. Как запись политики, так и настроенное значение сервера проходят через то же расширение ${VAR} и ${VAR:-default}, что и .mcp.json, поэтому запись, написанная как ["${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, управление местами и сценарий развертывания