Connecter des clients IA

Le serveur MCP de Ciele dispose de deux transports. Les deux enregistrent les mêmes outils.

• Le hosted endpoint est POST /api/mcp sur votre déploiement. Tout client qui accepte une URL MCP distante peut l’utiliser.
• Le local server est un processus stdio que le client lance en tant que processus enfant.

Privilégiez le hosted endpoint. Il ne nécessite aucun clonage, pas de Node.js sur la machine cliente, et aucun chemin à maintenir à jour.

Cette page reflète la documentation client vérifiée le 6 août 2026. Les interfaces client et les formats de configuration peuvent évoluer.

Compatibilité

Se connecter au point de terminaison hébergé

1. Créez une clé API pour un visualiseur.
2. Communiquez au client l’URL de l’endpoint de votre déploiement.
3. Configurez l’en-tête Authorization comme Bearer <key>.

claude mcp add --transport http ciele https://ciele.example.edu/api/mcp \
  --header "Authorization: Bearer ciele_sk_..."

Les autorisations de l’endpoint hébergé correspondent au Role de la clé. Cependant, une clé Viewer n’est pas un agent en lecture seule. La révision des conversations est considérée comme de la curation ; par conséquent, une clé Viewer peut épingler une conversation, laisser un commentaire et supprimer une conversation. Un déploiement auto-hébergé peut configurer CIELE_MCP_READ_ONLY=1 pour refuser toute mutation pour chaque clé. Pour un agent qui ne doit rien modifier, utilisez un serveur stdio local avec CIELE_MCP_READ_ONLY=1.

Préparer une connexion locale

1. Installez Node.js 22.6 ou une version ultérieure.
2. Clonez le dépôt Ciele.
3. Créez une clé API pour un viewer.
4. Déterminez le chemin absolu vers packages/mcp/bin/ciele-mcp.mjs.
5. Définissez CIELE_MCP_READ_ONLY=1 pour la première connexion.

Remplacez <repo> et l'exemple d'origine dans chaque configuration.

Claude Code

Exécutez cette commande :

claude mcp add ciele \
  --env CIELE_API_KEY=ciele_sk_... \
  --env CIELE_BASE_URL=https://ciele.example.edu \
  --env CIELE_MCP_READ_ONLY=1 \
  -- node <repo>/packages/mcp/bin/ciele-mcp.mjs

Ouvrez /mcp dans Claude Code. Vérifiez que le serveur ciele affiche dix-sept outils.

Consultez le Claude Code MCP guide pour connaître les options client et les portées de configuration.

Codex et ChatGPT pour ordinateur de bureau

Exécutez cette commande pour Codex CLI :

codex mcp add ciele \
  --env CIELE_API_KEY=ciele_sk_... \
  --env CIELE_BASE_URL=https://ciele.example.edu \
  --env CIELE_MCP_READ_ONLY=1 \
  -- node <repo>/packages/mcp/bin/ciele-mcp.mjs

Codex CLI, l’application Codex, l’extension Codex pour IDE et ChatGPT Desktop partagent la même configuration Codex MCP.

Vous pouvez également modifier ~/.codex/config.toml :

[mcp_servers.ciele]
command = "node"
args = ["<repo>/packages/mcp/bin/ciele-mcp.mjs"]
default_tools_approval_mode = "writes"

[mcp_servers.ciele.env]
CIELE_API_KEY = "ciele_sk_..."
CIELE_BASE_URL = "https://ciele.example.edu"
CIELE_MCP_READ_ONLY = "1"

Exécutez codex mcp list ou ouvrez /mcp pour vérifier la connexion.

Consultez le Codex MCP guide pour connaître les paramètres client actuels.

Cursor

Créez .cursor/mcp.json dans un projet. Vous pouvez également utiliser la configuration globale de Cursor.

{
  "mcpServers": {
    "ciele": {
      "command": "node",
      "args": ["<repo>/packages/mcp/bin/ciele-mcp.mjs"],
      "env": {
        "CIELE_API_KEY": "ciele_sk_...",
        "CIELE_BASE_URL": "https://ciele.example.edu",
        "CIELE_MCP_READ_ONLY": "1"
      }
    }
  }
}

Ouvrez Settings > MCP. Activez ciele et examinez chaque appel d’outil demandé.

Consultez le Cursor MCP guide pour obtenir des informations sur la configuration globale et la sécurité du client.

OpenCode

Ajoutez ce serveur à opencode.json :

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "ciele": {
        "type": "local",
        "command": ["node", "<repo>/packages/mcp/bin/ciele-mcp.mjs"],
        "environment": {
          "CIELE_API_KEY": "{env:CIELE_API_KEY}",
          "CIELE_BASE_URL": "https://ciele.example.edu",
          "CIELE_MCP_READ_ONLY": "1"
        }
      }
    }
  }
}

Exécutez opencode2 mcp list pour vérifier la connexion.

Consultez le OpenCode MCP guide pour le schéma de la version 2 actuelle.

GitHub Copilot dans VS Code

Créer .vscode/mcp.json :

{
  "inputs": [
    {
      "id": "ciele-key",
      "type": "promptString",
      "password": true,
      "description": "Ciele API key"
    }
  ],
  "servers": {
    "ciele": {
      "type": "stdio",
      "command": "node",
      "args": ["<repo>/packages/mcp/bin/ciele-mcp.mjs"],
      "env": {
        "CIELE_API_KEY": "${input:ciele-key}",
        "CIELE_BASE_URL": "https://ciele.example.edu",
        "CIELE_MCP_READ_ONLY": "1"
      }
    }
  }
}

Exécutez MCP: List Servers depuis la Palette de commandes. Démarrez ciele et examinez sa sortie lorsqu’une connexion échoue.

Consultez le VS Code MCP guide pour connaître les emplacements de configuration et les contrôles de confiance.

CLI GitHub Copilot

Exécutez la commande interactive /mcp add. Sélectionnez un serveur local stdio et saisissez la commande Ciele.

Vous pouvez également commencer par cette commande :

copilot mcp add ciele -- node <repo>/packages/mcp/bin/ciele-mcp.mjs

Ajoutez les trois variables d’environnement Ciele via la configuration MCP de Copilot. Ne placez pas la clé API dans le contrôle de version.

Consultez le GitHub Copilot CLI MCP guide pour connaître le format de configuration actuel.

Prompts copiables

Commencez chaque nouvelle connexion par cette vérification en lecture seule :

Call ciele_identity. Show the deployment version, available domains,
Organization ID, and Role. Do not change data.

Utilisez cette invite pour examiner les Assistants :

List all Ciele Assistants. For each Assistant, list its enabled Flows.
Identify duplicate or unclear Flow names. Do not change data.

Utilisez cette invite pour examiner l’ingestion de connaissances :

List the Sources linked to Assistant <assistant-id>.
List each Source and its ingestion status.
Report Sources that are not ready. Do not retry or delete a Source.

Utilisez cette invite après avoir activé l’accès en écriture :

Create one FAQ for Assistant <assistant-id>.
Question: "When does enrollment close?"
Answer: "Enrollment closes on <date>."
Show the proposed tool input and ask for approval before the call.

Utilisez cette invite avant la publication :

Read the publication status for Assistant <assistant-id>.
Summarize the current live version. Do not publish or unpublish anything.

Clients sans processus local

ChatGPT web ne peut pas démarrer un serveur local stdio. Dirigez-le plutôt vers le point de terminaison hébergé. Le déploiement doit être accessible depuis l’internet public, ce qui n’est pas le cas d’une pile locale Ciele Desktop.

Pi n’inclut pas de procédure de connexion MCP intégrée. Les extensions Pi peuvent ajouter la prise en charge de MCP, mais Ciele ne fournit ni ne teste une telle extension. Utilisez ciele ... --json via un workflow de shell approuvé, ou appelez directement l’HTTP API.