Connecter des clients IA

Le serveur Ciele MCP 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 serveur local est un processus stdio que le client lance en tant que processus enfant.

Privilégiez le point de terminaison hébergé. Il ne nécessite ni extraction, ni Node.js sur la machine client, ni chemin d'accès à tenir à 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é

Connectez-vous au point de terminaison hébergé

1. Créez une clé API de visionneuse.
2. Fournissez au client l'URL du point de terminaison de votre déploiement.
3. Configurez l'en-tête Authorization comme suit : Bearer <key>.

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

Le point de terminaison hébergé ne dispose pas d'un commutateur en lecture seule : ses autorisations sont définies par le rôle 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, ce qui lui permet d'épingler une conversation, de laisser des commentaires et de la supprimer. Utilisez un serveur stdio local avec CIELE_MCP_READ_ONLY=1 lorsque l'agent ne doit absolument rien modifier.

Préparez 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 de visionneuse.
4. Résolvez 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'origine de l'exemple 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 quatorze outils.

Consultez le guide MCP de Claude Code pour connaître les options client et les étendues 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 guide Codex MCP pour connaître les paramètres actuels du client.

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 guide MCP de Cursor 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 connaître le schéma de la version 2 actuelle.

GitHub Copilot dans VS Code

Créez .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. Lancez ciele et examinez sa sortie en cas d'échec de la connexion.

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

Interface de ligne de commande GitHub Copilot

Exécutez la commande interactive /mcp add. Sélectionnez un serveur stdio local 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 guide GitHub Copilot CLI MCP pour connaître le format de configuration actuel.

Prompts copiables

Démarrez chaque nouvelle connexion avec 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 requête 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 requête 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 requête 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 stdio local. 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 Ciele Desktop locale.

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 shell approuvé, ou appelez directement l'API HTTP.