Kairogen MCP

Model Context Protocol-Server für Kairogen. Verbinden Sie Claude, Cursor, ChatGPT (benutzerdefinierte Connectors), Hermes, OpenClaw oder jeden anderen MCP-kompatiblen Agenten und generieren Sie Bilder und Videos mit dem vollständigen Modellkatalog von Kairogen (Seedream, Flux, Nano Banana, GPT Image, Sora, Veo, Kling, Seedance, KairoClone, Topaz).

Die Authentifizierung erfolgt über OAuth 2.0. Es müssen keine API-Schlüssel kopiert oder rotiert werden.

In 30 Sekunden verbinden

Claude.ai (Benutzerdefinierter Connector)

1. Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen

2. URL: https://mcp.kairogen.ai/mcp

3. Auf Verbinden klicken → mit Kairogen anmelden → genehmigen

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "kairogen": {
      "url": "https://mcp.kairogen.ai/mcp"
    }
  }
}

Starten Sie Cursor neu und klicken Sie bei Aufforderung auf Verbinden.

ChatGPT (Benutzerdefinierter Connector)

Einstellungen → Connectors → Neuer benutzerdefinierter Connector → https://mcp.kairogen.ai/mcp einfügen. Melden Sie sich an, wenn ChatGPT dazu auffordert.

Claude Code

claude mcp add --transport http kairogen https://mcp.kairogen.ai/mcp

Das Flag --transport http ist für remote OAuth-geschützte MCP-Server erforderlich. Ohne dieses Flag geht die CLI von stdio aus und versucht, die URL als lokale Binärdatei auszuführen.

Hermes / OpenClaw / NemoClaw (Chat-only Agenten)

Fügen Sie diesen Prompt in den Agenten ein:

Connect the Kairogen MCP at https://mcp.kairogen.ai/mcp. It supports OAuth device flow,
discovery at https://mcp.kairogen.ai/.well-known/oauth-protected-resource. Run the device
flow and reply with: Authorize here: https://app.kairogen.ai/device?code=XXXX-XXXX. Then
poll the token endpoint until I authorize and confirm once it succeeds.

Der Agent antwortet mit einem Link. Öffnen Sie ihn, klicken Sie auf Permitir acesso, und Sie sind verbunden.

Lokales stdio (Claude Desktop, Headless Dev, Offline)

{
  "mcpServers": {
    "kairogen": {
      "command": "npx",
      "args": ["-y", "@kairogen/mcp"]
    }
  }
}

Beim ersten Start führt die CLI den OAuth-Gerätefluss aus, öffnet Ihren Browser und speichert die Token unter ~/.kairogen/tokens.json mit automatischer Aktualisierung. Keine Umgebungsvariablen erforderlich.

Tools

Alle generate_*-Tools unterstützen wait_for_completion: false, um die generation_id sofort zurückzugeben und Ihnen das Abfragen über get_generation zu ermöglichen. Sie senden während der Abfrage alle 5 Sekunden MCP notifications/progress-Heartbeats, sodass Claude Desktop / Cursor usw. eine Live-Fortschrittsanzeige anzeigen und die Verbindung während des Renderns nicht unterbrochen wird.

Konfiguration

Umgebungsvariablen (alle optional, sinnvolle Standardwerte):

Lokale Entwicklung

git clone https://github.com/kairogenai/kairogen-mcp.git
cd kairogen-mcp
npm install
npm run build

# stdio mode (with OAuth device flow on first run):
node dist/stdio.js

# remote HTTP mode (validates Bearer tokens against api.kairogen.ai/.well-known/jwks.json):
PORT=8080 node dist/http.js

Smoke-Test (kein Agent erforderlich):

KAIROGEN_API_KEY=eyJ... node -e "
const init = JSON.stringify({jsonrpc:'2.0',id:1,method:'initialize',params:{protocolVersion:'2025-11-25',capabilities:{},clientInfo:{name:'smoke',version:'0'}}});
const initd = JSON.stringify({jsonrpc:'2.0',method:'notifications/initialized'});
const list = JSON.stringify({jsonrpc:'2.0',id:2,method:'tools/list'});
process.stdout.write(init+'\\n'+initd+'\\n'+list+'\\n');
" | node dist/stdio.js

Bereitstellung (mcp.kairogen.ai)

fly launch --no-deploy --copy-config --name kairogen-mcp
fly secrets set \
  MCP_RESOURCE=https://mcp.kairogen.ai \
  OAUTH_ISSUER=https://api.kairogen.ai \
  OAUTH_AUDIENCE=kairogen-api \
  MCP_AUTH_SERVERS=https://api.kairogen.ai \
  KAIROGEN_API_BASE=https://api.kairogen.ai
fly deploy
fly certs add mcp.kairogen.ai

MCP_AUTH_SERVERS ist erforderlich: Es füllt das Feld authorization_servers in /.well-known/oauth-protected-resource, wodurch MCP-Clients erfahren, wo der OAuth-Fluss ausgeführt werden soll. Durch Kommas getrennt, falls Sie jemals mehrere Aussteller benötigen.

Backend-Umgebungsvariablen, die der OAuth-Aussteller benötigt

Der Auth-Server (kairogen-backend-development) benötigt diese Einstellungen in seiner eigenen Bereitstellungsumgebung:

DNS: Zeigen Sie mit mcp.kairogen.ai (CNAME) auf den Fly-App-Hostnamen.

Architektur

• Frontend (kairogen-frontend-development) hostet die Consent-Bildschirme unter /oauth/consent, /device und /settings/connections.

• Backend (kairogen-backend-development) ist der OAuth-Aussteller. Mountet /.well-known/oauth-authorization-server, /.well-known/jwks.json, /oauth/authorize/approve, /oauth/token, /oauth/device_authorization, /oauth/device/approve, /oauth/connections.

• MCP-Server (dieses Repository) ist ein Resource Server. Validiert vom Backend ausgestellte Bearer-JWTs gegen das veröffentlichte JWKS und leitet dann Tool-Aufrufe mit dem Token des Benutzers an api.kairogen.ai weiter.

Roadmap

• [x] v0.1 stdio + sAccessToken-Einfügen (veraltet)

• [x] v0.2 OAuth-Gerätefluss beim ersten stdio-Start

• [x] v0.3 gehostetes Streamable HTTP unter mcp.kairogen.ai

• [ ] v0.4 Ressourcen (kairogen://models, kairogen://prompt-guide/{model})

• [ ] v0.5 Marketing Studio + Cinema Control-Flüsse als Tools höherer Ebene

Lizenz

MIT