# Serveur MCP

> Connectez Allo à des assistants IA comme Claude, ChatGPT, Grok, 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, 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](/fr/help/integrations/ai-connectors).

<CardGroup cols={2}>
  <Card title="Vous utilisez Claude.ai ?" icon="/media/integrations/Claude.png" href="/fr/help/integrations/claude-connector">
    Ajoutez Allo dans Claude.ai. Vous vous connectez à Allo, sans clé API.
  </Card>
  <Card title="Vous utilisez ChatGPT ?" icon="/media/integrations/ChatGPT.svg" href="/fr/help/integrations/chatgpt-connector">
    Installez le plugin Allo dans ChatGPT. Vous vous connectez à Allo. Un serveur MCP personnalisé est l'alternative.
  </Card>
  <Card title="Vous utilisez Grok ?" icon="/media/integrations/Grok.png" href="/fr/help/integrations/grok-connector">
    Installez Allo for Grok Bot. Vous vous connectez à Allo. Un connecteur personnalisé sur grok.com est l'alternative.
  </Card>
  <Card title="Vous utilisez Cursor ?" icon="/media/mcp/clients/cursor.png" href="#cursor">
    Installez le plugin Allo depuis le Cursor Marketplace. Vous vous connectez à Allo, sans clé API.
  </Card>
</CardGroup>

## Prérequis

<Steps>
  <Step title="Obtenir une clé API">
    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.
  </Step>
  <Step title="Choisir votre client IA">
    Suivez les instructions de configuration pour votre client ci-dessous.
  </Step>
</Steps>

<Warning>
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.
</Warning>

<Note>
Le plugin Cursor et les connecteurs Claude, ChatGPT et Grok vous connectent à Allo avec votre compte. Pour ces connexions, passez l'étape de la clé API. La clé API sert aux autres clients MCP, et à l'API ChatGPT ou Grok.
</Note>

## Connecter votre client IA

### Claude Code

Exécutez cette commande dans votre terminal :

```bash
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
{
  "mcpServers": {
    "Allo": {
      "url": "https://mcp.withallo.com/mcp",
      "headers": {
        "Authorization": "YOUR_API_KEY"
      }
    }
  }
}
```

### Cursor

Installez le plugin Allo depuis le [Cursor Marketplace](https://cursor.com/marketplace/allo). Tapez ceci dans le chat de Cursor :

```text
/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 :

| Commande | Ce qu'elle fait |
|---------|-------------|
| `/allo-briefing` | Le point du jour : volume d'appels, ce qui demande votre attention, les relances |
| `/allo-followups` | Retrouve les appels qui attendent encore une relance |
| `/allo-report` | Rapport 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` :

```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) :

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

### Windsurf

Ouvrez **Settings > MCP** dans Windsurf et ajoutez :

```json
{
  "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 :

| 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, pour une ligne ou une boîte de réception ; filtrer les conversations épinglées |
| `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 |
| `allo_get_agent` | Lire toute la configuration du réceptionniste IA d'une ligne en un appel |
| `allo_update_agent` | Configurer 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_status` | Activer ou désactiver le réceptionniste IA sur une ligne |
| `allo_add_agent_knowledge_website` | Donner au réceptionniste une page web dont il tire ses réponses |
| `allo_set_agent_knowledge_website_status` | Mettre un site de connaissances hors service sans le supprimer |
| `allo_delete_agent_knowledge` | Supprimer un site de connaissances ou un document importé |
| `allo_list_calendars` | Lister les agendas connectés à votre espace de travail |
| `allo_get_calendar` | Lire un agenda avec les types d'événement proposés par son fournisseur |
| `allo_list_voices` | Lister les voix avec lesquelles un réceptionniste IA peut parler |
| `allo_list_inboxes` | Lister vos boîtes de réception, ou celles d'un coéquipier |
| `allo_get_inbox_suggestions` | Obtenir 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_options` | Lister les options du menu téléphonique d'une ligne, pour une branche de boîte sur mesure |
| `allo_create_inbox` | Créer une boîte de réception pour vous ou pour un coéquipier |
| `allo_update_inbox` | Renommer une boîte, changer ses sources ou ses filtres, couper ou réactiver ses notifications |
| `allo_delete_inbox` | Supprimer une boîte de réception. Utilisé seulement quand vous le demandez |
| `allo_pin_conversation` | Épingler une conversation (jusqu'à 10) |
| `allo_unpin_conversation` | Désépingler une conversation |
| `allo_submit_feedback` | Signaler 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.

<Card title="Tout ce que le réceptionniste peut configurer" icon="robot" href="/fr/docs/agent/overview">
  Informations sur l'activité, voix, prompt, capacités, horaires d'ouverture, règles de transfert, agendas et connaissances. La référence de ce que les outils du réceptionniste écrivent, et les deux règles de fusion qu'ils suivent.
</Card>

### 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.

<Note>
Vous avez connecté Allo avant le 28 octobre 2026 ? Reconnectez-vous pour utiliser les outils de boîtes de réception. Dans Claude, Grok, ChatGPT ou Codex, déconnectez le connecteur Allo puis connectez-le à nouveau, et acceptez les permissions des boîtes de réception. Avec une clé API, créez une nouvelle clé avec les scopes `INBOXES_READ` et `INBOXES_WRITE`.
</Note>

<Card title="Référence API des boîtes de réception" icon="/media/allo-icons/Inbox.svg" href="/fr/docs/inboxes/overview">
  Sources, conditions sur le menu téléphonique, filtres, boîtes des coéquipiers et limites.
</Card>

## 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 |
| `CONVERSATIONS_WRITE` | Marquer une conversation, épingler et désépingler |
| `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 |
| `FAX_SEND` | Envoyer des fax |
| `DIALING_QUEUE_READ_WRITE` | Lire et alimenter la file Power Dialer |
| `AGENTS_READ` | Lire la configuration du réceptionniste IA, les agendas, les voix |
| `AGENTS_WRITE` | Configurer le réceptionniste IA, son prompt et son statut |
| `INBOXES_READ` | Lister les boîtes de réception, les suggestions de boîtes, les options de menu |
| `INBOXES_WRITE` | Créer, modifier et supprimer des boîtes de réception, et couper leurs notifications |
| Aucun | Envoyer un feedback |

<Note>
Pour un accès complet à tous les outils, sélectionnez tous les scopes lors de la création de votre clé API.
</Note>

## 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 |
|-----------|------------------|
| `BUG` | Un outil a échoué avec une erreur qui ne devrait pas se produire |
| `UNEXPECTED_RESULT` | Un outil a réussi mais les données semblent fausses, par exemple un filtre ignoré |
| `DOCS` | Une description d'outil ou une page de documentation était fausse ou trompeuse |
| `MISSING_CAPABILITY` | Vous avez demandé quelque chose qu'aucun outil ne permet |
| `OTHER` | Tout 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é.

<Warning>
Un signalement décrit le problème, il ne cite pas d'appels ni de messages. Pour les espaces de travail avec HIPAA activé, Allo ne conserve que la catégorie, l'outil et les IDs de requête d'un signalement, et supprime son texte.
</Warning>

## 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

<AccordionGroup>
  <Accordion title="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](https://web.withallo.com/settings/api) pour vérifier vos clés actives. Si nécessaire, créez une nouvelle clé.
  </Accordion>
  <Accordion title="Un outil retourne une erreur de permission">
    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.
  </Accordion>
  <Accordion title="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](#signaler-un-problème).
  </Accordion>
  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Besoin d'aide ?

<CardGroup cols={2}>
  <Card title="Authentification API" icon="key" href="/fr/docs/guides/authentication">
    Documentation complète des clés API et scopes
  </Card>
  <Card title="Contacter le support" icon="headset" href="mailto:support@withallo.com">
    Obtenir de l'aide de l'équipe Allo
  </Card>
</CardGroup>
