Serveur MCP

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 et analysez les performances de votre équipe — directement depuis votre outil 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.

Seuls les administrateurs et les propriétaires peuvent créer des clés API. Les membres de l’équipe ne peuvent pas en générer.

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

Ouvrez 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 16 outils :

Outil	Ce qu’il fait
`allo_get_me`	Découvrir les scopes, endpoints disponibles et infos de votre équipe
`allo_list_users`	Lister les membres de l’équipe avec rôles et statuts
`allo_list_numbers`	Lister les numéros de téléphone avec leurs capacités (voix, SMS)
`allo_list_tags`	Lister tous les tags configurés sur votre équipe
`allo_list_conversations`	Lister les conversations groupées par contact, triées par activité récente
`allo_search_conversation_items`	Rechercher appels et SMS avec filtres : mot-clé, type, direction, tags, période
`allo_get_conversation_item`	Obtenir les détails complets d’un appel ou SMS, y compris la transcription
`allo_batch_get_conversation_items`	Récupérer jusqu’à 100 éléments en une seule requête
`allo_mark_conversation`	Marquer les conversations comme lues, non lues, archivées ou désarchivées
`allo_add_call_tags`	Ajouter des tags à un appel
`allo_remove_call_tag`	Supprimer un tag d’un appel
`allo_send_sms`	Envoyer un SMS depuis l’un de vos numéros Allo
`allo_get_team_analytics`	Obtenir les KPIs de l’équipe : appels, temps de conversation, taux de réponse
`allo_get_team_outbound_analytics`	Obtenir les métriques sortantes : funnel, séries temporelles, heatmap, classement
`allo_get_dialing_queue`	Lire la file Power Dialer de l’utilisateur : paramètres, numéros ordonnés et état d’appel par entrée
`allo_add_to_dialing_queue`	Ajouter 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

Scopes requis

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

Scope	Outils
`CONVERSATIONS_READ`	Lister les conversations, rechercher, obtenir un élément, batch, marquer
`USERS_READ`	Lister les utilisateurs, get me
`PHONE_NUMBERS_READ`	Lister les numéros
`TAGS_READ`	Lister les tags
`TAGS_WRITE`	Ajouter/supprimer des tags
`SMS_SEND`	Envoyer des SMS
`DIALING_QUEUE_READ_WRITE`	Lire et alimenter la file Power Dialer

Pour un accès complet aux 16 outils, sélectionnez tous les scopes lors de la création de votre clé API.

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”

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.

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.

Commencer

Numéros de téléphone

Fonctionnalités

Gestion d'équipe

Intégrations

Facturation et abonnement

Support

Prérequis

Connecter votre client IA

Claude Code

Claude Desktop

Cursor

VS Code

Windsurf

Autres clients

Outils disponibles

Scopes requis

Exemples de prompts

Troubleshooting

Besoin d’aide ?

Authentification API

Contacter le support

​Prérequis

​Connecter votre client IA

​Claude Code

​Claude Desktop

​Cursor

​VS Code

​Windsurf

​Autres clients

​Outils disponibles

​Scopes requis

​Exemples de prompts

​Troubleshooting

​Besoin d’aide ?

Authentification API

Contacter le support

Prérequis

Connecter votre client IA

Claude Code

Claude Desktop

Cursor

VS Code

Windsurf

Autres clients

Outils disponibles

Scopes requis

Exemples de prompts

Troubleshooting

Besoin d’aide ?