MCP коннектор
Функция MCP коннектора (Model Context Protocol) Claude позволяет подключаться к удаленным MCP серверам напрямую из Messages API без отдельного MCP клиента.
Эта функция требует beta заголовок: "anthropic-beta": "mcp-client-2025-04-04"
Ключевые возможности
- Прямая интеграция с API: Подключение к MCP серверам без реализации MCP клиента
- Поддержка вызова инструментов: Доступ к MCP инструментам через Messages API
- OAuth аутентификация: Поддержка OAuth Bearer токенов для аутентифицированных серверов
- Несколько серверов: Подключение к нескольким MCP серверам в одном запросе
Ограничения
- Из набора функций MCP спецификации, в настоящее время поддерживаются только вызовы инструментов.
- Сервер должен быть публично доступен через HTTP (поддерживает как Streamable HTTP, так и SSE транспорты). Локальные STDIO серверы не могут быть подключены напрямую.
- MCP коннектор в настоящее время не поддерживается на Amazon Bedrock и Google Vertex.
Использование MCP коннектора в Messages API
Чтобы подключиться к удаленному MCP серверу, включите параметр mcp_servers
в ваш запрос Messages API:
Конфигурация MCP сервера
Каждый MCP сервер в массиве mcp_servers
поддерживает следующую конфигурацию:
Описания полей
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
type | string | Да | В настоящее время поддерживается только “url” |
url | string | Да | URL MCP сервера. Должен начинаться с https:// |
name | string | Да | Уникальный идентификатор для этого MCP сервера. Он будет использоваться в блоках mcp_tool_call для идентификации сервера и для устранения неоднозначности инструментов для модели. |
tool_configuration | object | Нет | Настройка использования инструментов |
tool_configuration.enabled | boolean | Нет | Включить ли инструменты с этого сервера (по умолчанию: true) |
tool_configuration.allowed_tools | array | Нет | Список для ограничения разрешенных инструментов (по умолчанию разрешены все инструменты) |
authorization_token | string | Нет | OAuth токен авторизации, если требуется MCP сервером. См. MCP спецификацию. |
Типы содержимого ответа
Когда Claude использует MCP инструменты, ответ будет включать два новых типа блоков содержимого:
Блок использования MCP инструмента
Блок результата MCP инструмента
Несколько MCP серверов
Вы можете подключиться к нескольким MCP серверам, включив несколько объектов в массив mcp_servers
:
Аутентификация
Для MCP серверов, которые требуют OAuth аутентификацию, вам нужно получить токен доступа. MCP коннектор beta поддерживает передачу параметра authorization_token
в определении MCP сервера.
Ожидается, что потребители API будут обрабатывать OAuth поток и получать токен доступа перед выполнением API вызова, а также обновлять токен по мере необходимости.
Получение токена доступа для тестирования
MCP инспектор может провести вас через процесс получения токена доступа для целей тестирования.
-
Запустите инспектор с помощью следующей команды. Вам нужен Node.js, установленный на вашей машине.
-
В боковой панели слева для “Transport type” выберите либо “SSE”, либо “Streamable HTTP”.
-
Введите URL MCP сервера.
-
В правой области нажмите на кнопку “Open Auth Settings” после “Need to configure authentication?”.
-
Нажмите “Quick OAuth Flow” и авторизуйтесь на экране OAuth.
-
Следуйте шагам в разделе “OAuth Flow Progress” инспектора и нажимайте “Continue”, пока не достигнете “Authentication complete”.
-
Скопируйте значение
access_token
. -
Вставьте его в поле
authorization_token
в конфигурации вашего MCP сервера.
Использование токена доступа
После получения токена доступа с помощью любого из OAuth потоков выше, вы можете использовать его в конфигурации вашего MCP сервера:
Для подробных объяснений OAuth потока обратитесь к разделу Авторизация в MCP спецификации.