Getting started with Unpitch in Claude Code

Three steps: install, authorise one workspace, verify. Then the rest of this page tells you exactly what Claude Code can read, write and spend, and how to take the access away.

You need: A current Claude Code install, and an Unpitch account with at least one workspace.
Endpoint: https://api.unpitch.ai/mcp
Client: One public client, no client secret. Sign-in requests the email scope only; what each tool may do is declared by the tool, not by the sign-in.
Callback: http://localhost:8080/callback

Step 1

Install

Run this in the terminal on the machine where you use Claude Code. The command registers Unpitch as an MCP server named unpitch and pins the browser callback to port 8080. There is no client secret to enter and no registration step of your own.

Terminal

claude mcp add --transport http --client-id ae21983d-3072-43ab-ad47-d5feae975afc --callback-port 8080 unpitch https://api.unpitch.ai/mcp

Prefer to let Claude do it? Paste this into Claude Code instead. It runs the same command and ends by checking the connection.

Paste into Claude Code

Set up Unpitch for me.

1. Run: claude mcp add --transport http --client-id ae21983d-3072-43ab-ad47-d5feae975afc --callback-port 8080 unpitch https://api.unpitch.ai/mcp
2. Walk me through opening /mcp and authorising Unpitch in my browser, where I choose my workspace.
3. After I confirm, call get_workspace_context and report the returned workspace and available credits.

Step 2

Authorise one workspace

Open Claude Code and run /mcp. Select unpitch, sign in to Unpitch in the browser that opens, and choose the workspace Claude Code may use. The browser returns to Claude Code on its own; the consent screen is the last Unpitch page in the flow.

One authorisation binds one workspace. To work in another workspace, authorise again and choose it; the previous authorisation is replaced.

Step 3

Verify

Ask Claude to call get_workspace_context and report the workspace and available credits. It is a read, so it proves the connection without spending anything. Your connection then shows as Connected in Settings.

What Claude Code can do

Reads context, writes Documents, spends only on evaluation.

Tool	Kind	What it does	Cost
get_workspace_context	Read	The authorised workspace, remaining evaluation capacity and credits, and the room left in the monthly Claude Code limit.	Free
list_documents	Read	A bounded page of Documents with the revision identity each later read or edit must name.	Free
get_document	Read	One Document by its public short ID, with its typed content and current revision.	Free
search_knowledge	Read	A small set of workspace-scoped Knowledge Base excerpts, each with its source, for one specific question.	Free
list_personas	Read	The Personas eligible for Simulation, marked standard or researched.	Free
get_run	Read	The public result of one Quality Check or Simulation run by its short ID.	Free
create_document	Write	Saves one typed Document in the workspace so it can be evaluated and continued in Unpitch.	Free
update_document	Write	Applies a revision-checked change to one Document. A stale revision returns a conflict instead of overwriting.	Free
run_quality_check	Evaluate	Starts a Quality Check on an exact Document revision.	Included capacity first; a five-minute quote to confirm when credits are needed
quote_simulation	Evaluate	Prepares a five-minute quote for one Document revision and Persona. Nothing is spent.	Free
run_simulation	Evaluate	Confirms a valid quote and starts one Simulation.	10 credits per run

Claude Code never writes the Knowledge Base or Personas, never reads another workspace, and never sees internal identifiers or prompts. Documents and runs it creates appear in Unpitch like any other, and Settings lists the calls this connection made.

Credits

Reads are free. Evaluation spends what it spends in the app.

Quality Check uses your included capacity first; when a run needs credits, Claude Code receives a quote that holds for five minutes and must be confirmed before anything is spent. Simulation costs 10 credits per run and always goes through a quote and a confirmation. Credits admitted through Claude Code also count against one monthly limit shared by everyone in your organisation, 10,000 credits by default, which resets on the first of each month (UTC). Owners and admins can change it in Settings.

Revoke or move

Taking access away is one click.

In Settings choose Revoke access. The next request from Claude Code is denied; the local configuration stays so you can authorise again later. To remove the server from Claude Code entirely:

Terminal

claude mcp remove unpitch

Troubleshooting

Claude Code says the server needs authentication, or a request returns 401: Run /mcp again and authorise. Access was revoked in Settings, the authorisation was replaced from another machine, or your workspace membership ended.
The browser opened but nothing came back to Claude Code: Something else is listening on port 8080. Free the port, then run /mcp again. The callback address is fixed to http://localhost:8080/callback.
An update returned a conflict: The Document changed since Claude Code last read it. Read it again with get_document and retry the change against the current revision.
A run was refused because the organisation limit is reached: The monthly Claude Code limit is shared by everyone in your organisation and resets on the first of the month (UTC). An owner or admin can raise it in Settings.
A quote expired: Quotes hold their price for five minutes. Ask for a new quote and confirm it.

Claude Code is the supported client. Unpitch speaks the standard MCP transport with OAuth, so other clients may connect, but only this path is tested and documented.

Once you are connected

The full documentation picks up here.

This page gets you connected. What every action does, what Claude Code may read and may never change, how credits and the shared spend window behave, and what each failure means all live in the docs.

Read the Claude Code documentation