Add Hadron as a Connector in Claude (Settings)¶

If you use Claude in the browser (claude.ai) or the Claude desktop app, the simplest way to connect Hadron is to add it once as a Connector from your Claude Settings page. You sign in with OAuth — no API keys, no config files — and Hadron is then available in your chats.

This is the recommended setup for most people. (If you work primarily in Claude Code, use Add Hadron to Claude Code (OAuth) instead — the CLI flow registers the same server.)

Before you start¶

A Hadron account at hadronmemory.com. If you don't have one, create it and confirm you can log in.
A Claude plan that supports custom connectors (Pro, Max, Team, or Enterprise). On Pro and Max you add it yourself; on Team and Enterprise an Organization Owner adds it for the org (see the note below).

On a Team or Enterprise plan, the Owner adds Hadron

Custom connectors are available on Team plans, but members can't add them — and the control isn't on the personal Connectors page used in the steps below. Only an Organization Owner can add Hadron, from Organization settings → Connectors: click Add, hover Custom, choose Web, then paste https://srv.hadronmemory.com/mcp. (Clicking Add first shows a directory of pre-built connectors — the custom option only appears under the Custom → Web submenu.)

Once the Owner adds it, the Hadron connector appears for every member under Settings → Connectors with a Custom label, where each person clicks Connect and signs in with their own Hadron account (Step 3).

Step 1 — Open Connectors in Settings¶

Open Claude (claude.ai or the desktop app) and go to Settings.
Choose Connectors.
Click Add custom connector.

Step 2 — Point it at Hadron¶

Fill in the connector:

Field	Value
Name	`Hadron`
Remote MCP server URL	`https://srv.hadronmemory.com/mcp`

Save. Claude registers the connector but you're not signed in yet — that's the next step.

On the new Hadron connector, click Connect (or Sign in).
Claude opens the Hadron sign-in page. Sign in (via GitHub if prompted), review the consent screen, and click Approve.
You're returned to Claude and the connector shows as connected.

Your token is stored and refreshed automatically — you won't be asked again unless you revoke access.

Step 4 — Verify it works¶

Start a new chat and send:

List my Hadron memories with h-list-memories.

Claude calls the h-list-memories tool and lists the memories your account can reach. If you see them, you're connected.

Just joined an organization?

You don't need to install an agent to read your org's shared memories. As soon as you're a member of an organization, its knowledge memories are readable over MCP — h-list-memories shows them and you can open any node with h-read-node. Writing still requires a role granted through an App.

Add Hadron only once¶

Pick one way to connect Hadron per Claude app and stick with it. In particular, don't add the claude.ai/desktop Connector and also register the same https://srv.hadronmemory.com/mcp URL through another path for the same app — two entries for one server cause confusing duplicate-auth behavior.

If something goes wrong¶

No "Add custom connector" option — even as the Owner¶

Custom connectors are supported on Team plans — this isn't a plan limitation. On a Team plan the add flow simply isn't on the personal Settings → Connectors page (that page has no "Add custom connector" button). The Owner adds Hadron from Organization settings → Connectors: click Add, hover Custom, then choose Web and paste the URL. If the Owner clicked Add and only saw a directory of pre-built connectors, they missed the Custom → Web submenu — that's the usual reason it looks unavailable.

Regular members can't add custom connectors at all; ask an Owner. Once Hadron is added, it appears in your Settings → Connectors with a Custom label for you to Connect and sign in (Step 3).

Disconnect the connector and click Connect again to restart the OAuth flow. If your browser blocked the popup, allow popups for Claude and retry.

`h-list-memories` returns nothing¶

An empty list means you're connected but your account can't reach any memories yet. If you've just created your account and aren't in an organization, that's expected — join or create an org and its shared memories will appear (no agent install required). If you are in an org and still see nothing, confirm you're signed in to the same Hadron account that belongs to that org.

Claude asks which Hadron App to use¶

If your account belongs to more than one Hadron App, Claude may ask which one to use the first time it needs one. Answer with the App you want — read-only tools like h-list-memories and h-read-node work without picking one.