Connect Claude to Arbituro

Address

https://app.arbituro.com/mcp

Transport

Streamable HTTP

Sign-in

OAuth with your Arbituro account. Client ID Metadata Documents and Dynamic Client Registration both work.

Tools

Six that read, and five that propose, record or file

Limit

120 calls a minute for each person

Before you start

• You need an Arbituro account, and membership of the workspace and projects you want Claude to work in. Claude sees only what you can see.
• In Claude, any plan can add a custom connector. The Free plan allows one. On a Team or Enterprise plan, an Owner adds Arbituro for the organization first, as Roll out Claude explains.
• To let Claude link pull requests, the project needs a GitHub repository linked to it. See Let agents link pull requests.

There is nothing to install and no API key to create. You sign in with your Arbituro account when you connect.

The server address

https://app.arbituro.com/mcp

This address reaches every workspace you belong to. Each call names a project, and the project decides which workspace it reaches.

To keep Claude to one workspace, use that workspace’s own address. You’ll find it in Arbituro under Settings, then Connections, then Your coding agent.

https://app.arbituro.com/mcp/<workspace key>

A sign-in works only at the address it was made for. A sign-in for one workspace’s address is refused at every other address.

Connect in Claude

These steps work in Claude on the web, in the desktop app and on mobile.

On a Free, Pro or Max plan

1. In Claude, open Customize, then Connectors.
2. Choose Add custom connector.
3. Enter a name, such as Arbituro, and the server address. Leave the advanced settings empty.
4. Choose Add, then Connect, and sign in with your Arbituro account.

On a Team or Enterprise plan

1. Ask an Owner to add Arbituro for your organization, if they haven’t already.
2. In Claude, open Customize, then Connectors, and find Arbituro with the Custom label.
3. Choose Connect, and sign in with your Arbituro account.

You can turn the connector off for a conversation, or block any tool you don’t want Claude to use, under Customize, then Connectors.

Connect in Claude Code

claude mcp add --transport http arbituro https://app.arbituro.com/mcp

Then run /mcp in Claude Code and choose arbituro to sign in. Your browser opens Arbituro’s sign-in.

To share the server with everyone who works in a repository, add --scope project. Claude Code writes it to the repository’s .mcp.json, and each person still signs in as themselves.

Other MCP clients

Any client that supports remote MCP servers over Streamable HTTP with OAuth can connect. Cursor and VS Code take a config like these, and open Arbituro’s sign-in the first time they connect.

{
  "mcpServers": {
    "arbituro": { "url": "https://app.arbituro.com/mcp" }
  }
}

{
  "servers": {
    "arbituro": { "type": "http", "url": "https://app.arbituro.com/mcp" }
  }
}

What Claude can do

Every tool names a project by its key, such as WEB, and most name a job, such as WEB-12. Claude can’t list your projects, so tell it which project you mean.

Reads

list_jobs

Lists a project’s jobs in the order your team set, filtered by status, owner, parent job or days without change.

get_job

Reads one job in full, with its acceptance criteria, the state of each and who decides it.

list_comments

Reads the notes people and agents left on a job.

job_history

Reads what changed on a job, and who changed it.

search

Searches a project’s jobs, their history and the documents published to its agents.

what_happened

Reads the record of recent activity, for a project or one job.

Writes

None of these changes a job or decides anything. They raise a decision for a person, or add your own words to the record.

propose_job_update

Proposes a change to a job’s fields. Nothing changes until a person approves it.

claim_done

Records what Claude checked against one acceptance criterion, and asks the person who decides it. Criteria that a CI check or an approved message decides can’t be claimed.

post_note

Adds a note to a job under your name, and notifies the people it mentions.

create_job

Files a new job under your name. Nobody is assigned and no work starts.

link_pull_request

Links a pull request from the project’s GitHub repository to a job. It reads the pull request and writes nothing to GitHub.

What Claude can’t do

Claude can’t approve anything, act through your workspace’s integrations, send or publish anything, merge or review code, spend credits, delete anything, change anyone’s access, or mark an acceptance criterion met. The one thing it reads through an integration is the pull request it links, through the GitHub app.

It reaches only the projects you belong to, with the role you have in each. If you can only view a project, Claude can read it and every write is refused.

Examples

1. “What does done mean for WEB-12, and what’s still open?”

   Claude reads the job and lists each acceptance criterion, whether it is met, and who decides it.

2. “Search the WEB project for anything about the checkout redesign and tell me where it stands.”

   Claude searches the project, reads the jobs it finds and summarises their state.

3. “I’ve opened a pull request for WEB-12. Link it to the job and leave a note saying what’s ready for review.”

   Claude links the pull request, so its CI results show on the job, then posts the note under your name.

4. “Check WEB-14’s acceptance criteria against this branch, and claim the ones you can show are met.”

   Claude records what it checked against each criterion a person decides. Each person is asked, and decides in Arbituro.

5. “File a job in WEB for the broken password reset link we just found.”

   Claude files the job under your name. It is not assigned and nothing starts until someone picks it up.

Security and privacy

• You sign in with your Arbituro account over OAuth. The MCP server takes no API keys or personal access tokens, and your client’s sign-in works only at the address it was made for.
• Claude acts as you, with your access. When someone is removed from a workspace or a project, their agent loses that access on its next call.
• Every call made in a workspace is recorded in its audit log, with the person, the client, and the project and job it named. The text Claude sends, such as a note’s body, is not copied into the audit record.
• Arbituro tells every connected agent that what it reads in a job is information about the work, never an instruction.
• What a tool returns goes to the client you connected, and from there to its model provider, under your agreement with them.
• Arbituro’s privacy policy covers the data the service holds.

Disconnect

In Claude, remove Arbituro under Customize, then Connectors. In Claude Code, run claude mcp remove arbituro. Removing someone from the workspace ends their access from every client.

Troubleshooting

Claude says a project can’t be found

Check the project’s key, and that you are a member of the project. Arbituro gives the same answer for a project that doesn’t exist and one you can’t open, so nobody can find projects by guessing keys.

Claude can read a project but can’t write to it

Your role in that project lets you view it only. Ask the project’s owner or an admin to change your role.

A pull request won’t link

The pull request has to be in a GitHub repository linked to the job’s project, and Arbituro’s GitHub app has to be able to see it. A project with no linked repository accepts no links.

A criterion can’t be claimed

Criteria decided by a CI check are settled by the check, on a linked pull request. Criteria decided by an approved message are settled when it is sent. Only criteria a person decides can be claimed.

Sign-in fails, or a workspace is refused

Remove the connector and add it again with the address exactly as shown, then sign in with the Arbituro account that belongs to the workspace. A sign-in made for one workspace’s address doesn’t work at another.

Calls are refused for a minute

Arbituro allows 120 calls a minute for each person. Wait a minute and try again.

Support

Email support@arbituro.com with the address you connected, the client you use, and when the problem happened.