Connecter les outils d'IA avec MCP

Ody dispose d'un serveur MCP (Model Context Protocol) intégré à https://api.ody.co/v1/mcp — ajoutez-le à ChatGPT, Claude, Cursor ou tout client MCP avec une clé API, et l'assistant pourra gérer les contacts, travailler vos conversations, rechercher des messages, envoyer des SMS, acheter des numéros de téléphone, enregistrer la messagerie 10DLC, passer des appels IA sortants et configurer votre agent IA dans votre espace de travail.

Avant de commencer

• Vous avez besoin d'une clé API — voir Obtenir votre clé API Ody. Pour un assistant qui ne devrait que lire, créez la clé avec uniquement les portées de lecture. Pour expérimenter sans envoyer de vrais SMS, utilisez une clé ody_test_… — voir Développer en toute sécurité avec le mode test.
• Le MCP est inclus dans tous les forfaits, à partir du forfait Starter.

Étape par étape

1. Cliquez sur Paramètres dans la barre latérale, puis sur API développeur.

2. Faites défiler jusqu'à la carte Connecter à ChatGPT & Claude. Elle affiche le point de terminaison MCP — https://api.ody.co/v1/mcp — avec un bouton Copier, et une configuration client prête à être collée.

3. Dans les paramètres MCP/connecteur de votre outil d'IA, ajoutez un serveur en utilisant cette configuration (avec votre vraie clé) :

{
  "mcpServers": {
    "ody": {
      "url": "https://api.ody.co/v1/mcp",
      "headers": { "Authorization": "Bearer ody_live_…" }
    }
  }
}

4. Demandez à l'assistant quelque chose comme « donnez-moi un résumé de mon espace de travail Ody » pour confirmer la connexion.

Ce que l'assistant peut faire

Le serveur MCP expose vingt outils, chacun étant régi par la même portée que son point de terminaison REST utilise :

Outil	Ce qu'il fait	Portée requise
list_contacts	Lister ou rechercher vos contacts	contacts:read
create_contact	Ajouter un contact	contacts:write
update_contact	Mettre à jour le nom, l'entreprise, le téléphone ou l'e-mail d'un contact	contacts:write
delete_contact	Supprimer définitivement un contact	contacts:write
list_conversations	Lister les conversations ouvertes/terminées	conversations:read
get_conversation	Lire un fil de discussion complet	conversations:read
set_conversation_status	Marquer une conversation comme ouverte ou terminée	conversations:write
search_messages	Rechercher dans les corps de messages, les transcriptions de messagerie vocale et les notes d'appel	conversations:read
workspace_summary	Instantané : nombre de contacts, nombre d'ouverts/terminés, total de non lus, volume sur 7 jours	conversations:read
wait_for_message	Attendre (jusqu'à 25 s) un nouveau message entrant dans une conversation	conversations:read
send_message	Envoyer un SMS (à une conversation ou à un numéro de téléphone)	messages:send
list_numbers	Lister les numéros de votre espace de travail	numbers:read
search_numbers	Rechercher des numéros de téléphone que vous pouvez acheter	numbers:manage
buy_number	Acheter un numéro — facturé comme un achat intégré	numbers:manage
get_messaging_status	Vérifier le statut d'enregistrement de la messagerie 10DLC	numbers:manage
submit_10dlc_registration	Déposer votre entreprise + campagne 10DLC (facturé)	numbers:manage
place_call	Faire passer un appel sortant à votre agent IA publié	calls:place
get_agent	Lire la configuration de votre agent IA et l'utilisation des crédits	agent:manage
configure_agent	Mettre à jour la configuration de l'agent ; passer publish: true pour le mettre en ligne	agent:manage
connect_agent_to_number	Acheminer l'un de vos numéros vers l'agent IA	agent:manage

Si la clé manque une portée, cet outil n'est tout simplement pas proposé à l'assistant — ainsi, une clé en lecture seule produit un assistant véritablement en lecture seule. Tout s'exécute avec les permissions du membre qui a créé la clé, uniquement dans cet espace de travail.

Deux choses à savoir :

• wait_for_message permet à un assistant de tenir une conversation SMS en direct : il envoie un SMS avec send_message, attend jusqu'à 25 secondes la réponse, et répond — appelant à nouveau l'outil si le délai d'attente est dépassé.
• Les outils de numéro, 10DLC, d'appel et d'agent sont la même surface « Agent Phone » que l'API REST — même facturation, mêmes règles, et vous pouvez prendre le contrôle dans l'application à tout moment. Voir Acheter des numéros et enregistrer la messagerie via l'API et Passer des appels IA et gérer Astra via l'API.

Avec une clé de test, send_message enregistre un message simulé, buy_number et place_call simulent (rien n'est acheté ou composé), la publication de l'agent est simulée, et submit_10dlc_registration dépose en mode simulé — pas de frais, pas de soumission au registre.

Articles connexes

• Obtenir votre clé API Ody
• Développer en toute sécurité avec le mode test
• Présentation de l'API et authentification