# Quick Start: Your First Workflow with Your Coding Agent (https://www.shipfox.io/docs/getting-started)

Description: Connect your coding agent to Shipfox and ask it to build your first workflow.

Your coding agent builds Shipfox workflows for you. Connect it, then tell it
what to build.

## Before you begin [#before-you-begin]

* Complete onboarding in [Shipfox](https://app.shipfox.io), with a project for
  your repository.
* Open that repository in Claude Code, Codex CLI, or OpenCode.

## Connect your coding agent [#connect-your-coding-agent]

Add the Shipfox MCP server to your coding agent:

```text
https://api.shipfox.io/mcp
```

#### Claude Code

Run this command in your terminal:

```sh
claude mcp add --transport http shipfox https://api.shipfox.io/mcp
```

Open Claude Code and run `/mcp`. Select **shipfox** and complete the browser
sign-in.

Claude Code reads the server's skill and docs resources on its own.

#### Codex CLI

Run these commands in your terminal:

```sh
codex mcp add shipfox --url https://api.shipfox.io/mcp
codex mcp login shipfox
```

The second command opens the Shipfox sign-in page in your browser.

Codex CLI 0.47.0 and later reads the server's skill and docs resources on its
own.

#### Cursor

Add this entry to `.cursor/mcp.json` in your project, or to
`~/.cursor/mcp.json` for every project:

```json
{
  "mcpServers": {
    "shipfox": {
      "url": "https://api.shipfox.io/mcp"
    }
  }
}
```

Don't add Cursor's `auth` block for static OAuth clients. Shipfox registers the
OAuth client during sign-in.

Open **Customize** from the Cursor sidebar to see the server. Cursor opens the
browser sign-in when it first connects to Shipfox. For the file format, see the
[Cursor MCP documentation](https://cursor.com/docs/mcp).

Cursor 1.6 and later supports the server's skill and docs resources. Only user
reports show its agent reading them on its own.

#### VS Code

Add this entry to `.vscode/mcp.json` in your project. To use it in every
workspace, run **MCP: Open User Configuration** instead.

```json
{
  "servers": {
    "shipfox": {
      "type": "http",
      "url": "https://api.shipfox.io/mcp"
    }
  }
}
```

Run **MCP: List Servers** and select **shipfox**. Start the server. VS Code asks
you to approve the sign-in and opens your browser.

VS Code 1.101 and later supports the server's skill and docs resources. Attach
one to a chat with **Add Context** > **MCP Resources**.

#### OpenCode

Add this entry to `opencode.json` in your project:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "shipfox": {
      "type": "remote",
      "url": "https://api.shipfox.io/mcp"
    }
  }
}
```

Run `opencode mcp auth shipfox` to complete the browser sign-in.

OpenCode 1.17.10 and later reads the server's skill and docs resources on its
own.

#### Zed

Run **zed: open settings file** from the command palette and add this entry:

```json
{
  "context_servers": {
    "shipfox": {
      "url": "https://api.shipfox.io/mcp"
    }
  }
}
```

Select **Authenticate** next to the server to complete the browser sign-in.

Zed doesn't support MCP resources, so its agent can't read the server's skills.

#### Antigravity

Add this entry to `.agents/mcp_config.json` in your project, or to
`~/.gemini/config/mcp_config.json` for every project:

```json
{
  "mcpServers": {
    "shipfox": {
      "serverUrl": "https://api.shipfox.io/mcp"
    }
  }
}
```

In Agent Settings, select **Authenticate** for the server. After the browser
sign-in, paste the code into Antigravity and select **Submit**.

#### Other clients

Add the server URL to any client that supports MCP OAuth and browser sign-in.

## Start building [#start-building]

Start from a template. The agent suggests the ones that fit your workspace:

Open your coding agent in your repository and send this prompt:

```text
Use Shipfox to create a workflow from a template.
```

To pick one yourself, copy its prompt from [Examples](https://www.shipfox.io/docs/examples).

Or describe your own workflow:

Open your coding agent in your repository and send this prompt:

```text
Use Shipfox to write a workflow for this repository.
```

The agent asks a few questions, tests the workflow on your repository, and
opens a pull request. Merge it to turn the workflow on.

## Next steps [#next-steps]

### [Examples](https://www.shipfox.io/docs/examples)

Workflows tested by the Shipfox team, each with a prompt to paste.

### [How Shipfox works](https://www.shipfox.io/docs/understand)

The mental model in one page: events, jobs, agents, and feedback loops.