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

# Connexion par client

> Configurer Cursor, Claude Desktop, Claude Code et VS Code pour utiliser le serveur MCP de Bookivox.

Le serveur MCP de Bookivox se connecte de la même façon depuis tous les clients : un **endpoint Streamable HTTP** et un **en-tête `X-API-Key`**.

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

> [!TIP]
>
> Remplacez `bookeys_xxxxxxxx` par une clé API créée depuis **Workspace → Clés API**. Utilisez une clé dédiée à l'intégration IA.

**Cursor**

Ajoutez le serveur dans le fichier de configuration MCP de Cursor
(`~/.cursor/mcp.json` ou le panneau **MCP** des réglages) :

```json theme={null}
{
  "mcpServers": {
    "bookivox": {
      "url": "https://mcp.bookivox.com/",
      "headers": { "X-API-Key": "bookeys_xxxxxxxx" }
    }
  }
}
```

**Claude Desktop**

Ajoutez le serveur dans le fichier de configuration de Claude Desktop
(`claude_desktop_config.json`) puis redémarrez l'application :

```json theme={null}
{
  "mcpServers": {
    "bookivox": {
      "url": "https://mcp.bookivox.com/",
      "headers": { "X-API-Key": "bookeys_xxxxxxxx" }
    }
  }
}
```

**Claude Code**

Enregistrez le serveur avec la commande MCP de Claude Code :

```bash theme={null}
claude mcp add --transport http bookivox https://mcp.bookivox.com/ \
  --header "X-API-Key: bookeys_xxxxxxxx"
```

**VS Code**

Ajoutez le serveur dans `.vscode/mcp.json` de votre espace de travail :

```json theme={null}
{
  "servers": {
    "bookivox": {
      "type": "http",
      "url": "https://mcp.bookivox.com/",
      "headers": { "X-API-Key": "bookeys_xxxxxxxx" }
    }
  }
}
```

## Vérifier la connexion

Après configuration, demandez à votre assistant de **lister les outils** Bookivox. Vous devez voir les outils de types de nœuds, de workflows et de documents. Si la liste est vide, vérifiez l'en-tête `X-API-Key` et que la clé est bien active.

> **[Outils exposés](https://docs.bookivox.com/mcp/tools.md)**
>
> Détail des outils disponibles.

> **[Clés API](https://docs.bookivox.com/workspace/api-keys.md)**
>
> Créer et gérer vos clés.


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