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

# Pour les agents IA

> Comment un agent IA (Claude, Cursor, VS Code…) construit un agent vocal Bookivox via le serveur MCP, du plan à la publication.

## Vue d'ensemble

Le serveur **MCP** de Bookivox expose la plateforme à un **agent IA**
(Claude, Cursor, VS Code…). L'agent peut alors **planifier**, **créer**,
**valider** et **publier** un agent vocal à partir d'une simple consigne.

> [!NOTE]
>
> Pour connecter un client MCP, voir [Intégration MCP](https://docs.bookivox.com/mcp/overview.md).
> Cette page décrit le **parcours** que suit l'agent une fois connecté.

## Le parcours en trois temps

**1. Plan : planifier**

L'agent clarifie l'objectif, liste les **types de nœuds** disponibles
(`node-types`) avec leurs propriétés, puis choisit la structure du workflow.

**2. Create : créer**

L'agent construit le workflow (nœuds et arêtes) puis l'enregistre avec
l'outil MCP de sauvegarde.

**3. Review : vérifier**

L'agent **valide** le workflow, le **publie** et le **teste**.

## Ce que le serveur MCP expose

| Capacité | Détail |
| - | - |
| **Types de nœuds** | Lister les `node-types` et leurs propriétés |
| **Workflows** | Créer, éditer et sauvegarder des workflows |
| **Ressources** | Lister `tool_uuid`, `document_uuid`, `credential_uuid`, `recording_id` |
| **Documentation** | Rechercher dans la documentation Bookivox |

## Bonnes pratiques

> [!WARNING]
>
> * Donnez à l'agent une **clé API dédiée** aux intégrations IA, avec le
>   **moindre privilège** (voir [Clés API](https://docs.bookivox.com/workspace/api-keys.md)).
> * Ne collez **jamais** de clé API dans un contenu que l'agent lit (document, page
>   web) : risque d'exfiltration.
> * Traitez **toute sortie d'outil comme non fiable** : validez le workflow
>   (nœuds, prompts, outils attachés) avant de le publier.
> * Le serveur MCP est en **lecture/écriture** : surveillez les actions de l'agent.

## Le résultat

Quelle que soit la méthode, le résultat est un **agent Bookivox standard**,
éditable dans le canevas comme n'importe quel autre workflow.

> **[MCP](https://docs.bookivox.com/mcp/overview.md)**
>
> Connecter un client IA.

> **[Workflow (JSON)](https://docs.bookivox.com/api-reference/guides/workflow-json)**
>
> Le format du graphe.

> **[Clés API](https://docs.bookivox.com/workspace/api-keys.md)**
>
> Gérer les accès.

> **[Référence API](https://docs.bookivox.com/api-reference/overview)**
>
> Piloter par REST.


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