KI-Agenten an kiwiki

Voraussetzungen

Anders als bei lokalen MCP-Servern müssen Agenten, die auf eine entfernte kiwiki-Instanz zugreifen, über eine öffentlich erreichbare HTTPS-Adresse mit gültigem SSL-Zertifikat verbunden werden. Die folgende Checkliste gilt für alle Agenten gleichermaßen:

Claude Desktop unterstützt MCP nativ. Je nachdem, ob deine kiwiki-Instanz öffentlich erreichbar ist oder lokal läuft, gibt es zwei Wege:

Methode 1: Remote via Custom Connector

Für öffentliche HTTPS-Instanzen. Verfügbar auf Pro, Max, Team & Enterprise.

1. Öffne Claude Desktop und gehe zu Settings → Connectors.
2. Klicke auf „Add custom connector".
3. Trage die URL deiner kiwiki-Instanz ein:
   https://deine-domain.example/mcp
4. Sofern dein Server einen API-Key erfordert, hinterlege ihn unter Advanced settings als Bearer Token.
5. Klicke auf „Add" und aktiviere den Connector.

Methode 2: Lokal via Config-Datei (mcp-remote)

Deine kiwiki-Instanz läuft lokal auf http://localhost:8082? claude_desktop_config.json akzeptiert nur stdio-Einträge, keine HTTP-URLs. Die Lösung ist die mcp-remote-Brücke, die stdio in Streamable HTTP übersetzt.

Die Config-Datei befindet sich hier:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Füge folgenden Eintrag ein:

{
  "mcpServers": {
    "kiwiki": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:8082/mcp",
        "--transport",
        "http-only"
      ]
    }
  }
}

Starte Claude Desktop neu. kiwiki erscheint als verbundener MCP-Server — ganz ohne öffentliche HTTPS-Instanz.

Über das Kommandozeilen-Tool claude kannst du kiwiki als MCP-Server hinzufügen:

claude mcp add --transport http kiwiki \
  https://deine-domain.example/mcp \
  --header "Authorization: Bearer DEIN_API_KEY"

Alternativ kannst du den Eintrag auch in der projektspezifischen .mcp.json oder der benutzerweiten ~/.claude/settings.json hinterlegen:

{
  "mcpServers": {
    "kiwiki": {
      "type": "url",
      "url": "https://deine-domain.example/mcp",
      "headers": {
        "Authorization": "Bearer DEIN_API_KEY"
      }
    }
  }
}

Prüfen mit: claude mcp list

ChatGPT unterstützt MCP nativ über den Developer Mode (September 2025). Du kannst kiwiki als MCP-App (ehemals „Connector") direkt in ChatGPT einbinden — ganz ohne OpenAPI-Schema oder Custom GPTs. Voraussetzung ist eine öffentlich erreichbare HTTPS-Instanz.

Methode 1: MCP-App (Developer Mode, empfohlen)

1. Gehe in ChatGPT zu Settings → Apps & Connectors (oder Developer Mode aktivieren unter Advanced).
2. Klicke auf „Create" / „Add".
3. Trage die URL deiner kiwiki-Instanz ein:
   https://deine-domain.example/mcp
4. Wähle als Authentifizierung API Key → Bearer und füge deinen kiwiki-API-Key ein.
5. Klicke auf „Save" und starte einen neuen Chat.

Methode 2: Custom GPT mit OpenAPI-Actions (Alternative)

Die ältere Methode über Custom GPTs und OpenAPI-Schema ist weiterhin möglich, aber weniger leistungsfähig. Da kiwiki auf MCP (JSON-RPC 2.0) basiert, benötigst du ein OpenAPI 3.1-Schema als Brücke. Folge dazu der bisherigen Anleitung:

1. Erstelle ein OpenAPI 3.1-Schema, das die MCP-Tools als REST-Endpunkte abbildet.
2. Lege einen Custom GPT an unter chat.openai.com/gpts.
3. Füge das Schema unter Actions ein und konfiguriere den API-Key.

Erläuterung: MCP und REST unterscheiden sich im Protokoll — nicht alle kiwiki-Tools lassen sich 1:1 als REST-Actions abbilden. Für den vollen Funktionsumfang (20 Tools, bi-direktional) ist die native MCP-App (Methode 1) die bessere Wahl.

Codex CLI unterstützt MCP-Server über Streamable HTTP. Die Konfiguration erfolgt in ~/.codex/config.toml:

# ~/.codex/config.toml
[mcpServers.kiwiki]
type = "url"
url = "https://deine-domain.example/mcp"
headers = { Authorization = "Bearer DEIN_API_KEY" }

Alternativ via Kommandozeile:

codex mcp add kiwiki \
  --transport http \
  https://deine-domain.example/mcp \
  --header "Authorization: Bearer DEIN_API_KEY"

Codex unterstützt sowohl Streamable HTTP als auch SSE-basierte Server. kiwiki verwendet standardmäßig Streamable HTTP.

Cursor unterstützt MCP-Server in den Einstellungen. Navigiere zu:

1. Cursor Settings → Features → MCP Servers.
2. Klicke auf „Add new MCP server".
3. Wähle Type: URL (anstatt Command).
4. Trage als URL ein: https://deine-domain.example/mcp
5. Füge einen Header hinzu: Authorization: Bearer DEIN_API_KEY

Alternativ per .cursor/mcp.json im Projektverzeichnis:

{
  "mcpServers": {
    "kiwiki": {
      "type": "url",
      "url": "https://deine-domain.example/mcp",
      "headers": {
        "Authorization": "Bearer DEIN_API_KEY"
      }
    }
  }
}

OpenCode kann über die opencode.json oder die CLI einen MCP-Server registrieren:

opencode mcp add kiwiki \
  --transport http \
  https://deine-domain.example/mcp \
  --header "Authorization: Bearer DEIN_API_KEY"

Oder via opencode.json im Projektstamm:

{
  "mcpServers": {
    "kiwiki": {
      "type": "url",
      "url": "https://deine-domain.example/mcp",
      "headers": {
        "Authorization": "Bearer DEIN_API_KEY"
      }
    }
  }
}

OpenClaw integriert MCP-Server über seine Konfigurationsdatei. Füge folgenden Eintrag hinzu:

{
  "mcpServers": {
    "kiwiki": {
      "type": "url",
      "url": "https://deine-domain.example/mcp",
      "headers": {
        "Authorization": "Bearer DEIN_API_KEY"
      }
    }
  }
}

Alternativ über die CLI: openclaw mcp add kiwiki --url https://deine-domain.example/mcp --api-key DEIN_API_KEY

Hermes Agents können über die hermes-spezifische MCP-Konfiguration angebunden werden:

hermes mcp add kiwiki \
  https://deine-domain.example/mcp \
  --api-key DEIN_API_KEY

Die genaue Konfiguration kann je nach Hermes-Variante (Desktop, CLI, Agent-Framework) variieren. Konsultiere ggf. die Dokumentation deiner Hermes-Instanz.

Config-Referenz

Eine universelle JSON-Vorlage, die für die meisten MCP-Clients funktioniert:

{
  "mcpServers": {
    "kiwiki": {
      "type": "url",
      "url": "https://deine-domain.example/mcp",
      "headers": {
        "Authorization": "Bearer DEIN_API_KEY"
      }
    }
  }
}