Allo

Serveur MCP

Connectez Allo à des assistants IA comme Claude, ChatGPT, Grok, Cursor et VS Code via le Model Context Protocol

Mis à jour le

Connectez Allo à n'importe quel assistant IA compatible avec le Model Context Protocol (MCP). Recherchez des appels, lisez des transcriptions, envoyez des SMS, gérez les tags, analysez les performances de votre équipe et configurez votre réceptionniste IA — directement depuis votre outil IA.

Pour ajouter vos propres applications et serveurs MCP dans Allo, consultez Connecteurs IA.

Prérequis

Obtenir une clé API

Allez dans Paramètres > API et cliquez sur Créer une clé API.

Sélectionnez les scopes dont vous avez besoin. Pour un accès MCP complet, activez tous les scopes. Pour un accès en lecture seule, sélectionnez uniquement les scopes READ.

Copiez la clé — elle ne sera plus affichée.

Choisir votre client IA

Suivez les instructions de configuration pour votre client ci-dessous.

Connecter votre client IA

Claude Code

Exécutez cette commande dans votre terminal :

claude mcp add Allo --transport http https://mcp.withallo.com/mcp \
  --header "Authorization: YOUR_API_KEY"

Remplacez YOUR_API_KEY par votre clé API Allo.

Claude Desktop

Ouvrez Settings > MCP dans Claude Desktop et ajoutez un nouveau serveur avec cette configuration :

{
  "mcpServers": {
    "Allo": {
      "url": "https://mcp.withallo.com/mcp",
      "headers": {
        "Authorization": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

Installez le plugin Allo depuis le Cursor Marketplace. Tapez ceci dans le chat de Cursor :

/add-plugin allo

La première fois que Cursor utilise Allo, il vous demande de vous connecter à Allo et d'autoriser l'accès. Aucune clé API à créer.

Le plugin relie Cursor au serveur MCP Allo et lui apprend à bien utiliser les outils : recherche d'appels et de SMS, envoi de SMS, statistiques d'équipe, réceptionniste IA et call flows. Il ajoute aussi trois commandes :

CommandeCe qu'elle fait
/allo-briefingLe point du jour : volume d'appels, ce qui demande votre attention, les relances
/allo-followupsRetrouve les appels qui attendent encore une relance
/allo-reportRapport de performance téléphonique de l'équipe, comparé à la période précédente

Le même plugin fonctionne aussi dans Grok Bot.

Configurer Cursor avec une clé API

Pour configurer le serveur vous-même, allez dans Settings > MCP dans Cursor, cliquez sur Add new MCP server et sélectionnez Type: HTTP.

Vous pouvez aussi ajouter ceci dans votre ~/.cursor/mcp.json :

{
  "mcpServers": {
    "Allo": {
      "url": "https://mcp.withallo.com/mcp",
      "headers": {
        "Authorization": "YOUR_API_KEY"
      }
    }
  }
}

VS Code

Ajoutez ceci dans votre fichier .vscode/mcp.json (créez-le s'il n'existe pas) :

{
  "servers": {
    "Allo": {
      "type": "http",
      "url": "https://mcp.withallo.com/mcp",
      "headers": {
        "Authorization": "YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Ouvrez Settings > MCP dans Windsurf et ajoutez :

{
  "mcpServers": {
    "Allo": {
      "serverUrl": "https://mcp.withallo.com/mcp",
      "headers": {
        "Authorization": "YOUR_API_KEY"
      }
    }
  }
}

Autres clients

Tout client compatible MCP peut se connecter à Allo avec :

  • URL du serveur : https://mcp.withallo.com/mcp
  • Transport : HTTP
  • Authentification : header Authorization avec votre clé API

Consultez la documentation de votre client pour configurer des serveurs MCP distants avec des headers personnalisés.

Outils disponibles

Une fois connecté, votre assistant IA peut utiliser ces outils :

OutilCe qu'il fait
allo_get_meDécouvrir les scopes, endpoints disponibles et infos de votre équipe
allo_list_usersLister les membres de l'équipe avec rôles et statuts
allo_list_numbersLister les numéros de téléphone avec leurs capacités (voix, SMS)
allo_list_tagsLister tous les tags configurés sur votre équipe
allo_list_conversationsLister les conversations groupées par contact, triées par activité récente, pour une ligne ou une boîte de réception ; filtrer les conversations épinglées
allo_search_conversation_itemsRechercher appels et SMS avec filtres : mot-clé, type, direction, tags, période
allo_get_conversation_itemObtenir les détails complets d'un appel ou SMS, y compris la transcription
allo_batch_get_conversation_itemsRécupérer jusqu'à 100 éléments en une seule requête
allo_mark_conversationMarquer les conversations comme lues, non lues, archivées ou désarchivées
allo_add_call_tagsAjouter des tags à un appel
allo_remove_call_tagSupprimer un tag d'un appel
allo_send_smsEnvoyer un SMS depuis l'un de vos numéros Allo
allo_get_team_analyticsObtenir les KPIs de l'équipe : appels, temps de conversation, taux de réponse
allo_get_team_outbound_analyticsObtenir les métriques sortantes : funnel, séries temporelles, heatmap, classement
allo_get_dialing_queueLire la file Power Dialer de l'utilisateur : paramètres, numéros ordonnés et état d'appel par entrée
allo_add_to_dialing_queueAjouter des numéros à la file Power Dialer de l'utilisateur (la file est créée au premier appel) ; accepte des métadonnées de contact optionnelles
allo_get_agentLire toute la configuration du réceptionniste IA d'une ligne en un appel
allo_update_agentConfigurer le réceptionniste IA : informations, voix, capacités, horaires, règles de transfert, agendas, texte de connaissances
allo_set_agent_promptÉcrire le prompt du réceptionniste IA, section par section
allo_set_agent_statusActiver ou désactiver le réceptionniste IA sur une ligne
allo_add_agent_knowledge_websiteDonner au réceptionniste une page web dont il tire ses réponses
allo_set_agent_knowledge_website_statusMettre un site de connaissances hors service sans le supprimer
allo_delete_agent_knowledgeSupprimer un site de connaissances ou un document importé
allo_list_calendarsLister les agendas connectés à votre espace de travail
allo_get_calendarLire un agenda avec les types d'événement proposés par son fournisseur
allo_list_voicesLister les voix avec lesquelles un réceptionniste IA peut parler
allo_list_inboxesLister vos boîtes de réception, ou celles d'un coéquipier
allo_get_inbox_suggestionsObtenir des sources de boîte prêtes à l'emploi, classées d'après les appels et SMS récents, options du menu téléphonique comprises
allo_list_menu_optionsLister les options du menu téléphonique d'une ligne, pour une branche de boîte sur mesure
allo_create_inboxCréer une boîte de réception pour vous ou pour un coéquipier
allo_update_inboxRenommer une boîte, changer ses sources ou ses filtres, couper ou réactiver ses notifications
allo_delete_inboxSupprimer une boîte de réception. Utilisé seulement quand vous le demandez
allo_pin_conversationÉpingler une conversation (jusqu'à 10)
allo_unpin_conversationDésépingler une conversation
allo_submit_feedbackSignaler un bug, une documentation trompeuse ou une fonctionnalité manquante à l'équipe Allo. Aucun scope requis

Le serveur expose aussi deux guides sous forme de ressources MCP, allo-mcp://guides/ai-receptionist-setup et allo-mcp://guides/ai-receptionist-prompt. Les outils du réceptionniste y renvoient votre assistant : demandez-lui de configurer un réceptionniste plutôt que de remplir les champs un par un.

Boîtes de réception

Demandez à votre assistant de créer des boîtes de réception avec vos propres mots. Il part des suggestions de boîtes, qui couvrent déjà vos lignes et les options de votre menu téléphonique : vous n'avez jamais besoin des identifiants de nœuds du menu. Quand vous nommez une boîte ("ma boîte Ventes"), l'assistant la retrouve et liste ses conversations, sur toutes ses lignes. Une boîte peut aussi suivre un sujet : l'assistant y enregistre vos tags d'appels (IA ou manuels), et une conversation s'affiche dès qu'un de ses appels sur les lignes de la boîte en porte un.

Les admins et managers peuvent aussi créer des boîtes pour un coéquipier. La boîte appartient au coéquipier et apparaît dans son sélecteur de boîtes. L'assistant ne supprime jamais une boîte sans que vous le demandiez.

Scopes requis

Chaque outil nécessite des scopes spécifiques. Sélectionnez les scopes correspondant aux outils dont vous avez besoin :

ScopeOutils
CONVERSATIONS_READLister les conversations, rechercher, obtenir un élément, batch
CONVERSATIONS_WRITEMarquer une conversation, épingler et désépingler
USERS_READLister les utilisateurs, get me
PHONE_NUMBERS_READLister les numéros
TAGS_READLister les tags
TAGS_WRITEAjouter/supprimer des tags
SMS_SENDEnvoyer des SMS
FAX_SENDEnvoyer des fax
DIALING_QUEUE_READ_WRITELire et alimenter la file Power Dialer
AGENTS_READLire la configuration du réceptionniste IA, les agendas, les voix
AGENTS_WRITEConfigurer le réceptionniste IA, son prompt et son statut
INBOXES_READLister les boîtes de réception, les suggestions de boîtes, les options de menu
INBOXES_WRITECréer, modifier et supprimer des boîtes de réception, et couper leurs notifications
AucunEnvoyer un feedback

Signaler un problème

allo_submit_feedback envoie un signalement sur un outil directement à l'équipe Allo, qui lit chaque signalement. Les assistants connectés l'utilisent d'eux-mêmes quand un outil échoue d'une manière qu'une nouvelle tentative ne corrigera pas. Vous pouvez aussi le demander : « signale ça à Allo ». Aucun scope n'est requis, et l'outil n'est disponible que via le serveur MCP, pas via l'API REST.

CatégorieÀ utiliser quand
BUGUn outil a échoué avec une erreur qui ne devrait pas se produire
UNEXPECTED_RESULTUn outil a réussi mais les données semblent fausses, par exemple un filtre ignoré
DOCSUne description d'outil ou une page de documentation était fausse ou trompeuse
MISSING_CAPABILITYVous avez demandé quelque chose qu'aucun outil ne permet
OTHERTout autre point utile pour l'équipe Allo

Un signalement est plus utile avec le nom de l'outil, le request_id de l'erreur et une courte description de ce qui était attendu et de ce qui s'est passé.

Exemples de prompts

Une fois connecté, essayez de demander à votre assistant IA :

  • "Montre-moi tous les appels manqués de cette semaine"
  • "Quel était le taux de réponse de mon équipe le mois dernier comparé au mois précédent ?"
  • "Trouve tous les appels tagués 'demo' des 30 derniers jours et résume les transcriptions"
  • "Envoie un SMS au +33612345678 depuis mon numéro principal pour dire qu'on rappelle dans 10 minutes"
  • "Qui dans mon équipe a passé le plus d'appels sortants cette semaine ?"
  • "Liste toutes les conversations non lues et marque-les comme lues"
  • "Tague les 5 derniers appels entrants comme 'support'"
  • "Montre-moi ce qui est dans ma file Power Dialer en ce moment"
  • "Ajoute ces numéros à ma file Power Dialer : +14155551234, +33612345678"
  • "Configure le réceptionniste IA sur ma ligne principale, pose-moi les questions dont tu as besoin"
  • "Ajoute une règle de transfert qui envoie les questions de facturation au +33612345678"
  • "Crée-moi une boîte de réception Ventes"
  • "Crée une boîte Support pour Lucio avec Website FR option 2"
  • "Montre ma boîte Ventes"
  • "Crée une boîte Portabilité sur Support US et Support FR, avec seulement les appels tagués portabilité"
  • "Épingle ce client"
  • "Coupe les notifications de ma boîte Support"

Troubleshooting

Connexion échouée ou non autorisée

Vérifiez que votre clé API est correcte et n'a pas été révoquée. Allez dans Paramètres > API pour vérifier vos clés actives. Si nécessaire, créez une nouvelle clé.

Un outil retourne une erreur de permission

Votre clé API n'a pas le scope requis. Consultez le tableau des scopes requis ci-dessus et créez une nouvelle clé avec les scopes nécessaires.

Un outil retourne des données fausses ou une erreur inattendue

Demandez à votre assistant de le signaler avec allo_submit_feedback, en incluant le nom de l'outil et le request_id de l'erreur. Le signalement arrive directement à l'équipe Allo. Consultez Signaler un problème.

Les outils n'apparaissent pas dans mon client IA

Assurez-vous que le serveur MCP est connecté et actif. Redémarrez votre client IA et vérifiez que l'URL du serveur est exactement https://mcp.withallo.com/mcp. Certains clients nécessitent un redémarrage après l'ajout d'un nouveau serveur MCP.

Besoin d'aide ?