---
title: "Connect your own agent"
description: "Drive Prototyper from Claude Code, Codex, or any MCP client — and generate on the agent subscription you already pay for."
canonical: "https://www.prototyper.co/docs/01-getting-started/connect-your-agent"
---

# Connect your own agent

Prototyper runs an [MCP](https://modelcontextprotocol.io) server. Point your
coding agent at it and that agent can read and write your workspace directly —
create files, edit the canvas, ship a prototype — without going through the
in-app composer.

This is what "bring your own agent" means, and it is the reason the Free plan is
genuinely usable. Generation runs on **your** agent and **your** AI
subscription, so it doesn't touch the platform's weekly message allowance at
all. If you already pay for Claude Code or Codex, you already have everything
you need.

---

## Connect in one command

Run one of these in your terminal, then complete the authorization prompt your
editor shows you.

**Claude Code**

```bash
claude mcp add --transport http prototyper https://www.prototyper.co/api/mcp
```

**Codex**

```bash
codex mcp add prototyper --url https://www.prototyper.co/api/mcp
```

Any other MCP-capable client works too — point it at
`https://www.prototyper.co/api/mcp` over streamable HTTP and authorize.

<Callout type="info">
  The onboarding wizard runs this same step and can verify the connection for
  you. You can also re-run it any time.
</Callout>

## Confirm it worked

Two places tell you the truth:

- **Settings → MCP clients** lists every agent you've authorized, when it last
  called us, and what it's allowed to do. Revoke any of them from here.
- **The MCP button in the composer** shows the connection state, and once you're
  connected it hands your agent a prompt to open the current workspace.

## What your agent can do

Once connected, your agent works against a real filesystem view of the
workspace. It can list and read files, write and patch them, run commands, and
manipulate canvas objects — the same surface the in-app agent uses.

The practical shape of it: describe what you want in Claude Code, watch it land
on the canvas.

## Quota, honestly

| | Platform composer | Your own agent |
| --- | --- | --- |
| Runs on | Prototyper's AI credit | Your Claude Code / Codex subscription |
| Free plan | 5 messages / week | Unlimited |
| Costs you | Nothing until you upgrade | Whatever you already pay your agent provider |

Connecting an agent doesn't unlock the in-app composer's message allowance —
that stays on your plan. It gives you a second, uncapped way to do the work.
Most people on Free end up doing both: the composer for quick edits, their own
agent for the heavy lifting.

## Revoking access

Settings → MCP clients → **Revoke**. That kills every token in the client's
family immediately; the agent has to re-authorize to get back in.