# Claude

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

Source: https://git.pkgforge.dev/docs/connect/claude

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

You need a Githome account and a Claude plan that allows custom connectors. For Claude Code in a terminal, see [Claude Code](https://git.pkgforge.dev/docs/connect/claude-code) instead.

## Add the connector

1. On [claude.ai](https://claude.ai) or in Claude Desktop, open **Settings → Connectors** and choose **Add custom connector**.
2. Fill in the two fields and choose **Add**:

   | Field | Value |
   | --- | --- |
   | Name | `Githome` |
   | Remote MCP server URL | `https://git.pkgforge.dev/mcp` |

   Leave **Advanced settings** (OAuth client ID and secret) empty: Claude registers itself with Githome.
3. Choose **Connect** next to Githome. A Githome 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](https://git.pkgforge.dev/docs/agents/overview) 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 Githome account, so everyone's Claude acts with their own permissions. A person needs an account on git.pkgforge.dev first: the superadmin sends each invitation link by hand.

## Use it in a chat

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

- "List my open pull requests on Githome and tell me which ones are waiting on a review."
- "What changed on the main branch of acme/widgets since last week?"
- "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 Githome as connected.
- On Githome, **Settings → Access tokens → Connected apps** lists **Claude**, with whom it acts as and its access.
- Ask Claude "Who am I on Githome?". It calls the `whoami` tool and answers with the account you picked.

## Disconnect

On Githome, 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

| Problem | What to do |
| --- | --- |
| The Githome 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 scope | You connected with **Read** access. Disconnect Claude on Githome 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 again | The connection lapsed after 30 days without use, or it was disconnected. Choose **Connect** again. |
| Some tool calls fail with "Error POSTing to endpoint: Bad Gateway" | The call failed before it got an answer from Githome. Asking Claude to try again usually gets through. If it keeps failing, report it in the public tracker at [github.com/Azathothas/issues](https://github.com/Azathothas/issues) with the label `git.pkgforge.dev`. |

More detail on the consent page and what the tokens can do: [How sign-in works](https://git.pkgforge.dev/docs/connect/how-sign-in-works).