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

# Connecteur Grok

> Installez Allo for Grok Bot, ou connectez un serveur MCP personnalisé sur grok.com, pour rechercher des contacts, envoyer des SMS et consulter vos appels depuis la conversation.

Installez **Allo for Grok Bot**, le plugin officiel, et utilisez Allo depuis Grok Bot. Vous vous connectez à Allo. Un connecteur personnalisé sur grok.com est l'alternative, [plus bas](#ajouter-un-connecteur-personnalisé-sur-grok-com).

**Plan Allo :** Business ou Ultra. Voir [Plans et tarifs](https://help.withallo.com/fr/billing/plans-and-pricing.md).

Allo n'est pas dans le catalogue de connecteurs de grok.com. Ce catalogue couvre des services comme Notion, GitHub et Linear. La fiche officielle est le plugin Grok Bot ci-dessous.

## Installer Allo for Grok Bot

Le plugin s'appelle **Allo for Grok Bot**. La fiche est ici : [Allo for Grok Bot](https://x.ai/bot/plugin/71839858).

**1. Ajouter le plugin**

Sur la fiche, cliquez sur **Add to Grok Bot**.

Vous pouvez aussi ouvrir **Connect apps** dans Grok Bot et ajouter Allo. Dans le chat de Grok Bot, cette commande fait la même chose :

```text theme={null}
/add-plugin allo
```

**2. Se connecter à Allo**

Connectez-vous à Allo et autorisez l'accès. Il n'y a pas de clé API à copier. La première fois que le bot utilise Allo, il vous demande de vous connecter si ce n'est pas déjà fait.

Allo ne voit jamais votre mot de passe Grok.

Le plugin lit les appels et les SMS avec vos permissions Allo. Il demande confirmation avant qu'un SMS parte chez un client. Il ne peut pas passer d'appel. Les numéros que vous ajoutez vont dans le Power Dialer, et vous démarrez la session dans Allo. Une modification de call flow reste un brouillon tant que vous ne la publiez pas dans Allo.

Il ajoute trois commandes : `/allo-briefing`, `/allo-followups` et `/allo-report`. La [page du serveur MCP](https://help.withallo.com/fr/integrations/mcp.md#cursor) explique chacune.

La page Allo de ce plugin est [Allo for Grok Bot](https://www.withallo.com/fr/integrations/grok-bot).

## Ajouter un connecteur personnalisé sur grok.com

Utilisez ce chemin quand vous êtes sur grok.com et que vous voulez le serveur MCP Allo directement. Grok se connecte à `https://mcp.withallo.com/mcp`. Cette adresse est publique, ce que Grok exige.

Pour passer vous-même une clé API Allo, utilisez l'[API Grok ou le CLI Grok](#api-grok-ou-cli).

Les connecteurs sont disponibles pour tous les utilisateurs de Grok. Sur **Grok Business et Enterprise**, un admin d'équipe ajoute le connecteur dans la [console xAI](https://docs.x.ai/grok/connector-management) avant que les coéquipiers puissent le connecter. Ajouter ou retirer un connecteur demande la permission Team Read-Write. Cette permission est en général celle d'un admin d'équipe.

Ces étapes suivent le guide xAI, [Connectors](https://docs.x.ai/grok/connectors).

**1. Ouvrir les connecteurs**

Allez sur [grok.com/connectors](https://grok.com/connectors).

**2. Ajouter un connecteur personnalisé**

Cliquez sur **New Connector**, puis sélectionnez **Custom**.

**3. Saisir le serveur Allo**

Saisissez cette URL de serveur MCP :

`https://mcp.withallo.com/mcp`

**4. S'authentifier**

Terminez l'authentification que Grok affiche.

Quand Grok ouvre Allo, connectez-vous et approuvez les permissions. Allo ne voit jamais votre mot de passe Grok. Vous pouvez retirer le connecteur plus tard dans Grok.

Si Grok demande une clé API au lieu d'une connexion, créez-en une avec les étapes de la section API ci-dessous. Collez la clé seule, ou `Api-Key` suivi de la clé.

> [!NOTE]
>
> Sur Grok Business et Enterprise, un admin d'équipe prépare Allo d'abord. Connectez-vous sur [console.x.ai](https://console.x.ai), sélectionnez l'équipe et allez dans **Grok Business → Connectors**. Cliquez sur **+ Add Connector**, sélectionnez **Other**, saisissez `https://mcp.withallo.com/mcp`, et terminez l'authentification. Les coéquipiers connectent ensuite leur propre compte sur [grok.com/connectors](https://grok.com/connectors).

## Essayez un de ces prompts

Copiez un prompt dans Grok une fois Allo connecté. Adaptez les noms, les numéros et les dates à votre équipe.

> [card] Appels manqués
>
> `Montre-moi tous les appels manqués de cette semaine`

> [card] Manager
>
> `Quel était le taux de réponse de mon équipe le mois dernier comparé au mois précédent ?`

> [card] Relance
>
> `Envoie un SMS au +33612345678 depuis mon numéro principal pour dire qu'on rappelle dans 10 minutes`

> [card] Ops
>
> `Liste les contacts qui ont appelé 3+ fois la semaine dernière sans owner`

## Ce que vous pouvez faire

Une fois connecté, Grok peut utiliser les outils Allo autorisés pour votre compte : rechercher des appels, lire des transcriptions, envoyer des SMS, gérer des contacts et des tags, et consulter les analyses d'équipe.

> [card] [Voir la liste complète des outils](https://help.withallo.com/fr/integrations/mcp.md#outils-disponibles)
>
> Chaque outil du MCP Allo, avec le scope dont il a besoin.

## API Grok ou CLI

L'API Grok et le CLI `grok` peuvent appeler Allo avec une clé API Allo. xAI documente les deux. Allo for Grok Bot vous connecte avec votre compte. L'écran de connecteur personnalisé sur grok.com ne nomme pas de champ pour une clé API.

**1. Créer 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é. Allo ne l'affiche qu'une fois.

**2. Appeler Allo depuis l'API**

Ajoutez un outil MCP distant. Placez la clé dans `headers`. Dans le SDK xAI, le même objet s'appelle `extra_headers`.

```json theme={null}
{
  "type": "mcp",
  "server_url": "https://mcp.withallo.com/mcp",
  "server_label": "allo",
  "headers": {
    "Authorization": "Api-Key YOUR_API_KEY"
  }
}
```

Laissez `allowed_tools` vide pour exposer chaque outil, ou listez des noms d'outils pour limiter ce que Grok peut appeler. xAI prend en charge Streaming HTTP et SSE pour cet outil.

**3. Ou ajouter Allo dans le CLI Grok**

Le CLI `grok` peut enregistrer le header pour vous :

```bash theme={null}
grok mcp add --transport http Allo https://mcp.withallo.com/mcp \
  --header "Authorization: Api-Key YOUR_API_KEY"
```

`grok mcp list` affiche le serveur. `grok mcp doctor Allo` vérifie la connexion.

> [!WARNING]
>
> Seuls les **administrateurs** et les **propriétaires** peuvent créer des clés API.
>
> Ne placez pas la clé API Allo dans le champ `authorization`. xAI envoie cette valeur sous la forme `Authorization: Bearer ...`. Allo lit une valeur `Bearer` comme un jeton de session, et la requête renvoie `401`. Utilisez `headers` ou `extra_headers`, avec `Api-Key` ou la clé seule.

Référence : [Remote MCP tools](https://docs.x.ai/developers/tools/remote-mcp) et [MCP servers dans le CLI Grok](https://docs.x.ai/build/features/mcp-servers). Les noms de scopes sont sur la [page du serveur MCP](https://help.withallo.com/fr/integrations/mcp.md#scopes-requis).

Le même plugin Cursor fonctionne aussi dans Grok Bot. La mise en place de ce plugin est sur la [page du serveur MCP](https://help.withallo.com/fr/integrations/mcp.md#cursor).

## Troubleshooting

> [accordion] Le connecteur manque sur une équipe Business ou Enterprise
>
> Un admin d'équipe doit l'ajouter dans la console xAI avant que les membres puissent se connecter. L'admin a besoin de la permission Team Read-Write. Une fois le connecteur listé, chaque personne connecte son propre compte sur grok.com/connectors.

> [accordion] Grok refuse l'URL du serveur
>
> Utilisez `https://mcp.withallo.com/mcp`. Grok refuse localhost et les adresses de réseau privé. Cette URL Allo est déjà publique, Grok peut l'atteindre directement.

> [accordion] La connexion ou la clé API a échoué
>
> Sur grok.com, terminez la connexion Allo avec un compte Allo actif. Sur l'API ou le CLI, envoyez la clé sous la forme `Api-Key YOUR_API_KEY` ou la clé seule. Un préfixe `Bearer` est un jeton de session, et Allo renvoie `401`.

> [accordion] Les outils ne s'affichent pas
>
> Retirez le connecteur dans Grok et ajoutez-le à nouveau avec la même URL. Sur le CLI, lancez `grok mcp doctor Allo`, puis démarrez une nouvelle session.

## Vous utilisez un autre assistant ?

> [card] [Connecteur Claude](https://help.withallo.com/fr/integrations/claude-connector.md)
>
> Ajoutez Allo dans Claude.ai. Vous vous connectez à Allo, avec un Client ID sur cet écran.

> [card] [Connecteur ChatGPT](https://help.withallo.com/fr/integrations/chatgpt-connector.md)
>
> Ajoutez Allo dans ChatGPT sur le web. Vous vous connectez à Allo.

> [card] [Autres clients MCP](https://help.withallo.com/fr/integrations/mcp.md)
>
> Cursor, Claude Code, VS Code, et tout client qui prend une clé API.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.