Claude Desktop Integration

Diese Anleitung zeigt, wie du den Codefluss MCP Server mit Claude Desktop verbindest.

Voraussetzungen

Claude Desktop App (Version 1.0 oder höher)
Codefluss API Key (hier erstellen)

Konfigurationsdatei

Die MCP-Konfiguration erfolgt über eine JSON-Datei:

Betriebssystem	Pfad
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

Schritt-für-Schritt Anleitung

Schritt 1: Konfigurationsdatei öffnen

# macOS
open ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Oder erstellen, falls nicht vorhanden
touch ~/Library/Application\ Support/Claude/claude_desktop_config.json

Schritt 2: Codefluss Server hinzufügen

Füge die folgende Konfiguration hinzu:

{
  "mcpServers": {
    "codefluss": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/mcp-client",
        "--transport",
        "http",
        "--url",
        "https://api.codefluss.com/api/mcp"
      ],
      "env": {
        "CODEFLUSS_API_KEY": "cf_live_xxx"
      }
    }
  }
}

Schritt 3: Claude Desktop neu starten

Schließe Claude Desktop vollständig und starte es neu. Der MCP Server sollte nun verfügbar sein.

Alternative: Direkter HTTP Transport

Wenn dein Claude Desktop HTTP Transport direkt unterstützt:

{
  "mcpServers": {
    "codefluss": {
      "transport": "http",
      "url": "https://api.codefluss.com/api/mcp",
      "headers": {
        "Authorization": "Bearer cf_live_xxx"
      }
    }
  }
}

Verbindung testen

Nach dem Neustart kannst du Claude fragen:

"Welche Codefluss-Tools stehen mir zur Verfügung?"

Claude sollte die verfügbaren Tools auflisten:

list_projects - Projekte auflisten
get_project - Projektdetails abrufen
update_component - Komponente bearbeiten
...

Beispiel-Konversation

Du: Liste meine Codefluss-Projekte auf

Claude: Ich rufe das list_projects Tool auf...

Hier sind deine Projekte:
1. Marketing Website (proj_abc) - Zuletzt bearbeitet: heute
2. E-Commerce Shop (proj_def) - Zuletzt bearbeitet: gestern
3. Blog (proj_ghi) - Zuletzt bearbeitet: vor 3 Tagen

Möchtest du eines dieser Projekte öffnen oder bearbeiten?

Mehrere Umgebungen

Du kannst verschiedene Umgebungen konfigurieren:

{
  "mcpServers": {
    "codefluss-prod": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/mcp-client",
        "--transport",
        "http",
        "--url",
        "https://api.codefluss.com/api/mcp"
      ],
      "env": {
        "CODEFLUSS_API_KEY": "cf_live_xxx"
      }
    },
    "codefluss-staging": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/mcp-client",
        "--transport",
        "http",
        "--url",
        "https://staging.api.codefluss.com/api/mcp"
      ],
      "env": {
        "CODEFLUSS_API_KEY": "cf_test_xxx"
      }
    }
  }
}

Troubleshooting

Server erscheint nicht

Konfiguration prüfen: JSON-Syntax validieren

cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python3 -m json.tool
Logs prüfen: Claude Desktop Logs einsehen

# macOS tail -f ~/Library/Logs/Claude/mcp*.log
API Key testen: Direkter API-Aufruf

curl -X POST https://api.codefluss.com/api/mcp \ -H "Content-Type: application/json" \ -H "Authorization: Bearer cf_live_xxx" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

"Tool not found" Fehler

Stelle sicher, dass dein API Key die nötigen Berechtigungen hat
Prüfe, ob dein Codefluss-Plan MCP-Zugriff beinhaltet

Verbindungsfehler

Netzwerkverbindung prüfen
Firewall-Einstellungen kontrollieren
VPN kann Probleme verursachen

Langsame Responses

Der erste Aufruf kann länger dauern (Cold Start)
Bei anhaltenden Problemen: Support kontaktieren

Sicherheitshinweise

API Key schützen: Nie in öffentlichen Repositories committen
Berechtigungen prüfen: Nur nötige Scopes aktivieren
Regelmäßig rotieren: API Keys periodisch erneuern
Audit Log: Zugriffe im Dashboard überwachen

Nächste Schritte

Cursor Integration - Für Cursor IDE Nutzer
Tools Übersicht - Verfügbare Tools erkunden
Custom Clients - Eigene Clients entwickeln