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

Servidor MCP de Spaceship AI

Servidor MCP para Spaceship AI: crea, ejecuta y gestiona agentes de IA directamente desde Claude Code, Cursor, VS Code y Windsurf.

Inicio rápido

¿No quieres configurar manualmente tu servidor MCP?

Ejecuta spaceshipai@latest init para configurar todo automáticamente con un solo comando:

npx spaceshipai@latest init

Esto funciona con Claude Code, Cursor, VS Code y Windsurf. Se autenticará a través de tu navegador, creará una clave de API de Spaceship para ti y configurará tu editor automáticamente.

Instalación manual

Si prefieres configurar manualmente, añade lo siguiente al archivo de configuración MCP de tu IDE.

Claude Code — ejecuta en tu terminal:

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

O añade a ~/.claude.json:

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

Cursor — añade a ~/.cursor/mcp.json:

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

VS Code — añade a ~/.vscode/mcp.json:

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

Windsurf — añade a ~/.codeium/windsurf/mcp_config.json:

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

Obtén tu clave de API en spaceshipai.io en Settings → API Keys.

Herramientas

Proyectos

Herramienta	Descripción
`list_projects`	Lista todos los proyectos de tu organización

Agentes

Herramienta	Descripción
`list_agents`	Lista los agentes, opcionalmente filtrados por proyecto
`get_agent`	Obtiene los detalles completos de un solo agente, incluyendo su prompt del sistema y herramientas
`create_agent`	Crea un agente: pasa `description` para un prompt del sistema generado automáticamente
`update_agent`	Actualiza el nombre, prompt o herramientas; vuelve a estructurar pasando una nueva `description`
`delete_agent`	Elimina permanentemente un agente y todos sus registros, memorias e hilos

Ejecución de agentes

Herramienta	Descripción
`run_agent`	Inicia una ejecución asíncrona; devuelve `execution_id` para sondeo
`get_run_status`	Estado de sondeo: `queued` → `running` → `completed` / `error` / `cancelled`
`get_run_logs`	Obtiene el registro de eventos cronológico completo para una ejecución completada
`list_executions`	Lista las ejecuciones recientes de un agente con estado y duración
`test_agent`	Prueba de sincronización rápida: ejecuta un agente y espera hasta 15s por el resultado

Orquestaciones

Herramienta	Descripción
`list_orchestrations`	Lista las orquestaciones, opcionalmente filtradas por proyecto
`get_orchestration`	Obtiene los detalles completos de una orquestación, incluyendo sus miembros y herramientas
`run_orchestration`	Inicia una ejecución de orquestación asíncrona; devuelve `execution_id`
`test_orchestration`	Prueba de sincronización rápida: ejecuta una orquestación y espera hasta 15s por el resultado

Herramientas

Herramienta	Descripción
`list_tools`	Lista las herramientas integradas y personalizadas disponibles para adjuntar a los agentes

Ejemplos de prompts

Una vez instalado, puedes hablar con tus agentes de forma natural en cualquier IDE compatible:

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.

Configuración

Variable	Requerido	Predeterminado	Descripción
`SPACESHIP_API_KEY`	Sí	—	Tu clave de API (`sk_live_...`)
`SPACESHIP_API_URL`	No	`https://spaceshipai.io`	Sustitución para desarrollo local o staging

Desarrollo

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

Licencia

MIT

Spaceship MCP

Servidor MCP de Spaceship AI

Inicio rápido

Instalación manual

Herramientas

Proyectos

Agentes

Ejecución de agentes

Orquestaciones

Herramientas

Ejemplos de prompts

Configuración

Desarrollo

Licencia

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API