Serveurs MCP

Un serveur MCP (Model Context Protocol) est un endpoint qui expose un ou plusieurs outils que l’IA peut découvrir et utiliser à l’exécution. Cela vous permet de faire évoluer l’ensemble d’outils sans modifier la configuration de l’agent : ajoutez un outil sur votre serveur, l’IA le verra à la prochaine découverte.

Ce qu’est un serveur MCP

MCP est un protocole ouvert basé sur JSON-RPC 2.0 transporté sur HTTP (Streamable HTTP). Le serveur expose des primitives comme tools/list et tools/call. yourang.ai interroge votre serveur au début de chaque appel pour découvrir les outils, puis les expose à l’IA comme fonctions appelables. Chaque invocation passe par votre serveur, qui exécute la logique et répond.

Comment l’IA communique avec le serveur MCP

1. 1

   Découverte initiale

   Au démarrage de l’appel, yourang.ai envoie une requête tools/list à votre serveur MCP. Le serveur répond avec la liste des outils (nom, description, schéma des paramètres). La découverte ne transporte aucune donnée client : elle ne sert qu’à construire le catalogue d’outils.

2. 2

   Session MCP

   La première réponse du serveur renvoie un header Mcp-Session-Id. Nous le réutilisons sur chaque requête suivante (tools/list et tools/call) au sein de cet appel vocal, afin que votre serveur puisse conserver un état si nécessaire.

3. 3

   Exposition à l’agent

   Les outils découverts sont fournis au modèle IA comme fonctions appelables, à côté des outils prédéfinis et des External Tools.

4. 4

   Invocation (tools/call)

   Lorsque le modèle décide d’utiliser un outil MCP, yourang.ai appelle tools/call avec le nom de l’outil + les arguments. Avec les arguments, nous attachons automatiquement un bloc _meta.caller avec les métadonnées client que nous connaissons (voir section ci-dessous).

5. 5

   Réponse à l’IA

   Le contenu textuel de la réponse MCP est extrait des blocs content[].text, concaténé et retourné au modèle comme function output. La conversation continue.

Payload JSON-RPC

Les deux requêtes que votre serveur recevra sont simples et standard. La découverte ne transporte pas de métadonnées ; l’invocation oui.

{
 "jsonrpc": "2.0",
 "method": "tools/list",
 "params": {},
 "id": "<uuid>"
}

Métadonnées client envoyées automatiquement

Quand l’IA invoque un outil, yourang.ai enrichit la requête avec un bloc _meta.caller contenant le contexte de l’appel en cours. Ce sont des champs standards, remplis avec ce que nous savons déjà du client au moment de l’appel.

call_sid

UUID unique de l’appel en cours. Utile pour corréler vos logs côté serveur MCP avec l’historique des appels dans yourang.ai.

agent_id

UUID de l’agent IA qui a invoqué l’outil. À utiliser si plusieurs agents partagent le même serveur MCP et que vous devez différencier la logique.

organization_id

UUID de l’organisation (tenant). Typiquement le premier filtre que vous appliquez sur votre serveur : chaque appel appartient à un seul tenant.

phone

Numéro de téléphone de l’appelant au format E.164 (par ex. +33 6 12 34 56 78), quand disponible.

name

Nom du contact, si nous l’avons déjà dans le répertoire pour ce numéro. Absent si l’appelant est inconnu.

email

E-mail du contact, s’il est présent dans la fiche contact dans yourang.ai.

contact_id

UUID du contact dans yourang.ai si le numéro a trouvé une correspondance dans le répertoire. Utilisez-le pour récupérer plus de données sans passer par une recherche téléphone.

Comment en configurer un

1. 1

   Ouvrez la configuration de l’agent

   /ai-agents → sélectionnez l’agent → onglet MCP.

2. 2

   Saisissez URL et authentification

   URL HTTPS du serveur MCP, méthode d’authentification (aucune, Bearer, API key, headers personnalisés).

3. 3

   Sauvegardez et vérifiez la découverte

   Le panneau affiche le nombre d’outils découverts la dernière fois et l’horodatage. Vous pouvez forcer une nouvelle découverte en un clic.

4. 4

   Activez ou désactivez des outils individuels

   Même si le serveur expose 30 outils, vous pouvez n’en activer que 5 pour cet agent.

Authentification et headers

Chaque requête MCP inclut toujours Content-Type et Accept standards, plus le header d’authentification configuré et un Mcp-Session-Id que nous réutilisons sur toutes les requêtes de la même session vocale.

# Sempre presenti
Content-Type: application/json
Accept: application/json, text/event-stream
Mcp-Session-Id: <restituito dal server alla prima risposta>

# Auth (in base alla configurazione)
Authorization: Bearer <token>
# oppure
X-API-Key: <chiave>

Aucune

Serveur public. Uniquement pour les tests ou les outils sans données sensibles.

Bearer

Header Authorization: Bearer <token> à chaque requête.

API key

Header HTTP au choix (par ex. X-API-Key).

Headers personnalisés

Combinaisons multiples (par ex. X-Tenant + X-Signature).

Quand préférer MCP vs External Tool

• Vous avez plusieurs outils liés. Un serveur MCP qui expose 10 outils CRM (lookup, create, update, list, etc.) est plus gérable que 10 External Tools séparés.
• Vous voulez faire évoluer le catalogue d’outils. Ajoutez des outils sur votre serveur sans toucher à la configuration yourang.ai : la prochaine découverte les prend en compte.
• Vous devez parler à un seul endpoint. Un External Tool est plus léger : moins de surcoût, configuration directe.