Connecteur MCP
La fonctionnalité de connecteur Model Context Protocol (MCP) de Claude vous permet de vous connecter directement à des serveurs MCP distants depuis l’API Messages sans avoir besoin d’un client MCP séparé.
Cette fonctionnalité nécessite l’en-tête bêta : "anthropic-beta": "mcp-client-2025-04-04"
Fonctionnalités clés
- Intégration API directe : Connectez-vous aux serveurs MCP sans implémenter un client MCP
- Support des appels d’outils : Accédez aux outils MCP via l’API Messages
- Authentification OAuth : Support des jetons Bearer OAuth pour les serveurs authentifiés
- Serveurs multiples : Connectez-vous à plusieurs serveurs MCP dans une seule requête
Limitations
- Parmi l’ensemble des fonctionnalités de la spécification MCP, seuls les appels d’outils sont actuellement pris en charge.
- Le serveur doit être exposé publiquement via HTTP. Les serveurs STDIO locaux ne peuvent pas être connectés directement.
- Le connecteur MCP n’est actuellement pas pris en charge sur Amazon Bedrock et Google Vertex.
Utilisation du connecteur MCP dans l’API Messages
Pour vous connecter à un serveur MCP distant, incluez le paramètre mcp_servers
dans votre requête à l’API Messages :
Configuration du serveur MCP
Chaque serveur MCP dans le tableau mcp_servers
prend en charge la configuration suivante :
Description des champs
Propriété | Type | Obligatoire | Description |
---|---|---|---|
type | string | Oui | Actuellement, seul “url” est pris en charge |
url | string | Oui | L’URL du serveur MCP. Doit commencer par https:// |
name | string | Oui | Un identifiant unique pour ce serveur MCP. Il sera utilisé dans les blocs mcp_tool_call pour identifier le serveur et pour désambiguïser les outils pour le modèle. |
tool_configuration | object | Non | Configurer l’utilisation des outils |
tool_configuration.enabled | boolean | Non | Indique si les outils de ce serveur sont activés (par défaut : true) |
tool_configuration.allowed_tools | array | Non | Liste pour restreindre les outils autorisés (par défaut, tous les outils sont autorisés) |
authorization_token | string | Non | Jeton d’autorisation OAuth si requis par le serveur MCP. Voir Spécification MCP. |
Types de contenu de réponse
Lorsque Claude utilise des outils MCP, la réponse inclura deux nouveaux types de blocs de contenu :
Bloc d’utilisation d’outil MCP
Bloc de résultat d’outil MCP
Serveurs MCP multiples
Vous pouvez vous connecter à plusieurs serveurs MCP en incluant plusieurs objets dans le tableau mcp_servers
:
Authentification
Pour les serveurs MCP qui nécessitent une authentification OAuth, vous devrez obtenir un jeton d’accès. La version bêta du connecteur MCP prend en charge le passage d’un paramètre authorization_token
dans la définition du serveur MCP.
Les consommateurs de l’API sont censés gérer le flux OAuth et obtenir le jeton d’accès avant d’effectuer l’appel API, ainsi que de rafraîchir le jeton si nécessaire.
Obtention d’un jeton d’accès pour les tests
L’inspecteur MCP peut vous guider dans le processus d’obtention d’un jeton d’accès à des fins de test.
-
Exécutez l’inspecteur avec la commande suivante. Vous devez avoir Node.js installé sur votre machine.
-
Dans la barre latérale à gauche, pour “Transport type”, sélectionnez soit “SSE” soit “Streamable HTTP”.
-
Entrez l’URL du serveur MCP.
-
Dans la zone de droite, cliquez sur le bouton “Open Auth Settings” après “Need to configure authentication?”.
-
Cliquez sur “Quick OAuth Flow” et autorisez sur l’écran OAuth.
-
Suivez les étapes dans la section “OAuth Flow Progress” de l’inspecteur et cliquez sur “Continue” jusqu’à ce que vous atteigniez “Authentication complete”.
-
Copiez la valeur
access_token
. -
Collez-la dans le champ
authorization_token
de votre configuration de serveur MCP.
Utilisation du jeton d’accès
Une fois que vous avez obtenu un jeton d’accès en utilisant l’un des flux OAuth ci-dessus, vous pouvez l’utiliser dans votre configuration de serveur MCP :
Pour des explications détaillées sur le flux OAuth, consultez la section Autorisation dans la spécification MCP.