> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useshipd.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect an agent to shipd

> Authorize Codex, Claude Code, Cursor, or another remote MCP client to manage flags, audiences, projects, and environments.

## 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

```bash Codex theme={null}
codex mcp add shipd --url https://mcp.useshipd.com/mcp
codex mcp login shipd
```

```bash Claude Code theme={null}
claude mcp add --transport http --scope user shipd https://mcp.useshipd.com/mcp
```

```json Cursor — .cursor/mcp.json theme={null}
{
  "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](https://developers.openai.com/codex/mcp), [Claude Code](https://code.claude.com/docs/en/mcp), [Cursor](https://cursor.com/docs/mcp).

## 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](/operations/approvals) apply to every operation. A write connection does not grant permissions your role lacks.

Ask your agent:

```text theme={null}
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](/reference/mcp) · [Access control](/enterprise/access-control)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.