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

Spaceship AI MCPサーバー

Spaceship AI 用のMCPサーバー — Claude Code、Cursor、VS Code、Windsurfから直接AIエージェントを構築、実行、管理できます。

クイックスタート

MCPサーバーを手動で設定したくない場合：

spaceshipai@latest init を実行すると、1つのコマンドですべてを自動的にセットアップできます：

npx spaceshipai@latest init

これはClaude Code、Cursor、VS Code、Windsurfで動作します。ブラウザ経由で認証を行い、Spaceship APIキーを作成し、エディタを自動的に設定します。

手動インストール

手動で設定したい場合は、IDEのMCP設定ファイルに以下を追加してください。

Claude Code — ターミナルで実行：

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

または ~/.claude.json に追加：

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

Cursor — ~/.cursor/mcp.json に追加：

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

VS Code — ~/.vscode/mcp.json に追加：

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

Windsurf — ~/.codeium/windsurf/mcp_config.json に追加：

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

APIキーは spaceshipai.io の Settings → API Keys から取得してください。

ツール

プロジェクト

ツール	説明
`list_projects`	組織内の全プロジェクトを一覧表示

エージェント

ツール	説明
`list_agents`	エージェントを一覧表示（プロジェクトによるフィルタリング可）
`get_agent`	システムプロンプトやツールを含む、単一エージェントの詳細を取得
`create_agent`	エージェントを作成 — `description` を渡すとシステムプロンプトが自動生成されます
`update_agent`	名前、プロンプト、ツールを更新 — 新しい `description` を渡すと再構築されます
`delete_agent`	エージェントとそのログ、メモリ、スレッドを完全に削除

エージェントの実行

ツール	説明
`run_agent`	非同期実行を開始 — ポーリング用の `execution_id` を返します
`get_run_status`	ステータスをポーリング: `queued` → `running` → `completed` / `error` / `cancelled`
`get_run_logs`	完了した実行の完全な時系列イベントログを取得
`list_executions`	ステータスと期間を含む、エージェントの最近の実行を一覧表示
`test_agent`	クイック同期テスト — エージェントを実行し、最大15秒間結果を待ちます

オーケストレーション

ツール	説明
`list_orchestrations`	オーケストレーションを一覧表示（プロジェクトによるフィルタリング可）
`get_orchestration`	メンバーやツールを含む、オーケストレーションの詳細を取得
`run_orchestration`	非同期オーケストレーション実行を開始 — `execution_id` を返します
`test_orchestration`	クイック同期テスト — オーケストレーションを実行し、最大15秒間結果を待ちます

ツール

ツール	説明
`list_tools`	エージェントにアタッチ可能な組み込みツールおよびカスタムツールを一覧表示

プロンプト例

インストール後、サポートされているIDEでエージェントと自然に対話できます：

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.

設定

変数	必須	デフォルト	説明
`SPACESHIP_API_KEY`	はい	—	APIキー (`sk_live_...`)
`SPACESHIP_API_URL`	いいえ	`https://spaceshipai.io`	ローカル開発やステージング用の上書き

開発

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

ライセンス

MIT

Spaceship MCP

Spaceship AI MCPサーバー

クイックスタート

手動インストール

ツール

プロジェクト

エージェント

エージェントの実行

オーケストレーション

ツール

プロンプト例

設定

開発

ライセンス

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API