The Shipyard MCP Server: Manage environments with AI agents



This content originally appeared on DEV Community and was authored by Shipyard DevRel

We’re excited to announce the beta release of our MCP server. Now you can loop your agents into environment management, and give them access/context to run tests, tail environment logs, start/stop environments, and debug remote issues.

The MCP server is an extension of the Shipyard CLI, so if you’re already set up auth, you won’t need to add your token again.

Installing the Shipyard CLI/MCP

(Skip this step if you already have the Shipyard CLI installed)

brew tap shipyard/tap
brew install shipyard

Claude Code

With API token and org name:

claude mcp add shipyard --env SHIPYARD_API_TOKEN=your-token-here --env SHIPYARD_ORG=your-org-name -- shipyard mcp serve

If already configured with CLI:

claude mcp add shipyard -- shipyard mcp serve

Codex CLI

Edit ~/.codex/config.toml and add:

[mcp_servers.shipyard]
command = "shipyard"
args = ["mcp", "serve"]
env = { "SHIPYARD_API_TOKEN" = "your-token-here", "SHIPYARD_ORG" = "your-org-name" }

(Contact us at support@shipyard.build if you need API access).

Using the MCP to connect to ephemeral environments

Our users have been using the MCP server to add more capabilities to their agent dev loops:

  • Writing and improving E2E tests: your agent will use your codebase, the Shipyard MCP, and the Playwright MCP to study your app and improve existing tests
  • Sandboxes for rapid prototyping: generate code with your agent and instantly see that in a live env, then pull logs to iterate/improve features
  • Live code reviews: use the Shipyard MCP to get an env link, then use Playwright MCP to gather info about the feature, cross reference with the codebase

Start building!

If you’re a dev building with agents, we highly encourage you to try it out today. It’s 100% open source, so feel free to fork it, open a PR, or use it to help you build your own MCP server.

(Sign up for a 30-day free Shipyard trial if you haven’t yet).

We’re curious to hear how you’re using it to build and test faster. Write us at hello@shipyard.build to share your thoughts. Any and all feedback is super valuable for us during the beta.


This content originally appeared on DEV Community and was authored by Shipyard DevRel