Connect your AI tool (MCP)

Set it up

Pick the app you use. It takes about a minute: add Roundable, sign in, click Allow. No key to copy, no code to write.

Roundable's addresshttps://studio.roundable.app/mcp

For claude.ai and the Claude desktop app. Once added, Roundable is also in the mobile app and in Claude Code on the web.

Add Roundable as a connector

Open Claude's Connectors page and click Add custom connector. Name it Roundable, paste the address, and click Add. Leave the advanced settings empty.

Open Claude Connectors

Add custom connector Name
Roundable
Remote MCP server URL
https://studio.roundable.app/mcp

CancelAdd

Shortcut: in Roundable, Settings → AI connection → Add to Claude copies the address and opens this page.
Click Connect, then Allow

Claude opens Roundable. Sign in if you need to, check it's the right workspace, and click Allow. You land back in Claude, connected.
Roundable
Connect Claude to Roundable?
- Read the feedback on every project in the workspace
- Mark feedback ready for your client to check
Workspace: Your agency

CancelAllow
A workspace owner or admin clicks Allow, once. The workspace needs the Studio or Agency plan.
Ask Claude

Start a new chat and ask in plain words. Claude reads the feedback straight from Roundable.
What's still open on Acme in Roundable?

Used Roundable · get_feedback
3 items are still open on Acme:
1. RB-01 Make the headline bigger · Home
2. RB-02 Footer links are misaligned · Home
3. RB-03 Use the new logo · Pricing
Want it to fix them in your code too? Use Claude Code on the web or in the desktop app: Roundable is already there.

For Claude Code in a terminal. Using Claude Code on the web or in the desktop app? Add Roundable under Claude instead: no terminal at all.

Add Roundable

In a terminal, in your website's project folder, paste this and press Enter.
Terminal
```
claude mcp add --transport http roundable https://studio.roundable.app/mcp
```
Want it in every project? Add --scope user to the end.
Sign in once

Start claude, type /mcp, pick roundable and choose Authenticate. Your browser opens Roundable: click Allow.
claude · ~/acme-site
```
> /mcp
  roundable · needs authentication
  ❯ Authenticate
Opening your browser…
✓ Authenticated. roundable connected.
```

Ask Claude to fix the feedback

Ask in plain words. Claude reads the open feedback, edits your code, then marks each item ready to check with a short note.

claude · ~/acme-site

> Fix the open feedback on Acme in Roundable
⏺ roundable - get_feedback (project: "Acme")
  ⎿  3 items still to do across 2 pages
⏺ Update(src/components/Hero.tsx)
  ⎿  - <h1 className="text-5xl md:text-6xl">
     + <h1 className="text-6xl md:text-7xl">
⏺ roundable - update_feedback (RB-01, status: "check")
⏺ All 3 done and marked ready for Mike to check.

Click Add to Cursor

Cursor opens and asks to install Roundable. Click Install.

Add to Cursor
Sign in and Allow

Cursor asks you to sign in to Roundable (in Cursor Settings → MCP if it doesn't ask straight away). Your browser opens Roundable: click Allow.
Roundable
Connect Cursor to Roundable?
- Read the feedback on every project in the workspace
- Mark feedback ready for your client to check
Workspace: Your agency

CancelAllow
Ask in the Agent chat

Open the Agent chat and ask: “Fix the open feedback on Acme in Roundable.”

The button didn't open Cursor?

Add this to ~/.cursor/mcp.json, save, and Cursor asks you to sign in.

~/.cursor/mcp.json

{
  "mcpServers": {
    "roundable": { "url": "https://studio.roundable.app/mcp" }
  }
}

Click Add to VS Code

VS Code opens and asks to install Roundable. Click Install.

Add to VS Code
Sign in and Allow

VS Code asks to sign in to Roundable. Your browser opens Roundable: click Allow.
Roundable
Connect VS Code to Roundable?
- Read the feedback on every project in the workspace
- Mark feedback ready for your client to check
Workspace: Your agency

CancelAllow
Ask Copilot in Agent mode

Open the chat, switch to Agent, and ask: “Fix the open feedback on Acme in Roundable.”

The button didn't open VS Code?

Add this to .vscode/mcp.json in your project. There's no secret in it, so it's safe to commit.

.vscode/mcp.json

{
  "servers": {
    "roundable": { "type": "http", "url": "https://studio.roundable.app/mcp" }
  }
}

Add it by its address

In your app's MCP or connector settings, add a remote server with Roundable's address. If your app supports signing in (OAuth), it opens Roundable for you to click Allow, and that's it.

Addresshttps://studio.roundable.app/mcpTypeStreamable HTTP (or just “HTTP”)
No sign-in? Use a key

In Roundable, open Settings → AI connection → Use a key instead, name it after your app, and copy the key that starts with rb_. Then add this header to the server in your app:

HeaderAuthorization: Bearer rb_your_key

A key opens every project in the workspace and is shown once. Keep it private; remove it any time in Settings.
App only runs local servers?

Use the small mcp-remote bridge (needs Node.js). It opens Roundable in your browser to sign in.
MCP server settings
```
{
  "command": "npx",
  "args": ["-y", "mcp-remote", "https://studio.roundable.app/mcp"]
}
```

Then your client checks it

Each item your AI finishes moves to To check with its note in the thread. Your client sees it the next time they open the link (clients with an account also get an email), then approves it or reopens it with a reply.

RB-01 · Home To check

Make the headline bigger, it gets lost.

MMike· client

Claude· just now

Headline is now 72px on desktop and 60px on mobile (Hero.tsx).

ApproveReopen

Things to ask

Quickest: click Fix with AI under the feedback list on any review screen, choose Copy the task and paste it into the chat you already use, no new chat needed. In Claude Code you can also type /mcp__roundable__fix. Or talk to it like a teammate: swap “Acme” for your project's name, and click one to copy it.

What your AI can do

Roundable gives your AI five tools. It picks the right one from what you ask.

list_projectsReads

Your projects, with how much feedback is open, in progress and waiting for the client on each, plus their pages.

get_feedbackReads

A brief of what to change and where: the element or marked area, the section of the page, the screen width, any images, the whole thread, and a Thread ID for each item. By default only what's still to do.

project Name or id, from list_projects

status todo (default), open, progress, check, resolved or all

page Optional: just one page, by name or id

add_pagesWrites

Adds pages of the website to a project, for when a QC pass reaches a page that isn't in the list yet. A project stays for one website: pages must be on the same site (or a subdomain) as the project's first page, so another site is refused. It only adds: it can't change or remove pages.

project Name or id, from list_projects

pages Up to 25: url (full address, or a path like /pricing), optional name

organize_pagesWrites

Arranges the page list into named groups, the headers on the left of the review screen. Creates groups that don't exist yet, puts pages in them in the order you give, takes pages out, renames groups, removes groups (the pages stay) and sets the order of the groups. list_projects shows the current groups.

project Name or id, from list_projects

groups name, pages (each a page name, id or path)

ungroup Optional: pages to take out of their group

rename_groups Optional: from, to

delete_groups Optional: group names to remove (pages are kept)

group_order Optional: group names in the order you want

create_feedbackWrites

Lets your AI do a QC pass: it checks the site at desktop, tablet and mobile widths and leaves new feedback pinned to the elements it finds (spacing, hierarchy, polish). Notes are team only and signed with the connection's name, so you can filter them under Written by → AI, delete the ones you don't want, and only then ask it to fix the rest. It never changes the site itself.

project Name or id, from list_projects

page Which page, by name, path or id

items Up to 25 per call: message, selector, viewport (desktop, tablet, mobile), optional visible_to_client

update_feedbackWrites

Moves an item to a new status and/or adds a note to its thread, signed with the connection's name. Setting To check lets your client know, by email if they have an account.

thread_id The Thread ID from get_feedback

status Optional: open, progress, check or resolved

note Optional: what changed, or why not

It can't delete pages or feedback, see billing or change who has access. And Roundable never touches your code: your AI tool edits it, on your machine.

Good to know

Signing in beats a key

Connecting by signing in means no key is ever copied around. If you do use a key, treat it like a password: it opens every project in your workspace.

Remove it any time

Settings → AI connection lists every connection with when it was last used. Remove one and that tool stops straight away.

Everyone sees what the AI did

Its notes are signed with the connection's name, like “Claude” or “Claude Code”, so your team and your client can tell.

Your code stays with you

The AI reads feedback from Roundable and edits files on your machine. Only its notes and status changes come back.

Troubleshooting

“Missing or unknown Roundable token”

The connection was removed in Settings, or a pasted key got cut short. Connected by signing in? Reconnect: in Claude, open the Roundable connector and click Connect; in Claude Code, /mcp → Authenticate. Using a key? Create a new one and put it in place of the old.

The Roundable page says to ask the workspace owner

Only a workspace owner or admin can click Allow. Ask one of them to connect, or to make you an admin.

Claude Code doesn't see Roundable

The command connects Roundable to the folder you ran it in. Run claude mcp list in your project folder to check, and /mcp to sign in if it says it needs authentication. To have it everywhere, add it again with --scope user at the end, or add it once in Claude's Connectors.

“More than one project matches”

Two projects share that name, so Roundable asks instead of guessing. Your AI usually picks the right id from the list it gets; you can also say which one, like “the Acme project with id 42”.

“This workspace is paused”

The workspace's plan has ended. Choose a plan in the studio under Plans and the connection works again, with the same key.

I don't see the connect buttons in Settings

Only a workspace owner or admin can connect tools. Ask one of them to connect the tool, or to make you an admin. On the Solo plan, Settings shows the AI connection as part of Studio and Agency instead.

“The AI connection is part of Roundable's Studio and Agency plans”

The workspace is on Solo. Upgrade to Studio or Agency under Plans and the same key starts working. Workspaces that connected a tool before the current plans keep their connection.

“Too many calls”

Each key can make 120 calls a minute, far more than working through a round of feedback needs. Wait a minute and ask your AI to carry on.

Does it work with ChatGPT or other chat apps?

Any tool that can add a remote MCP server works: by its address and a sign-in, or with a key in a custom header. If yours can't, use Copy for AI on the review screen: it copies the same brief, ready to paste into any chat.

Now let your AI fix the round.

Press Fix with AI on any review screen, copy the task and paste it into the chat you already use. Your AI fixes the notes and moves them to To check.

Open Settings

Let your AI tool fix the feedback.

Your client pins a note

Your AI reads it

It changes the code

Your client checks it

Set it up

Add Roundable as a connector

Click Connect, then Allow

Ask Claude

Turn on developer mode

Create the Roundable connector

Sign in and Allow

Ask ChatGPT

Add Roundable

Sign in once

Ask Claude to fix the feedback

Click Add to Cursor

Sign in and Allow

Ask in the Agent chat

Click Add to VS Code

Sign in and Allow

Ask Copilot in Agent mode

Add it by its address

No sign-in? Use a key

App only runs local servers?

Then your client checks it

Things to ask

What your AI can do

Good to know

Signing in beats a key

Remove it any time

Everyone sees what the AI did

Your code stays with you

Troubleshooting

Now let your AI fix the round.