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

# Serveur MCP

> Connectez vos agents IA (Claude, Cursor, VS Code) au serveur MCP de Bookivox pour créer et piloter vos agents vocaux par conversation.

Le **Model Context Protocol** (MCP) est un standard qui permet à un assistant IA (Claude, Cursor, VS Code) d'utiliser des **outils externes**. Le serveur MCP de Bookivox expose les capacités de la plateforme à votre outil d'IA : créer des agents, explorer les types de nœuds, publier, rechercher dans vos documents.

> **[Connexion par client](https://docs.bookivox.com/mcp/clients.md)**
>
> Configurer Cursor, Claude, VS Code en quelques lignes.

> **[Outils exposés](https://docs.bookivox.com/mcp/tools.md)**
>
> Ce que l'agent IA peut lire et modifier.

## Points de connexion

| Élément | Valeur |
| - | - |
| **Endpoint** | `https://mcp.bookivox.com/` |
| **Transport** | Streamable HTTP |
| **Authentification** | En-tête `X-API-Key` |

> [!NOTE]
>
> Le serveur MCP réutilise vos **clés API**. Créez une clé dédiée à l'intégration IA, distincte de vos clés applicatives ([Clés API](https://docs.bookivox.com/workspace/api-keys.md)).

## Comment ça marche

**1. Créer une clé API**

Dans **Clés API**, créez une clé. Elle n'est affichée qu'une seule fois : copiez-la immédiatement.

**2. Déclarer le serveur MCP**

Dans votre client IA, ajoutez le serveur MCP avec l'endpoint et l'en-tête `X-API-Key`.

**3. Vérifier la connexion**

Listez les outils disponibles : vous devez voir les outils Bookivox (types de nœuds, workflows, documents).

## Parcours guidé en trois temps

Le serveur MCP oriente l'agent IA selon un parcours structuré :

**1. Plan (planifier)**

L'agent clarifie l'objectif, liste les types de nœuds et choisit la structure du workflow.

**2. Create (créer)**

L'agent construit le workflow (nœuds et arêtes) puis l'enregistre.

**3. Review (vérifier)**

L'agent vérifie le workflow, le publie et le teste.

> [!NOTE]
>
> Un agent créé via MCP aboutit à un agent Bookivox standard, éditable dans le canevas.

## Sécurité

> [!WARNING]
>
> * Une clé API MCP donne accès à la **création et la publication d'agents** : traitez-la comme un **secret**.
> * Utilisez le **moindre privilège** : une clé dédiée aux intégrations IA, distincte de vos clés applicatives.
> * Ne collez **jamais** une clé API dans un contenu que l'agent IA lit (document, page web) : risque d'exfiltration.
> * Le serveur MCP est en **lecture/écriture** sur vos ressources : surveillez les actions et révoquez la clé dès qu'elle n'est plus utile.


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