MCP : connecter des outils tiers

Le Model Context Protocol (MCP) est un standard ouvert pour brancher des modèles sur des outils et des données. De nombreux services exposent déjà un serveur MCP. Avec le connecteur MCP de la Messages API, Claude utilise les outils de ces serveurs sans que vous écriviez ni client MCP, ni schéma d’outil.

Ce que fait le connecteur

• Intégration directe : vous indiquez l’adresse d’un serveur MCP dans la requête, l’API s’y connecte.
• Appels d’outils : les outils du serveur deviennent disponibles comme les vôtres.
• Configuration souple : activer tous les outils d’un serveur, n’en autoriser que certains, ou en exclure.
• Authentification OAuth par jeton Bearer pour les serveurs protégés.
• Plusieurs serveurs dans une même requête.

Deux éléments à déclarer

Le connecteur demande deux éléments, et l’un sans l’autre est refusé :

1. la définition du serveur, dans le tableau mcp_servers : son type, son adresse, son nom et, au besoin, son jeton ;
2. le jeu d’outils, dans le tableau tools, de type mcp_toolset, qui reprend le nom du serveur et règle les outils activés.

const response = await client.beta.messages.create({
  model: "claude-opus-5-5",
  max_tokens: 1000,
  messages: [{ role: "user", content: "Quels outils as-tu à ta disposition ?" }],
  mcp_servers: [
    {
      type: "url",
      url: "https://example-server.modelcontextprotocol.io/sse",
      name: "example-mcp",
      authorization_token: "VOTRE_JETON",
    },
  ],
  tools: [{ type: "mcp_toolset", mcp_server_name: "example-mcp" }],
  betas: ["mcp-client-2025-11-20"],
});

Le connecteur est en bêta. Une version plus récente de l’en-tête, mcp-client-2026-09-15, ajoute la possibilité de figer la liste des outils d’un serveur : un serveur peut changer ses outils à tout moment, et figer la liste évite que ce que Claude reçoit change en cours de conversation.

Quand Claude utilise un outil MCP

Claude appelle un outil MCP quand la demande correspond à ce que l’outil sait faire, explicitement (« cherche les bugs ouverts dans Jira ») ou implicitement (« qu’est-ce qui bloque la sortie ? » avec un serveur Jira connecté). Il ne l’appelle pas pour une question de culture générale sur le service : « comment fonctionnent les bases de données Notion ? » reçoit une réponse directe, alors que « que contient ma base Projets ? » déclenche l’outil.

Les limites

• Le connecteur ne prend en charge que les appels d’outils parmi toutes les fonctionnalités de la spécification MCP.
• Le serveur doit être exposé publiquement en HTTP (Streamable HTTP ou SSE). Un serveur local en stdio ne peut pas être connecté directement.
• Ce n’est pas éligible à la conservation zéro des données.

La sécurité d’abord

Un serveur MCP élargit ce que votre agent peut lire et faire. Ne connectez que des serveurs de confiance, limitez les outils activés au strict nécessaire, et gardez les jetons hors du code : variables d’environnement ou gestionnaire de secrets. Un serveur qui renvoie du contenu externe peut transporter une injection de prompt. Avec les agents gérés, présentés plus loin, les identifiants des serveurs MCP ne figurent pas dans la configuration de l’agent : ils sont rangés dans des coffres (vaults) rattachés aux sessions.

À vous de jouer

Un serveur distant par l’API. Déclarez un serveur MCP distant dans mcp_servers, ajoutez son mcp_toolset, et posez une question qui l’oblige à s’en servir. Repérez dans la réponse les blocs d’appel et de résultat MCP, puis limitez les outils exposés avec la configuration du toolset.

Sources officielles : MCP (Claude Academy) · MCP connector · Model Context Protocol

Points clés à retenir

• Le connecteur MCP branche Claude sur un serveur MCP distant sans client ni schéma à écrire
• Deux éléments obligatoires : mcp_servers (le serveur) et un outil mcp_toolset (les outils activés)
• Seuls les appels d’outils sont pris en charge, et le serveur doit être public en HTTP
• Serveurs de confiance seulement, outils limités, jetons hors du code