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

Spaceship AI MCP 서버

Spaceship AI용 MCP 서버 — Claude Code, Cursor, VS Code 및 Windsurf에서 직접 AI 에이전트를 빌드, 실행 및 관리하세요.

빠른 시작

MCP 서버를 수동으로 구성하고 싶지 않으신가요?

spaceshipai@latest init을 실행하여 한 번의 명령으로 모든 것을 자동으로 설정하세요:

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_..."
      }
    }
  }
}

spaceshipai.io의 Settings → API Keys에서 API 키를 받으세요.

도구

프로젝트

도구	설명
`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