> ## Documentation Index
> Fetch the complete documentation index at: https://help.withallo.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Serveur MCP
> Connectez Allo à des assistants IA comme Claude, Cursor et VS Code via le Model Context Protocol
Connectez Allo à n'importe quel assistant IA compatible avec le [Model Context Protocol](https://modelcontextprotocol.io) (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
Allez dans [Paramètres > API](https://web.withallo.com/settings/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.
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 :
```bash theme={null}
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 :
```json theme={null}
{
"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` :
```json theme={null}
{
"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) :
```json theme={null}
{
"servers": {
"Allo": {
"type": "http",
"url": "https://mcp.withallo.com/mcp",
"headers": {
"Authorization": "YOUR_API_KEY"
}
}
}
}
```
### Windsurf
Ouvrez **Settings > MCP** dans Windsurf et ajoutez :
```json theme={null}
{
"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
Vérifiez que votre clé API est correcte et n'a pas été révoquée. Allez dans [Paramètres > API](https://web.withallo.com/settings/api) pour vérifier vos clés actives. Si nécessaire, créez une nouvelle clé.
Votre clé API n'a pas le scope requis. Consultez le tableau des [scopes requis](#scopes-requis) ci-dessus et créez une nouvelle clé avec les scopes nécessaires.
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 ?
Documentation complète des clés API et scopes
Obtenir de l'aide de l'équipe Allo