What is Shipyard MCP?
Shipyard MCP is a Model Context Protocol server that lets AI assistants like Claude manage Shipyard ephemeral environments directly. It is built into the Shipyard CLI and provides tools for environment, service, volume, and organization management.
How to use Shipyard MCP?
Install the Shipyard CLI using the install script, Homebrew, or a download from the releases page. Run shipyard login to authenticate and save your API token. Then add the MCP server to your AI assistant—for example, claude mcp add shipyard --env SHIPYARD_API_TOKEN=your-token --env SHIPYARD_ORG=your-org -- shipyard mcp serve—or configure it in Codex CLI’s ~/.codex/config.toml. The server listens for tool calls and executes them against the Shipyard API.
Key features of Shipyard MCP
- 7 environment management tools (list, get, stop, restart, rebuild, cancel, revive)
- 2 service management tools (list services, get logs)
- 5 volume management tools (list, reset, snapshot create/load, list snapshots)
- 3 organization management tools (list orgs, get/set default org)
- Limitations: exec, port‑forward, and telepresence return help text directing users to the CLI.
Use cases of Shipyard MCP
- AI assistant lists all environments filtered by branch or repo name.
- Assistant stops, restarts, or rebuilds a specific environment on command.
- Assistant revives a deleted environment or cancels an ongoing build.
- Assistant manages volume snapshots: lists, creates, loads, resets volumes.
- Assistant shows current organization or switches default org without leaving the chat.
评论