MCP-Einrichtungsanleitung

Diese Anleitung führt dich durch die Verbindung deines KI-Assistenten mit dem Pipe2.ai-MCP-Server.

Voraussetzungen

• Ein Pipe2.ai-Konto mit Credits
• Ein persönliches Zugriffstoken (PAT) — siehe Authentifizierung

Claude Desktop

1. Generiere ein persönliches Zugriffstoken in deinem Pipe2.ai-Dashboard unter Einstellungen > API-Schlüssel > Persönliche Zugriffstoken.

2. Füge den MCP-Server hinzu über die CLI:

   claude mcp add pipe2ai -- \
     https://mcp.pipe2.ai/mcp \
     --header "Authorization: Bearer YOUR_TOKEN"

   Oder füge ihn manuell zu deiner Claude-Desktop-Konfigurationsdatei hinzu:

   macOS

   // ~/Library/Application Support/Claude/claude_desktop_config.json
   {
     "mcpServers": {
       "pipe2ai": {
         "url": "https://mcp.pipe2.ai/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_TOKEN"
         }
       }
     }
   }

   Windows

   %APPDATA%\Claude\claude_desktop_config.json

   {
     "mcpServers": {
       "pipe2ai": {
         "url": "https://mcp.pipe2.ai/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_TOKEN"
         }
       }
     }
   }

   Linux

   ~/.config/claude/claude_desktop_config.json

   {
     "mcpServers": {
       "pipe2ai": {
         "url": "https://mcp.pipe2.ai/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_TOKEN"
         }
       }
     }
   }

3. Starte Claude Desktop neu, um die neue Konfiguration zu übernehmen.

4. Überprüfe die Verbindung, indem du Claude fragst: “Liste meine verfügbaren Pipe2.ai-Pipelines auf.”

Claude Code (CLI)

1. Füge den Server hinzu über die CLI:

   claude mcp add pipe2ai \
     --transport http \
     --url https://mcp.pipe2.ai/mcp \
     --header "Authorization: Bearer YOUR_TOKEN"

2. Starte eine Sitzung und bitte Claude Code, mit deinen Pipelines zu interagieren:

   claude "List all available Pipe2.ai pipelines"

Cursor

1. Öffne die Cursor-Einstellungen (Cmd/Ctrl + Shift + P > “Cursor Settings”).

2. Navigiere zum MCP-Abschnitt.

3. Füge einen neuen MCP-Server hinzu mit diesen Einstellungen:

   • Name: pipe2ai
   • URL: https://mcp.pipe2.ai/mcp
   • Headers: Authorization: Bearer YOUR_TOKEN

4. Starte Cursor neu und nutze die Pipe2.ai-Tools in deinem KI-Chat.

Andere MCP-Clients

Jeder MCP-kompatible Client kann sich mit Pipe2.ai verbinden. Die wichtigste Konfiguration:

Einstellung	Wert
Server-URL	https://mcp.pipe2.ai/mcp
Transport	Streamable HTTP (bevorzugt) oder SSE (https://mcp.pipe2.ai/sse/)
Auth-Header	Authorization: Bearer YOUR_TOKEN

Hinweis

Für den OAuth-2.1-Flow anstelle persönlicher Zugriffstoken siehe die Seite Authentifizierung. OAuth wird für Clients unterstützt, die die MCP-OAuth-Spezifikation implementieren.

Deine Verbindung überprüfen

Sobald du verbunden bist, probiere diese Befehle mit deinem KI-Assistenten:

1. “List available pipelines” — sollte alle aktiven Pipelines mit Beschreibungen zurückgeben
2. “Check my credit balance” — sollte deine aktuellen Credits anzeigen
3. “Show my recent assets” — sollte deine generierten Bilder und Videos auflisten

Falls eines davon fehlschlägt, überprüfe dein Token und die Netzwerkverbindung. Siehe Authentifizierung zur Behebung von Token-Problemen.