> For the complete documentation index, see [llms.txt](https://docs.biobox.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.biobox.io/guide/how-to/ask-biobox-with-claude/connect-claude.md).

# Connect Claude (sign in)

You connect Claude to BioBox once, using a single **connector URL**. Signing in uses your existing BioBox account — there is **no token to copy or paste**. A browser window opens, you log in the same way you log into the BioBox app, and the connection is remembered for next time.

**Connector URL** — replace `<your-org-id>` with your BioBox organization id:

```
https://biobox.app/api/mcp?orgId=<your-org-id>
```

{% hint style="warning" %}
**The `orgId` is required.** Claude connects over the web, where it can't send BioBox's organization header, so it tells BioBox which graph to query through the `?orgId=<your-org-id>` part of the URL. Without it the connector can't scope to your data. Your BioBox administrator can give you the org id; if you belong to more than one organization, use the id for the one you want to query.
{% endhint %}

Pick your client below — each one uses this same URL (with your `orgId` filled in).

## Claude on the web (claude.ai)

1. Open [claude.ai](https://claude.ai) and go to **Settings → Connectors**.
2. Click **Add custom connector**.
3. Give it a name (e.g. `BioBox`) and paste the **connector URL** above, with your `orgId` filled in.
4. Save, then click **Connect**. A BioBox sign-in window opens — log in with your BioBox account and approve access.
5. In a chat, open the tools/connectors menu and make sure **BioBox** is enabled.

## Claude Code

From a terminal, add the connector (an HTTP MCP server):

```bash
claude mcp add --transport http biobox "https://biobox.app/api/mcp?orgId=<your-org-id>"
```

Then start (or reload) Claude Code and authenticate:

```
/mcp        # select "biobox" → Authenticate — a browser opens for BioBox sign-in
```

After you sign in, `/mcp` shows **biobox** as connected and lists its tools. To remove it later: `claude mcp remove biobox`.

## Claude Desktop

1. Open **Claude Desktop → Settings → Connectors**.
2. Click **Add custom connector**.
3. Enter a name (e.g. `BioBox`) and paste the **connector URL** above, with your `orgId` filled in. Leave **OAuth Client ID** blank.
4. Click **Connect**. A BioBox sign-in window opens — log in and approve access.
5. BioBox now appears in the connectors list; enable it in a conversation to use its tools.

## What to expect when you sign in

* **A BioBox login page**, not a request for a token. You authenticate with your normal BioBox credentials; Claude never sees your password.
* **An approval screen** the first time, asking you to allow Claude to access BioBox on your behalf. This grants read-only, organization-scoped access (see [what it can and can't do](/guide/how-to/ask-biobox-with-claude.md#what-it-can-and-cant-do)).
* **Stay signed in.** The connection is remembered, so you won't have to log in every session.

## Troubleshooting

* **Sign-in didn't finish / connection failed on the first try.** Newly registered connectors occasionally need a second attempt — click **Connect** (or run `/mcp` → Authenticate) once more.
* **"Service not found" or an error before the login screen.** Double-check the connector URL matches the template `https://biobox.app/api/mcp?orgId=<your-org-id>` — no typos, no trailing characters, and `<your-org-id>` replaced with your real org id.
* **Answers look empty, or say you lack access, or hit the wrong graph.** First confirm the `orgId` in your connector URL is present and correct — a missing or wrong `orgId` is the most common cause. Otherwise, remember you only see what your BioBox account can see; ask your BioBox admin about your org id or permissions.

Once connected, head to the [Quickstart](/guide/how-to/ask-biobox-with-claude/quickstart.md) to ask your first question.