Diffinery
Connect AI apps: Claude
Docs / Connect AI apps

Claude

Add Diffinery to claude.ai, Claude Desktop and the Claude mobile apps as a custom connector, approve it on Diffinery, and use it in chats and Projects.

View as Markdown

Add Diffinery to Claude once as a custom connector, and Claude can read your repositories, open and review pull requests, follow CI and file issues from any chat. The connector works on claude.ai, in Claude Desktop and in the Claude mobile apps.

You need a Diffinery account and a Claude plan that allows custom connectors. For Claude Code in a terminal, see Claude Code instead.

Add the connector

  1. On claude.ai or in Claude Desktop, open Settings → Connectors and choose Add custom connector.

  2. Fill in the two fields and choose Add:

    FieldValue
    NameDiffinery
    Remote MCP server URLhttps://diffinery.com/mcp

    Leave Advanced settings (OAuth client ID and secret) empty: Claude registers itself with Diffinery. On a self-hosted Diffinery, use your instance's address instead, such as https://git.example.com/mcp.

  3. Choose Connect next to Diffinery. A Diffinery tab opens. Sign in with your passkey if you aren't signed in.

  4. On the consent page, choose whom Claude acts as and its access, then choose Connect. The tab returns to Claude and the connector shows as connected.

Tip

Pick one of your agents under Act as and Write access. Claude can then open pull requests and comment as that agent, and its pull requests wait for a person's approval like any agent's.

Note

On a Team or Enterprise plan, an owner adds the connector once for the organization (in Claude's organization settings, under Connectors). Each member then chooses Connect and approves it with their own Diffinery account, so everyone's Claude acts with their own permissions.

Use it in a chat

Open the tools menu below the message box and make sure Diffinery is turned on. Then ask in plain words, for example:

  • "List my open pull requests on Diffinery and tell me which ones are waiting on CI."
  • "Why did the last workflow run on acme/widgets fail? Read the failing job's log."
  • "Open an issue in acme/widgets: the login page doesn't load on Safari."
  • "Review pull request 42 in acme/widgets and comment on anything risky."

Claude asks before it uses a tool that changes something, unless you allowed that tool to run without asking.

The connector also works in Claude Projects, and in Claude Desktop and the mobile apps once you've added it on claude.ai or in Desktop.

Check that it works

  • In Claude, Settings → Connectors shows Diffinery as connected.
  • On Diffinery, Settings → Access tokens → Connected apps lists Claude, with whom it acts as and its access.
  • Ask Claude "Who am I on Diffinery?". It calls the whoami tool and answers with the account you picked.

Disconnect

On Diffinery, choose Disconnect next to Claude under Settings → Access tokens → Connected apps. Its tokens stop working at once. To remove the connector from Claude too, remove it under Settings → Connectors.

Troubleshooting

ProblemWhat to do
The Diffinery tab says "Can't connect this app"Claude's registration expired (registrations nobody used are removed after a week), or it asked to return somewhere it didn't register. Remove the connector in Claude and add it again.
Claude says a tool needs the write scopeYou connected with Read access. Disconnect Claude on Diffinery and connect again with Write.
A tool fails with "agents may not push to protected or default branches"Claude acts as an agent, which works on branches and opens pull requests. Ask it to open a pull request instead.
Claude asks you to connect againThe connection lapsed after 30 days without use, or it was disconnected. Choose Connect again.

More detail on the consent page and what the tokens can do: How sign-in works.