From 253ff1ad941bab09f3f7b988ab4ae75ed3c5ae6f Mon Sep 17 00:00:00 2001 From: scot Date: Sat, 18 Jul 2026 07:21:19 +0000 Subject: [PATCH] docs: claude.ai custom connector instructions (query-param key, header-beta alternative, cloud-origin note) --- docs/USER-GUIDE.md | 36 ++++++++++++++++++++++++++++++++---- 1 file changed, 32 insertions(+), 4 deletions(-) diff --git a/docs/USER-GUIDE.md b/docs/USER-GUIDE.md index 9df1b39..5dc9ea0 100644 --- a/docs/USER-GUIDE.md +++ b/docs/USER-GUIDE.md @@ -102,16 +102,44 @@ whichever AI you already use, and it operates the platform with exactly the permissions of the key you give it. **Endpoint:** `POST https:///mcp` (Streamable HTTP) -**Auth:** `Authorization: Bearer ` header +**Auth:** either an `Authorization: Bearer ` header, **or** the +key as a URL parameter: `https:///mcp?api_key=` — for +hosts whose connector setup can't send custom headers. + +### Claude (claude.ai web / desktop / mobile) + +1. Go to **Settings → Connectors** (on Team/Enterprise plans an Owner adds it + first under Organization settings → Connectors; members then connect + individually) +2. Click **+ Add custom connector** +3. Name it (e.g. "Demos") and paste the URL **with your key included**: + `https:///mcp?api_key=dp_yourkeyhere` +4. Click **Add**. If your account shows a **Request headers** section in the + dialog (beta feature), you can instead use the plain URL + `https:///mcp` and add a header `Authorization` = + `Bearer dp_yourkeyhere` — functionally identical; prefer it when available + since the key stays out of the URL. +5. In a conversation, open the **+ / connectors** menu and enable the + connector, then just talk: "list my demos". + +Notes: Claude connects to the server **from Anthropic's cloud**, not your +device — the platform must be reachable on the public internet (a normal +HTTPS deployment is fine; a laptop-only or VPN-only instance is not). The key +in the URL is visible to anyone who can see your connector settings — treat +the connector entry like a stored credential, and use a key with only the +scopes you want this assistant to have. + +### Claude Code (CLI) -**Claude Code:** ``` claude mcp add --transport http demos https:///mcp \ --header "Authorization: Bearer dp_yourkey" ``` -**Other MCP hosts:** any host supporting Streamable HTTP remote servers with a -custom auth header works the same way. +### Other MCP hosts + +Any host supporting remote Streamable HTTP servers works — use the header +form if the host supports custom headers, the `?api_key=` URL form if not. **What your agent sees** depends on the key's scopes. With `read,author` it can inspect demos and analytics, write and revise every tooltip, place hotspots,