Skip to content

The MCP clients page has checked entries for nine more agents and the hosted builders' routes - #695

Merged
zlareb1 merged 22 commits into
mainfrom
docs/agent-clients-section11
Nov 16, 2026
Merged

zlareb1 merged 22 commits into
mainfrom
docs/agent-clients-section11

Conversation

@zlareb1

@zlareb1 zlareb1 commented Nov 15, 2026 •

Copy link
Copy Markdown
Member

Changelog category (leave one):

  • Documentation (changelog entry is not required)

Changelog entry (one or two sentences a user of Loom can read without the diff; the release pull request collects these into the release notes):

...

Why

The MCP clients page listed many agents whose entries had never been checked against the client itself, and several rows were out of date with the clients' current docs. An agent or a person asking "how do I add Loom to " gets the page's answer, so a wrong flag or path there is a failed setup.

Each client that installs without a paid sign-in was installed into a scratch home directory, given the Loom entry the page documents, and checked with its own status command against a local Loom 1.2.0 with a bearer token (no model calls):

Client Result Check
Qwen Code 0.27.3 connected qwen mcp list
goose 1.59.1 starts goose doctor loads the extension (a bad token makes it fail to start)
Factory droid 1.12.1 connected droid mcp list, 21 tools
Hermes Agent 0.23.1 connected hermes mcp test loom, 21 tools
OpenClaw 2026.9.2 connected openclaw mcp probe, 21 tools
smolagents 1.26.0 connected MCPClient with headers lists 21 tools (needs mcp<2)
Strix 1.7.0 connected (its MCP client from Python) no status command
Amp 0.0.1794715238 entry accepted amp mcp doctor needs a sign-in
Auggie 0.37.1 entry accepted auggie mcp list marks even an unreachable URL as fine

Kimi Code CLI, Junie CLI, Zed, Warp, Grok Build CLI and n8n were not checked: each needs a sign-in, a desktop app, or a model run to connect.

Each row below was compared with the client's own documentation.

Changed rows

  • Kiro: Kiro CLI replaced the Q Developer CLI and copies ~/.aws/amazonq/mcp.json once, when it is installed; ${VAR} in headers expands only once the variable is in its approved list; the install link format.
  • Amp: it has a --header flag.
  • Auggie: --header "Authorization:Bearer <JWT>", the KEY:VAL form Auggie's docs use; its list does not probe the URL.
  • Hermes: --auth header saves the token to .env.
  • smolagents: headers, and the mcp<2 constraint.
  • Antigravity: url also works.
  • Kimi: project .kimi-code/mcp.json, the /mcp-config command and bearerTokenEnvVar.
  • n8n: the MCP Client Tool node sits on an AI Agent node; its Endpoint field, and the token in a Bearer Auth credential.
  • OpenCode: the 2.x mcp.servers shape beside the 1.x opencode-ai one, which 2.x still reads; the files it reads.
  • goose: the goose configure route, and the desktop deeplink in goose's documented form (type=streamable_http, an id, the header URL-encoded), with a note that the link holds the token; its check is starts (goose doctor), defined in the legend.
  • Warp: the project .warp/.mcp.json file and the Settings route.
  • Grok Build: it reads ~/.claude.json and .cursor/mcp.json, behind its [compat.*] switches.
  • Cursor's agent CLI: a line that it reads the editor's mcp.json.

New rows (eight of them unchecked)

  • OpenClaw, Strix.
  • Continue: "no longer actively maintained", as its repository says, here and in the integrations index and the generic transcript template's README (which already listed it).
  • Open WebUI (its menu path), Cherry Studio (JSON import with url; it switches the import on itself), LM Studio, Jan, Crush (an mcp add line in its crushrc), Mistral Vibe, the Amazon Q Developer IDE plugins.
  • LibreChat v0.8.8, marked qualified with a link to its qualification cases; the legend says what qualified means.

Hosted builders and chat apps (their own heading, ### Hosted builders and chat apps, and a row in the integrations index; the intro allows a provider's tunnel)

  • claude.ai and Claude Desktop: a static Authorization header under Request headers where the dialog shows them, otherwise the browser sign-in.
  • ChatGPT: custom connectors take no custom headers, so a public HTTPS Loom with OAuth, or its Secure MCP Tunnel.
  • GitHub Copilot cloud agent: a COPILOT_MCP_ secret.
  • Replit: the install-link format, sign-in through /oauth/register.
  • v0: a bearer token under 1000 characters; a longer JWT goes under Custom Headers.
  • Make: Bearer <JWT>, with a pointer to the prefix check, as for the other providers whose docs do not say.
  • Le Chat: admins only; Mistral's docs now call the app Work; choose its combined HTTP Bearer Token / Basic Auth option and enter the token as a bearer token, since Loom refuses Basic.
  • Perplexity: its published connector docs offer an API key or no authentication, without naming the header; the key is entered as Bearer <JWT> with the prefix check linked, and Loom's dynamic registration issues public clients with no secret (that route is untested).
  • Grok: xAI's docs name OAuth and API keys but not the header; a key is entered as Bearer <JWT> with the prefix check linked.
  • Copilot Studio, Lovable, n8n, Dify, Flowise, Langflow, Zapier: a line or a short entry each; Copilot Studio and Make say what their docs leave out, and Lovable, v0 and Zapier link the prefix check.

Bearer or bare token

  • A table tells the refusals apart by the error the provider shows: a doubled prefix (contains Invalid header), a value that is not a JWT such as an unexpanded ${VAR} (invalid token header:), a missing Bearer scheme or an empty token (authorization header must be `Bearer <token>` ), no header at all (missing bearer token), an expired or revoked token (mint a new one), and a 503 that asks for a retry (keys or revocation list not loaded or stale). A refused-token 401 carries error_description; a missing-header 401 does not.

The Checked column records the results above.

Scope and risk

Docs only: docs/features/integrations/mcp-clients.md, docs/features/integrations/index.md and integrations/generic/README.md. The diff adds 19 table rows (18 on the clients page, including the seven-row token-error table, 1 in the integrations index), edits about 17 others and adds the hosted-services list; it is larger still because Prettier realigns every column. Two of the unchecked rows follow their vendor's current docs rather than older JSON forms: Crush reads mcp add lines from a crushrc file and calls its crush.json format deprecated (its README), and Mistral Vibe documents the [mcp_servers.auth] table with type = "static" (its MCP servers page), still accepting the older flat keys.

Compatibility, rollout and rollback

  • Wire: none.
  • Operator steps: none.
  • Rollback: revert.

Tests

  • tests/unit/test_doc_links.py, test_public_copy.py, test_agent_instructions.py: 445 passed. Prettier and check_prose.py: clean.
  • The client checks above (scratch home directories, deleted afterwards).

AI assistance in the code (leave one; writing this description with AI is fine):

  • AI-generated (an agent wrote most of the diff): Claude Code installed and checked each client and compared each row with the client's documentation.

  • I can explain every line of this diff and how it interacts with the rest of Loom.

Checklist

  • make format-check, make lint, make typecheck and make test-unit pass; the integration suite passes if server behaviour changed. (Docs only: ran the doc tests above; CI runs the rest.)
  • Docs under docs/ describe the system as it now is, and this description names any operator steps and wire changes.
  • Repository text has no dates, people, host names, internal namespaces, ticket or decision numbers; the history goes in this description (tests/unit/test_public_copy.py).
  • Commits are signed off (git commit -s), as CONTRIBUTING.md asks.

🤖 Generated with Claude Code

zlareb1 and others added 2 commits November 15, 2026 09:02
… hosted builders' routes

Qwen Code, goose, Factory droid, Hermes Agent, OpenClaw, smolagents and
Strix connected to a local Loom with a token through their own status,
test or client calls; Amp and Auggie accepted the entry. The page now
gives Amp's --header flag, the Hermes token prompt and its env key, the
smolagents headers key and its mcp<2 pin, rows for OpenClaw and Strix,
the Kiro CLI rename and install link, and where Replit, Lovable, v0,
Le Chat, Perplexity and ChatGPT take a custom server. The integrations
map says Continue is no longer maintained.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
…en more local clients

Adds rows for Open WebUI, Cherry Studio, LM Studio, Jan, Crush, Mistral
Vibe and the Amazon Q Developer IDE plugins, and a route for each hosted
builder the section names, including Microsoft Copilot Studio, the GitHub
Copilot cloud agent and the claude.ai request-header connector. Status
checks move to the Checked column, goose gets its own `starts` label, and
the Kimi, Kiro, Auggie, Warp, v0, Le Chat, Perplexity and Replit entries
match their docs. Continue is named with its final 2.0.0 release.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
@zlareb1
zlareb1 force-pushed the docs/agent-clients-section11 branch from 7b46d07 to 63cf55e Compare November 15, 2026 09:02
zlareb1 and others added 9 commits November 15, 2026 09:33
…dor's auth limits as documented

goose takes the Authorization header from goose configure or its deeplink;
smolagents' ToolCollection.from_mcp needs trust_remote_code=True; Grok Build's
Claude Code and Cursor fallbacks and their switches are named; Kiro's env-var
and Kiro CLI notes follow Kiro's docs; OpenCode shows both its 2.x and 1.x
shapes; the claude.ai request-header limits, the v0 token cap's source, and
one bearer-or-bare check for Make, Copilot Studio and Grok are spelled out.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
…tudio's url key and words Continue one way

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
…iption, heads the hosted services and fixes the goose deeplink

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
… marks Perplexity's OAuth unchecked and fixes the v0, Make, Le Chat, Open WebUI and OpenCode routes

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
…is no longer maintained and wraps the hosted-services paragraph

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
… still reads the 1.x shape

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
…k on the shown error, links minting, and fixes the Le Chat, Cherry Studio and Continue rows

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
…udio switches an import on itself

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
…ic Auth option

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
…when Kiro copies the Q config and where n8n keeps the token

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
zlareb1 and others added 3 commits November 16, 2026 05:42
…r is still loading keys, and where Cherry Studio shows a failed connection

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
…ks for a retry, and says Perplexity's OAuth may refuse Loom's public clients

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
…ry error_description, and links the Perplexity report

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
zlareb1 and others added 7 commits November 16, 2026 06:01
…heck for Zapier, and states only what Loom's registration does for Perplexity

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
… and an ended sign-in, and the goose deeplink sits under the table

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
…lon and is read from the top

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
…and states Perplexity from its published connector docs

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
…nd Perplexity takes Bearer <JWT> as its API key

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
…n to pasting it again first, and notes ChatGPT workspace permissions

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
…, which servers with end-user issuers report

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
@zlareb1
zlareb1 merged commit 2c97763 into main Nov 16, 2026
52 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant