       ███████╗██████╗  █████╗  ██████╗███████╗███████╗██╗  ██╗██╗██████╗    █████╗ ██╗
       ██╔════╝██╔══██╗██╔══██╗██╔════╝██╔════╝██╔════╝██║  ██║██║██╔══██╗  ██╔══██╗██║
       ███████╗██████╔╝███████║██║     █████╗  ███████╗███████║██║██████╔╝  ███████║██║
       ╚════██║██╔═══╝ ██╔══██║██║     ██╔══╝  ╚════██║██╔══██║██║██╔═══╝   ██╔══██║██║
       ███████║██║     ██║  ██║╚██████╗███████╗███████║██║  ██║██║██║       ██║  ██║██║
       ╚══════╝╚═╝     ╚═╝  ╚═╝ ╚═════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝╚═╝       ╚═╝  ╚═╝╚═╝

Spaceship AI MCP-Server

MCP-Server für Spaceship AI — Erstellen, Ausführen und Verwalten von KI-Agenten direkt aus Claude Code, Cursor, VS Code und Windsurf.

Schnellstart

Sie möchten Ihren MCP-Server nicht manuell konfigurieren?

Führen Sie spaceshipai@latest init aus, um alles automatisch mit einem Befehl einzurichten:

npx spaceshipai@latest init

Dies funktioniert mit Claude Code, Cursor, VS Code und Windsurf. Es authentifiziert Sie über Ihren Browser, erstellt einen Spaceship-API-Schlüssel für Sie und konfiguriert Ihren Editor automatisch.

Manuelle Installation

Wenn Sie die manuelle Konfiguration bevorzugen, fügen Sie Folgendes zur MCP-Konfigurationsdatei Ihrer IDE hinzu.

Claude Code — führen Sie dies in Ihrem Terminal aus:

claude mcp add --scope user --transport stdio spaceship --env SPACESHIP_API_KEY=sk_live_... -- uvx spaceship-mcp

Oder fügen Sie es zu ~/.claude.json hinzu:

{
  "mcpServers": {
    "spaceship": {
      "command": "uvx",
      "args": ["spaceship-mcp"],
      "env": {
        "SPACESHIP_API_KEY": "sk_live_..."
      }
    }
  }
}

Cursor — fügen Sie es zu ~/.cursor/mcp.json hinzu:

{
  "mcpServers": {
    "spaceship": {
      "command": "uvx",
      "args": ["spaceship-mcp"],
      "env": {
        "SPACESHIP_API_KEY": "sk_live_..."
      }
    }
  }
}

VS Code — fügen Sie es zu ~/.vscode/mcp.json hinzu:

{
  "servers": {
    "spaceship": {
      "command": "uvx",
      "args": ["spaceship-mcp"],
      "env": {
        "SPACESHIP_API_KEY": "sk_live_..."
      }
    }
  }
}

Windsurf — fügen Sie es zu ~/.codeium/windsurf/mcp_config.json hinzu:

{
  "mcpServers": {
    "spaceship": {
      "command": "uvx",
      "args": ["spaceship-mcp"],
      "env": {
        "SPACESHIP_API_KEY": "sk_live_..."
      }
    }
  }
}

Sie erhalten Ihren API-Schlüssel unter spaceshipai.io unter Settings → API Keys.

Tools

Projekte

Tool	Beschreibung
`list_projects`	Alle Projekte in Ihrer Organisation auflisten

Agenten

Tool	Beschreibung
`list_agents`	Agenten auflisten, optional gefiltert nach Projekt
`get_agent`	Vollständige Details eines einzelnen Agenten abrufen, einschließlich System-Prompt und Tools
`create_agent`	Einen Agenten erstellen — übergeben Sie `description` für einen automatisch generierten System-Prompt
`update_agent`	Name, Prompt oder Tools aktualisieren; durch Übergabe einer neuen `description` neu erstellen
`delete_agent`	Einen Agenten und alle seine Protokolle, Speicher und Threads dauerhaft löschen

Agenten ausführen

Tool	Beschreibung
`run_agent`	Einen asynchronen Lauf starten; gibt `execution_id` für das Polling zurück
`get_run_status`	Status abfragen: `queued` → `running` → `completed` / `error` / `cancelled`
`get_run_logs`	Das vollständige chronologische Ereignisprotokoll für einen abgeschlossenen Lauf abrufen
`list_executions`	Letzte Läufe für einen Agenten mit Status und Dauer auflisten
`test_agent`	Schneller Synchron-Test — führt einen Agenten aus und wartet bis zu 15 Sekunden auf das Ergebnis

Orchestrierungen

Tool	Beschreibung
`list_orchestrations`	Orchestrierungen auflisten, optional gefiltert nach Projekt
`get_orchestration`	Vollständige Details einer Orchestrierung abrufen, einschließlich ihrer Mitglieder und Tools
`run_orchestration`	Einen asynchronen Orchestrierungslauf starten; gibt `execution_id` zurück
`test_orchestration`	Schneller Synchron-Test — führt eine Orchestrierung aus und wartet bis zu 15 Sekunden auf das Ergebnis

Tools

Tool	Beschreibung
`list_tools`	Integrierte und benutzerdefinierte Tools auflisten, die Agenten zugewiesen werden können

Beispiel-Prompts

Nach der Installation können Sie in jeder unterstützten IDE natürlich mit Ihren Agenten sprechen:

List my projects, then show me all agents in the "production" project.

Create an agent called "Support Bot" in project 12 that handles customer refund requests.

Run the "Data Processor" agent with the prompt "Summarize last week's sales data".

Check the status of execution abc-123 for agent xyz-456, then show me the logs.

Test the "Email Classifier" agent with "Is this email spam: win a free iPhone now!"

List my orchestrations in the "production" project, then run the "Data Pipeline" orchestration.

Test the "Research Team" orchestration with input {"topic": "AI safety"} and show me the result.

Konfiguration

Variable	Erforderlich	Standard	Beschreibung
`SPACESHIP_API_KEY`	Ja	—	Ihr API-Schlüssel (`sk_live_...`)
`SPACESHIP_API_URL`	Nein	`https://spaceshipai.io`	Überschreibung für lokale Entwicklung oder Staging

Entwicklung

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest tests/ -v

Lizenz

MIT

Spaceship MCP

Spaceship AI MCP-Server

Schnellstart

Manuelle Installation

Tools

Projekte

Agenten

Agenten ausführen

Orchestrierungen

Tools

Beispiel-Prompts

Konfiguration

Entwicklung

Lizenz

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API