Conector MCP
O recurso de conector do Protocolo de Contexto de Modelo (MCP) do Claude permite conectar-se a servidores MCP remotos diretamente da API de Mensagens sem um cliente MCP separado.
O recurso de conector do Protocolo de Contexto de Modelo (MCP) do Claude permite conectar-se a servidores MCP remotos diretamente da API de Mensagens sem um cliente MCP separado.
Este recurso requer o cabeçalho beta: "anthropic-beta": "mcp-client-2025-04-04"
Recursos principais
- Integração direta da API: Conecte-se a servidores MCP sem implementar um cliente MCP
- Suporte a chamadas de ferramentas: Acesse ferramentas MCP através da API de Mensagens
- Autenticação OAuth: Suporte para tokens Bearer OAuth para servidores autenticados
- Múltiplos servidores: Conecte-se a múltiplos servidores MCP em uma única solicitação
Limitações
- Do conjunto de recursos da especificação MCP, apenas chamadas de ferramentas são atualmente suportadas.
- O servidor deve estar publicamente exposto através de HTTP (suporta transportes HTTP Streamable e SSE). Servidores STDIO locais não podem ser conectados diretamente.
- O conector MCP atualmente não é suportado no Amazon Bedrock e Google Vertex.
Usando o conector MCP na API de Mensagens
Para conectar-se a um servidor MCP remoto, inclua o parâmetro mcp_servers
em sua solicitação da API de Mensagens:
Configuração do servidor MCP
Cada servidor MCP no array mcp_servers
suporta a seguinte configuração:
Descrições dos campos
Propriedade | Tipo | Obrigatório | Descrição |
---|---|---|---|
type | string | Sim | Atualmente apenas “url” é suportado |
url | string | Sim | A URL do servidor MCP. Deve começar com https:// |
name | string | Sim | Um identificador único para este servidor MCP. Será usado em blocos mcp_tool_call para identificar o servidor e desambiguar ferramentas para o modelo. |
tool_configuration | object | Não | Configurar uso de ferramentas |
tool_configuration.enabled | boolean | Não | Se deve habilitar ferramentas deste servidor (padrão: true) |
tool_configuration.allowed_tools | array | Não | Lista para restringir as ferramentas a permitir (por padrão, todas as ferramentas são permitidas) |
authorization_token | string | Não | Token de autorização OAuth se requerido pelo servidor MCP. Veja especificação MCP. |
Tipos de conteúdo de resposta
Quando Claude usa ferramentas MCP, a resposta incluirá dois novos tipos de bloco de conteúdo:
Bloco de Uso de Ferramenta MCP
Bloco de Resultado de Ferramenta MCP
Múltiplos servidores MCP
Você pode conectar-se a múltiplos servidores MCP incluindo múltiplos objetos no array mcp_servers
:
Autenticação
Para servidores MCP que requerem autenticação OAuth, você precisará obter um token de acesso. O beta do conector MCP suporta passar um parâmetro authorization_token
na definição do servidor MCP.
Espera-se que os consumidores da API lidem com o fluxo OAuth e obtenham o token de acesso antes de fazer a chamada da API, bem como atualizem o token conforme necessário.
Obtendo um token de acesso para testes
O inspetor MCP pode guiá-lo através do processo de obter um token de acesso para fins de teste.
-
Execute o inspetor com o seguinte comando. Você precisa ter Node.js instalado em sua máquina.
-
Na barra lateral à esquerda, para “Tipo de transporte”, selecione “SSE” ou “Streamable HTTP”.
-
Digite a URL do servidor MCP.
-
Na área direita, clique no botão “Abrir Configurações de Autenticação” após “Precisa configurar autenticação?”.
-
Clique em “Fluxo OAuth Rápido” e autorize na tela OAuth.
-
Siga os passos na seção “Progresso do Fluxo OAuth” do inspetor e clique em “Continuar” até chegar em “Autenticação completa”.
-
Copie o valor
access_token
. -
Cole-o no campo
authorization_token
em sua configuração do servidor MCP.
Usando o token de acesso
Uma vez que você tenha obtido um token de acesso usando qualquer um dos fluxos OAuth acima, você pode usá-lo em sua configuração do servidor MCP:
Para explicações detalhadas do fluxo OAuth, consulte a seção de Autorização na especificação MCP.