Connect an agent to shipd

Overview

Connect your coding agent to shipd using the Model Context Protocol (MCP). You need a Pro, Teams, or Enterprise organization and a client supporting Streamable HTTP with browser OAuth authorization. The server endpoint is https://mcp.useshipd.com/mcp.

Add shipd to your client

codex mcp add shipd --url https://mcp.useshipd.com/mcp
codex mcp login shipd

claude mcp add --transport http --scope user shipd https://mcp.useshipd.com/mcp

{
  "mcpServers": {
    "shipd": {
      "url": "https://mcp.useshipd.com/mcp"
    }
  }
}

In Claude Code, run /mcp and authenticate shipd. In Cursor, open the server’s authentication action. Follow the browser sign-in flow. Official client instructions: Codex, Claude Code, Cursor.

Authorize access

Select one organization and choose Read and write or Read only. Read and write is selected by default. Choose all current and future accessible projects, or select individual projects. Click Allow read and write access or Allow read-only access. You may be asked to sign in again before authorizing a connection. The agent acts as you. Your current role, project access, production permissions, quotas, and approval policies apply to every operation. A write connection does not grant permissions your role lacks. Ask your agent:

List my projects and environments. In web-app, create a boolean flag named
new-checkout, then read its current development state and propose targeting
paid users. Keep the idempotency key unchanged when retrying a mutation.

Pending changes return an approval request and a dashboard review link. Review the exact change in shipd; the agent cannot approve it or change approval policies.

Manage connections

Open Settings → Connected apps to inspect access and revoke a connection. Each connection expires after 30 days without use or 90 days total. Sign in and authorize again after expiry. Related: MCP tools and request guarantees · Access control

Flags

Config as code

Operations

Enterprise

Migrate to shipd

Connect an agent to shipd

Overview

Add shipd to your client

Authorize access

Manage connections

​Overview

​Add shipd to your client

​Authorize access

​Manage connections

Overview

Add shipd to your client

Authorize access

Manage connections