KI-Clients verbinden

Der Ciele MCP-Server verfügt über zwei Transports. Beide registrieren dieselben Tools.

• Der hosted endpoint ist POST /api/mcp in Ihrer Bereitstellung. Jeder Client, der eine Remote-MCP-URL akzeptiert, kann ihn verwenden.
• Der local server ist ein stdio-Prozess, den der Client als untergeordneten Prozess startet.

Bevorzugen Sie den hosted endpoint. Es sind weder ein Checkout noch Node.js auf dem Client-Rechner erforderlich, und es muss kein Pfad aktuell gehalten werden.

Diese Seite gibt die am 6. August 2026 geprüfte Client-Dokumentation wieder. Client-Schnittstellen und Konfigurationsformate können sich ändern.

Kompatibilität

Verbindung zum gehosteten Endpoint herstellen

1. Erstellen Sie einen Viewer-API key.
2. Geben Sie dem Client die Endpoint-URL für Ihre Bereitstellung.
3. Konfigurieren Sie den Authorization-Header als Bearer <key>.

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

Die Berechtigungen des gehosteten Endpunkts entsprechen der Role des Schlüssels. Ein Viewer-Schlüssel ist jedoch kein reiner Read-only-Agent. Das Überprüfen von Konversationen zählt als Kuration, daher kann ein Viewer-Schlüssel eine Konversation anheften, Feedback hinterlassen und eine Konversation löschen. Eine selbst gehostete Bereitstellung kann CIELE_MCP_READ_ONLY=1 so konfigurieren, dass jede Mutation für jeden Schlüssel abgelehnt wird. Für einen Agenten, der nichts ändern darf, verwenden Sie einen lokalen stdio-Server mit CIELE_MCP_READ_ONLY=1.

Eine lokale Verbindung vorbereiten

1. Installieren Sie Node.js 22.6 oder eine höhere Version.
2. Klonen Sie das Ciele-Repository.
3. Erstellen Sie einen Viewer-API key.
4. Ermitteln Sie den absoluten Pfad zu packages/mcp/bin/ciele-mcp.mjs.
5. Legen Sie CIELE_MCP_READ_ONLY=1 für die erste Verbindung fest.

Ersetzen Sie <repo> und den Beispiel-Origin in jeder Konfiguration.

Claude Code

Führen Sie diesen Befehl aus:

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

Öffnen Sie /mcp in Claude Code. Überprüfen Sie, ob der ciele-Server siebzehn Tools anzeigt.

Informationen zu Client-Optionen und Konfigurationsbereichen finden Sie im Claude Code MCP guide.

Codex und ChatGPT Desktop

Führen Sie diesen Befehl für die Codex CLI aus:

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, die Codex-App, die Codex-IDE-Erweiterung und ChatGPT Desktop verwenden dieselbe Codex-MCP-Konfiguration.

Sie können auch ~/.codex/config.toml bearbeiten:

[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"

Führen Sie codex mcp list aus oder öffnen Sie /mcp, um die Verbindung zu prüfen.

Siehe den Codex MCP guide für die aktuellen Client-Einstellungen.

Cursor

Erstellen Sie .cursor/mcp.json in einem Projekt. Sie können auch die globale Cursor-Konfiguration verwenden.

{
  "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"
      }
    }
  }
}

Öffnen Sie Settings > MCP. Aktivieren Sie ciele und überprüfen Sie jeden angeforderten Tool-Aufruf.

Siehe den Cursor MCP guide für Informationen zur globalen Konfiguration und zur Sicherheit des Clients.

OpenCode

Fügen Sie diesen Server zu opencode.json hinzu:

{
  "$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"
        }
      }
    }
  }
}

Führen Sie opencode2 mcp list aus, um die Verbindung zu prüfen.

Siehe den OpenCode MCP guide für das aktuelle Schema der Version 2.

GitHub Copilot in VS Code

.vscode/mcp.json erstellen:

{
  "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"
      }
    }
  }
}

Führen Sie MCP: List Servers über die Command Palette aus. Starten Sie ciele und prüfen Sie die Ausgabe, wenn eine Verbindung fehlschlägt.

Siehe den VS Code MCP guide für Informationen zu Konfigurationsspeicherorten und Trust Controls.

GitHub Copilot CLI

Führen Sie den interaktiven Befehl /mcp add aus. Wählen Sie einen lokalen stdio Server aus und geben Sie den Ciele-Befehl ein.

Sie können auch mit diesem Befehl beginnen:

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

Fügen Sie die drei Ciele-Umgebungsvariablen über die Copilot-MCP-Konfiguration hinzu. Fügen Sie den API-Schlüssel nicht in das Versionskontrollsystem ein.

Informationen zum aktuellen Konfigurationsformat finden Sie im GitHub Copilot CLI MCP guide.

Kopierbare Prompts

Beginnen Sie jede neue Verbindung mit dieser schreibgeschützten Prüfung:

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

Verwenden Sie diesen Prompt, um Assistants zu überprüfen:

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

Verwenden Sie diesen Prompt, um die Knowledge-Erfassung zu überprüfen:

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.

Verwenden Sie diesen Prompt, nachdem Sie den Schreibzugriff aktiviert haben:

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.

Verwenden Sie diesen Prompt vor der Veröffentlichung:

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

Clients ohne lokalen Prozess

ChatGPT Web kann keinen lokalen stdio Server starten. Richten Sie es stattdessen auf den gehosteten Endpoint. Die Bereitstellung muss über das öffentliche Internet erreichbar sein, was bei einem lokalen Ciele Desktop-Stack nicht der Fall ist.

Pi enthält kein integriertes MCP-Verbindungsverfahren. Pi-Erweiterungen können MCP-Unterstützung hinzufügen, aber Ciele liefert eine solche Erweiterung weder aus noch testet sie. Verwenden Sie ciele ... --json über einen genehmigten Shell-Workflow oder rufen Sie die HTTP API direkt auf.