> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecter un client IA

> Connectez Claude, ChatGPT ou un autre client MCP à votre espace de travail Famulor

Le point de terminaison **Model Context Protocol (MCP)** permet à une application d'IA d'utiliser les mêmes ressources d'espace de travail que celles du tableau de bord — assistants, appels, campagnes, bases de connaissances et plus encore — dans les limites de votre forfait, de votre rôle et des autorisations approuvées.

```text theme={null}
https://app.famulor.io/mcp
```

Sur un domaine en marque blanche, utilisez ce domaine à la place. Les écrans de connexion et de consentement reprennent la même marque. Votre forfait doit inclure **Connect AI / MCP**.

<Note>
  Cette page explique comment connecter un client IA (Claude, ChatGPT et d'autres) *à* Famulor. Vous cherchez plutôt à connecter l'un de vos assistants *vers l'extérieur*, à un serveur MCP externe en cours d'appel — votre propre CRM ou vos outils internes ? Consultez plutôt [Outils et webhooks](/fr/api/tools-and-webhooks#serveurs-mcp-externes).
</Note>

## Connexion des clients

<Tabs>
  <Tab title="Claude">
    1. Ouvrez **Settings → Connectors → Add custom connector**.
    2. Saisissez `https://app.famulor.io/mcp`.
    3. Connectez-vous et approuvez les autorisations demandées.
    4. Les outils approuvés apparaissent dans Claude.
  </Tab>

  <Tab title="ChatGPT">
    1. Ouvrez **Settings → Connectors → Create**.
    2. Saisissez `https://app.famulor.io/mcp` et choisissez **OAuth**.
    3. Connectez-vous et approuvez les autorisations demandées.
  </Tab>

  <Tab title="Autres clients">
    Cursor, Windsurf, VS Code, Cline, Continue, Zed, et tout autre client compatible MCP fonctionnent de la même façon : pointez le client vers le point de terminaison ci-dessus et terminez la connexion OAuth. Pour une intégration serveur à serveur de confiance, vous pouvez à la place envoyer une clé API d'espace de travail comme jeton Bearer — voir [Authentification](#authentification-et-consentement) ci-dessous.
  </Tab>
</Tabs>

### Se connecter depuis Famulor

Choisissez **Connect** dans la barre latérale, ou **Use with ChatGPT & Claude** sur le tableau de bord. La fenêtre affiche l'URL MCP adaptée à votre domaine actuel, vous permet de choisir les groupes d'outils à connecter (voir [Outils et portées](/fr/mcp/tools-and-scopes)), et propose des prompts de démarrage pour les tâches courantes — créer un assistant, diagnostiquer un assistant qui se comporte mal, analyser votre dernier appel, vous améliorer à partir de vos 30 derniers appels, ou lancer une campagne. Le même sélecteur est disponible à tout moment depuis **Settings → API & MCP**.

<Tip>
  Si vous travaillez depuis un agent de code comme Claude Code, Cursor ou Codex, installez le [Famulor Skill](https://github.com/bekservice/Famulor-Skill) open source avec `npx skills add bekservice/Famulor-Skill`. Il embarque la configuration du point de terminaison (ajoutez l'URL manuellement si votre client ne la détecte pas automatiquement), ainsi que des règles de travail spécifiques à Famulor en plus de l'accès MCP brut : lire l'état actuel avant de le modifier, faire confirmer tout ce qui est difficile à annuler, et rester à l'intérieur de l'espace de travail authentifié.
</Tip>

## Authentification et consentement

Les clients compatibles lancent automatiquement la connexion OAuth. L'écran de consentement affiche les groupes d'outils demandés avant tout partage, et votre choix est mémorisé pour les connexions futures. Les connexions approuvées sont répertoriées sous **Settings → API & MCP**, où chacune peut être révoquée à tout moment.

Pour une connexion manuelle ou serveur à serveur, envoyez plutôt une clé API d'espace de travail :

```http theme={null}
Authorization: Bearer fam_...
```

Utilisez les portées les plus restreintes possible. Les portées d'écriture incluent l'accès en lecture correspondant.

## Ce qu'un client connecté peut voir

Par défaut, un client connecté via OAuth (Claude, ChatGPT et similaires) reçoit un ensemble organisé de **7 groupes d'outils** — `assistants`, `calls`, `campaigns`, `knowledge`, `telephony`, `billing` et `settings` — plutôt que le catalogue complet. Il s'agit d'une limite volontaire, et non d'une restriction de forfait : le catalogue complet d'outils de Famulor est vaste, et le charger en une seule fois dépasse ce que ces clients prennent en charge de façon fiable. Sélectionner tous les groupes lors de la configuration vous amène malgré tout à cet ensemble organisé, pour cette même raison.

Pour utiliser moins de groupes, décochez ceux dont vous n'avez pas besoin lors de la connexion, ou modifiez votre sélection à tout moment sous **Settings → API & MCP**. Voir [Outils et portées](/fr/mcp/tools-and-scopes) pour le contenu de chaque groupe.

Si votre intégration a réellement besoin du catalogue complet — les 13 groupes —, connectez-vous avec une clé API d'espace de travail plutôt qu'avec OAuth, et ajoutez `?toolsets=all` à l'URL du point de terminaison. Cette voie est destinée à vos propres scripts et intégrations serveur à serveur, pas à un client IA généraliste.

## Limites de débit

Les requêtes MCP sont soumises à une limite de débit afin de garder la plateforme réactive pour chaque espace de travail :

| Limite                         | Valeur         |
| ------------------------------ | -------------- |
| Requêtes par identifiant       | 120 par minute |
| Requêtes par espace de travail | 600 par minute |
| Taille du corps de requête     | 1 Mo           |

Un client qui dépasse ces limites reçoit une réponse `429` et doit patienter avant de réessayer — voir [Erreurs](/fr/mcp/tools-and-scopes#erreurs).

<Tip>
  Les mêmes fonctionnalités client sont disponibles via l'[API REST](/fr/api-reference/introduction). Choisissez l'interface la mieux adaptée à votre intégration.
</Tip>