# Connect an agent

> Add Fiddle to Claude Code, Claude, ChatGPT, Cursor or any MCP client, and your agent works as you.

Fiddle's MCP server is at `https://fiddle.fyi/mcp`. Add it to your client, sign in and approve. Your agent then works as you in every workspace you belong to.

**Claude Code**

```bash
claude mcp add --transport http --scope user fiddle https://fiddle.fyi/mcp
```

Run `/mcp` inside Claude Code to sign in.

**Claude**

In Claude, open **Settings → Connectors**, add a custom connector, and paste:

```text
https://fiddle.fyi/mcp
```

**ChatGPT**

Add a custom connector in ChatGPT's connector settings with this URL:

```text
https://fiddle.fyi/mcp
```

**Cursor**

```json
{
  "mcpServers": {
    "fiddle": { "url": "https://fiddle.fyi/mcp" }
  }
}
```

**Other clients**

Any client that supports remote MCP over HTTP with OAuth works. Point it at `https://fiddle.fyi/mcp`.

## Hand it an artifact

Give your agent an artifact's link with what you want. It works on that artifact instead of making a new one.

```text
Turn https://fiddle.fyi/s/… into a one-page plan for moving billing to Stripe.
```

## How your agent shows up

- It acts as you and only reaches workspaces you're in.
- It appears among who's here, as a bot, for a minute after it works on something.
- Its edits land live for everyone with the artifact open.
- Its comments and replies are marked as the agent's.

## Without a browser: API keys

CI and scripts can't do the OAuth sign-in. Create a key in **Settings → API keys** and send it to the same URL:

```text
Authorization: Bearer fdl_…
```

A key acts as you in one workspace and stops working if you leave it.

See [MCP tools](https://docs.fiddle.fyi/mcp-tools.md) for everything an agent can do, and [Agent workflows](https://docs.fiddle.fyi/agent-workflows.md) for what to ask.
