Codefluss Logo

Schnellstart

Schnellstart

In 5 Minuten zum ersten MCP-Call. Diese Anleitung führt dich durch die Einrichtung des CODEFLUSS MCP Servers.

Voraussetzungen

  • Ein CODEFLUSS Account
  • Claude Desktop, Cursor oder ein anderer MCP-kompatibler Client
  • Mindestens ein Projekt in deinem CODEFLUSS Workspace

Schritt 1: API-Key erstellen

  1. Öffne das CODEFLUSS Dashboard unter app.codefluss.io
  2. Navigiere zu Einstellungen → API Keys
  3. Klicke auf Neuen API-Key erstellen
  4. Vergib einen Namen (z.B. "Claude Desktop")
  5. Kopiere den generierten Key - er wird nur einmal angezeigt!
cf_live_sk_1234567890abcdef...

Hinweis: API-Keys beginnen mit cf_live_ für Production und cf_test_ für Staging-Umgebungen.

Schritt 2: Client konfigurieren

Claude Desktop

Öffne die Claude Desktop Konfigurationsdatei:

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

Füge die CODEFLUSS MCP Server Konfiguration hinzu:

{ "mcpServers": { "codefluss": { "command": "npx", "args": ["-y", "@codefluss/mcp-client"], "env": { "CODEFLUSS_API_KEY": "cf_live_sk_dein_api_key_hier", "CODEFLUSS_ENDPOINT": "https://app.codefluss.io/api/mcp" } } } }

Starte Claude Desktop neu, um die Konfiguration zu laden.

Cursor

In Cursor kannst du MCP Server über die Einstellungen hinzufügen:

  1. Öffne Settings → MCP Servers
  2. Klicke auf Add Server
  3. Konfiguriere wie folgt:
{ "name": "codefluss", "transport": "http", "url": "https://app.codefluss.io/api/mcp", "headers": { "Authorization": "Bearer cf_live_sk_dein_api_key_hier" } }

Schritt 3: Ersten Befehl testen

Sobald der Client konfiguriert ist, kannst du den MCP Server testen.

Im AI-Client

Frage einfach in natürlicher Sprache:

"Zeige mir alle meine CODEFLUSS Projekte"

Der AI-Assistent wird automatisch das list_projects Tool aufrufen.

Direkter API-Test mit cURL

Du kannst den Endpoint auch direkt testen:

curl -X POST https://app.codefluss.io/api/mcp \ -H "Content-Type: application/json" \ -H "Authorization: Bearer cf_live_sk_dein_api_key_hier" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "list_projects", "arguments": {} } }'

Erwartete Response

{ "jsonrpc": "2.0", "id": 1, "result": { "content": [ { "type": "text", "text": "[{\"id\": \"proj_abc123\", \"name\": \"Meine Website\", \"createdAt\": \"2026-01-15T10:30:00Z\"}]" } ] } }

Weitere Beispiele

Projekt-Details abrufen

{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "get_project", "arguments": { "projectId": "proj_abc123" } } }

Design System Farben auslesen

{ "jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": { "name": "get_color_palette", "arguments": { "projectId": "proj_abc123" } } }

Verfügbare Tools auflisten

{ "jsonrpc": "2.0", "id": 4, "method": "tools/list", "params": {} }

Fehlerbehebung

"Authentication failed"

  • Überprüfe, ob der API-Key korrekt kopiert wurde
  • Stelle sicher, dass der Key nicht abgelaufen ist
  • Prüfe, ob cf_live_ (Production) oder cf_test_ (Staging) korrekt ist

"Method not found"

  • Prüfe die Schreibweise des Method-Namens
  • Nutze tools/list um verfügbare Tools zu sehen

Client verbindet nicht

  • Starte den Client nach Konfigurationsänderungen neu
  • Überprüfe die JSON-Syntax der Konfigurationsdatei
  • Stelle sicher, dass die URL korrekt ist: https://app.codefluss.io/api/mcp

Nächste Schritte