Conector MCP
La función de conector del Protocolo de Contexto de Modelo (MCP) de Claude te permite conectarte a servidores MCP remotos directamente desde la API de Mensajes sin necesitar un cliente MCP separado.
Esta función requiere el encabezado beta: "anthropic-beta": "mcp-client-2025-04-04"
Características principales
- Integración directa con la API: Conéctate a servidores MCP sin implementar un cliente MCP
- Soporte para llamadas a herramientas: Accede a herramientas MCP a través de la API de Mensajes
- Autenticación OAuth: Soporte para tokens Bearer de OAuth para servidores autenticados
- Múltiples servidores: Conéctate a múltiples servidores MCP en una sola solicitud
Limitaciones
- Del conjunto de características de la especificación MCP, actualmente solo se admiten las llamadas a herramientas.
- El servidor debe estar expuesto públicamente a través de HTTP. Los servidores STDIO locales no pueden conectarse directamente.
- El conector MCP actualmente no es compatible con Amazon Bedrock y Google Vertex.
Uso del conector MCP en la API de Mensajes
Para conectarte a un servidor MCP remoto, incluye el parámetro mcp_servers
en tu solicitud a la API de Mensajes:
Configuración del servidor MCP
Cada servidor MCP en el array mcp_servers
admite la siguiente configuración:
Descripción de campos
Propiedad | Tipo | Obligatorio | Descripción |
---|---|---|---|
type | string | Sí | Actualmente solo se admite “url” |
url | string | Sí | La URL del servidor MCP. Debe comenzar con https:// |
name | string | Sí | Un identificador único para este servidor MCP. Se utilizará en bloques mcp_tool_call para identificar el servidor y para diferenciar herramientas para el modelo. |
tool_configuration | object | No | Configurar el uso de herramientas |
tool_configuration.enabled | boolean | No | Si se deben habilitar las herramientas de este servidor (predeterminado: true) |
tool_configuration.allowed_tools | array | No | Lista para restringir las herramientas permitidas (por defecto, todas las herramientas están permitidas) |
authorization_token | string | No | Token de autorización OAuth si es requerido por el servidor MCP. Ver especificación MCP. |
Tipos de contenido de respuesta
Cuando Claude utiliza herramientas MCP, la respuesta incluirá dos nuevos tipos de bloques de contenido:
Bloque de uso de herramienta MCP
Bloque de resultado de herramienta MCP
Múltiples servidores MCP
Puedes conectarte a múltiples servidores MCP incluyendo varios objetos en el array mcp_servers
:
Autenticación
Para los servidores MCP que requieren autenticación OAuth, necesitarás obtener un token de acceso. La versión beta del conector MCP admite pasar un parámetro authorization_token
en la definición del servidor MCP.
Se espera que los consumidores de la API manejen el flujo OAuth y obtengan el token de acceso antes de realizar la llamada a la API, así como renovar el token según sea necesario.
Obtención de un token de acceso para pruebas
El inspector MCP puede guiarte a través del proceso de obtención de un token de acceso para fines de prueba.
-
Ejecuta el inspector con el siguiente comando. Necesitas tener Node.js instalado en tu máquina.
-
En la barra lateral de la izquierda, para “Transport type”, selecciona “SSE” o “Streamable HTTP”.
-
Introduce la URL del servidor MCP.
-
En el área de la derecha, haz clic en el botón “Open Auth Settings” después de “Need to configure authentication?”.
-
Haz clic en “Quick OAuth Flow” y autoriza en la pantalla de OAuth.
-
Sigue los pasos en la sección “OAuth Flow Progress” del inspector y haz clic en “Continue” hasta llegar a “Authentication complete”.
-
Copia el valor de
access_token
. -
Pégalo en el campo
authorization_token
en tu configuración del servidor MCP.
Uso del token de acceso
Una vez que hayas obtenido un token de acceso utilizando cualquiera de los flujos OAuth anteriores, puedes usarlo en tu configuración de servidor MCP:
Para explicaciones detalladas del flujo OAuth, consulta la sección de Autorización en la especificación MCP.