Skip to content

fix: match Claude connector setup instructions to the current dialog - #373

Merged
neSpecc merged 2 commits into
mainfrom
fix/mcp-claude-connector-instructions
Oct 28, 2026
Merged

neSpecc merged 2 commits into
mainfrom
fix/mcp-claude-connector-instructions

Conversation

@neSpecc

@neSpecc neSpecc commented Oct 28, 2026

Copy link
Copy Markdown
Member

Problem

The Claude setup instructions added in #371 don't match the "Add custom connector" dialog in Claude Desktop and claude.ai:

  • the dialog asks for a name first, then the URL;
  • /mcp answers 401 without a token, so the dialog preselects OAuth sign-in ("Sign in now"). While OAuth sign-in is selected, the authorization request header is reserved and can't be added.

Changes

  • The Claude instruction now says: Customize → Connectors → Add custom connector, enter a name and the server URL, choose "No sign-in" in Authentication, then add the authorization request header.
  • The block shows the server URL and the header value (Bearer ntx_…) separately, each with its own Copy button.
  • Claude Code and Cursor instructions are unchanged.

Per the Claude connector docs, a server that uses an API key needs "No sign-in" with the key in Request headers. authorization, x-api-key and x-auth-token are allowed for every connector. Claude sends the value exactly as entered, so it includes Bearer .

Checks

  • vue-tsc --noEmit and eslint on the changed component pass.
  • Checked in the browser against a local API: after creating a token, the Copy buttons copy the URL and Bearer ntx_…; no horizontal scroll at 375px width.
  • Not checked yet in the real Claude dialog that authorization becomes available with "No sign-in".

The custom connector dialog in Claude Desktop and claude.ai asks for a
name and URL first and reserves the authorization header while OAuth
sign-in is selected. The instructions now say to choose "No sign-in"
and add the authorization header, and show the server URL and the
header value as separate values to copy.
@vercel

vercel Bot commented Oct 28, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
codex-ui Ready Ready Preview Oct 28, 2026 5:22pm UTC

@neSpecc
neSpecc merged commit 1918eda into main Oct 28, 2026
6 checks passed

This branch was successfully deployed

1 active deployment
Preview — 5128d8da Deployed Oct 28, 2026 by vercel[bot]
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