Справочник соединителей Anthropic - часто задаваемые вопросы

MCP расшифровывается как Model Context Protocol — открытый стандарт, созданный Anthropic, который позволяет приложениям на основе ИИ подключаться к инструментам и источникам данных. Для получения подробной информации о MCP и начала работы обратитесь к нашему руководству по удаленному MCP: Начало работы с пользовательскими соединителями с использованием удаленного MCP.

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

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

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

Хотя мы стараемся рассмотреть каждую отправку как можно быстрее, из-за огромного интереса мы не можем гарантировать, что примем вашу отправку или ответим на нее индивидуально.

OAuth 2.0 требуется только если для сервера MCP требуется аутентификация. Серверы, которые не требуют аутентификации, не требуют OAuth.

Нет. Чистый поток учетных данных клиента (машина-машина OAuth с только client_id/client_secret и без взаимодействия пользователя) не поддерживается. Мы можем предоставить статический client_id/client_secret для Claude, но пользователи все равно должны пройти поток согласия OAuth для аутентификации своих отдельных учетных записей. Это работает на claude.ai и Claude Desktop, но не на Claude Code, потому что Claude Code устанавливает соединения непосредственно с вашего компьютера на ваш сервер MCP (и, таким образом, не имеет доступа к статическим учетным данным).

Нет. OAuth — единственный способ уникально идентифицировать пользователей. Мы не передаем IP-адреса, идентификаторы пользователей или другие метаданные конечных пользователей на серверы MCP.

Это зависит от поверхности продукта. Связь происходит через серверы Anthropic (claude.ai, Claude Desktop), ваш браузер или ваши локальные клиенты (Claude Code). В настоящее время нет централизованного метода подключения для всех поверхностей.

Для удаленных серверов MCP (соединители, добавленные через Настройка > Соединители), вся связь исходит из облачной инфраструктуры Anthropic. Это верно независимо от того, какую поверхность клиента использует человек — claude.ai, Claude Desktop, Cowork или мобильные приложения Claude. Ваш сервер MCP должен быть доступен через общедоступный интернет из диапазонов IP Anthropic.

Локальные серверы MCP, настроенные через claude_desktop_config.json в Claude Desktop или через Claude Code, взаимодействуют непосредственно с вашей машины, используя локальную сеть.

Да. Пользователи аутентифицируются на серверах MCP на основе каждого сервера. Они могут использовать личные учетные данные аутентификации для серверов MCP даже при входе в claude.ai с корпоративной учетной записью.

Нет. OAuth происходит при подключении клиента к серверу MCP, а не на уровне инструмента. Вы можете применять разрешения на уровне инструмента на основе аутентификации пользователя после установления соединения с сервером.

Токены удаляются из систем Anthropic, но не из ваших систем. Токены доступа и обновления у вашего поставщика удостоверений остаются действительными до истечения срока действия, а файлы cookie сеанса не очищаются (так как они находятся на уровне браузера, вне контроля Claude).

Верните ответ 401 Unauthorized. Чтобы запустить полную регенерацию учетных данных клиента DCR, верните ошибку invalid_client в соответствии с RFC 6749 раздел 5.2.

Нет. Учетные данные клиента не требуются для стандартных потоков OAuth с аутентификацией пользователя.

Ограничение скорости для каждого пользователя требует OAuth. Без OAuth ваши варианты:

Мы настоятельно рекомендуем использовать OAuth и не использовать разрешение IP-адресов. Однако это возможно, используя статические IP-адреса, доступные по адресу https://docs.claude.com/en/api/ip-addresses.

Важные ограничения:

Нет. Владельцы серверов MCP должны реализовать свои собственные меры ограничения скорости и предотвращения злоупотреблений.

25 000 токенов. Используйте разбиение на страницы, фильтрацию или параметры ограничения для уменьшения размера ответа при необходимости.

Тайм-ауты различаются в зависимости от компонента:

Все пользователи могут получить доступ к коннекторам, за исключением пользовательских коннекторов, которые доступны только для платных планов (Pro, Max, Team и Enterprise).

Нет. Любая организация может отправить материалы в каталог независимо от типа плана.

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

Нет минимальных или максимальных требований. Рекомендуем начать с полезного набора инструментов и расширять возможности со временем.

В настоящее время нет конкретных требований SLA. Однако коннекторы с проблемами производительности или надёжности могут быть удалены из каталога.

Основная проблема: отсутствие аннотаций инструментов (30% отклонений)

Требование: все инструменты ДОЛЖНЫ включать readOnlyHint или destructiveHint

Последствия: немедленное отклонение, требуются изменения кода.

Не опционально: требование соответствия политике каталога MCP

Пример:

Телеметрия включает все параметры и данные, передаваемые в вызовы инструментов, а также ответ от MCP-сервера.

Мы обучаем модели на потребительских данных только при явном согласии пользователей. Подробнее см. https://www.anthropic.com/news/updates-to-our-consumer-terms. Мы не обучаем модели на планах Team/Enterprise.

Нет. MCP-серверы не могут определить используемый SKU Claude.

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

Коннекторы доступны пользователям Claude по всему миру. Географическое ограничение не поддерживается. Вы можете указать на любые географические ограничения в описании MCP или описаниях инструментов (например, «доступно только для организаций США»).

Ключевые ресурсы:

MCP-серверы должны обеспечивать соответствие независимо от Claude. Если пользователь реализует право на защиту данных с вашей услугой, вы должны обработать это со своей стороны.

В вашем .mcpb есть два обязательных места:

1. README.md — добавьте раздел «Политика конфиденциальности» с URL или полным текстом.

2. manifest.json — добавьте массив privacy_policies с URL HTTPS (требуется manifest_version 0.2+)

Пример:

Должна охватывать: какие данные собираются, как они используются/хранятся, совместное использование с третьими сторонами, сроки хранения и контактную информацию. ⚠️ Отсутствие политики конфиденциальности приведёт к немедленному отклонению.

Мы используем favicon, предоставленный Google, поэтому вы можете настроить URL значка вашего коннектора, обновив favicon для URL вашего коннектора. Вы можете проверить значок, который мы будем использовать, по адресу https://www.google.com/s2/favicons?domain=<YOUR_CONNECTOR_URL>&sz=64

Обязательно протестируйте каждый размер favicon (16, 32, 48, 64, 96, 128), обновив часть &sz= URL.

Удалённые коннекторы:

В противном случае предоставьте нам URL с фавиконкой, которую вы хотите использовать в качестве значка.

Локальные соединители (расширения для рабочего стола): Замените `icon.png` в вашем пакете и распространите обновленный пакет `.mcpb` пользователям.

Да. Форматирование Markdown поддерживается в описаниях соединителей.

Да. Пожалуйста, включите текст требований к учетной записи (например, 'требуется бесплатная зарегистрированная учетная запись') и гиперссылки на страницы регистрации в детали соединителя.

Реализуйте экран OAuth. Это единственный способ гарантировать отображение Условий обслуживания. Без OAuth пользователи теоретически могли бы добавлять соединители в Claude Desktop, напрямую редактируя claude_desktop_config.json.

Включите текст в описание соединителя, но специального потока согласия или всплывающего окна нет. Используйте экран OAuth, чтобы убедиться, что пользователи видят и принимают условия.

Вы должны использовать Streamable HTTP.

В настоящее время поддерживаются только описания на уровне инструмента. Описания на уровне сервера не существуют. Это требует повторения руководства по управлению в отдельных описаниях инструментов. Мы понимаем, что это неудобно, и изучаем возможности улучшения.

Используйте магазин плагинов. Node.js рекомендуется вместо Python или других языков для локальных MCP из-за лучшей совместимости со встроенной средой выполнения Claude Desktop.

Локальные MCP могут регистрироваться только в ~/Library/Logs/Claude/mcp*.log. Пользователи должны вручную делиться файлами журналов для устранения неполадок. Прямая передача журналов с локальных серверов MCP не поддерживается по соображениям безопасности.

Временно удалите фильтр IP-адресов, чтобы проверить правильность остальной конфигурации. Если подключение работает без фильтра, проблема в конфигурации фильтрации IP.

Необходимое тестирование предотвращает 80% задержек при отправке. Ознакомьтесь с нашими руководствами по отправке удаленных и локальных соединителей для лучших практик и контрольного списка перед отправкой.

Это обычно означает, что ваш сервер MCP недоступен из облачной инфраструктуры Anthropic.

Когда вы добавляете пользовательский соединитель через Customize > Connectors на любом клиенте Claude — включая claude.ai, Claude Desktop и Cowork — подключение к вашему серверу MCP исходит с серверов Anthropic, а не с вашего локального компьютера. Несмотря на то, что Cowork и Claude Desktop работают на вашем компьютере, удаленные соединители управляются на стороне сервера.

Частые причины:

Для решения этой проблемы:

Выбирайте в зависимости от ваших требований безопасности и ограничений:

Вариант 1: Без аутентификации + глобальное ограничение скорости

Лучше всего для: Общедоступные данные с низким риском злоупотребления

Вариант 2: Полная аутентификация OAuth с регистрацией пользователя

Лучше всего для: Корпоративная безопасность, конфиденциальные данные, ограничение скорости для каждого пользователя

Вариант 3: Фильтрация IP-адресов

Мы настоятельно рекомендуем вариант 2 вместо варианта 3, но если реализация OAuth действительно невозможна, вы все еще можете получить некоторый ограниченный доступ только для пользователей Claude

Важные ссылки: