Skip to main content

Connect Claude Code

Tested 2026-09-28

Tested end to end with Claude Code 2.1.283: the server connected over OAuth and all five tools returned results.

Before you start​

  • Claude Code.
  • A NameBeta account, or create one on the sign-in page during setup.

Add the server​

claude mcp add --transport http namebeta https://namebeta.com/api/mcp

namebeta is the local name Claude Code shows for the server; pick any name you like. By default the server is added for the current project only, on your machine. Use --scope to change that:

ScopeWhere it is savedWho gets it
local (default)Your user settings, keyed to the current projectYou, in this project
userYour user settingsYou, in every project
project.mcp.json in the project root, meant to be committedEveryone who opens the project

For example, to have NameBeta in every project:

claude mcp add --transport http --scope user namebeta https://namebeta.com/api/mcp

The configuration holds only the URL. Tokens are stored by Claude Code on each machine, so a committed .mcp.json never contains credentials — each teammate signs in with their own NameBeta account.

Sign in​

  1. Start Claude Code and run /mcp.
  2. Select namebeta and choose Authenticate. Your browser opens the NameBeta sign-in page.
  3. Sign in and approve access. The browser tells you when you can return to the terminal.

claude mcp list should now show the server as connected:

namebeta: https://namebeta.com/api/mcp (HTTP) - ✔ Connected

Try it​

> Which TLDs are still free for brewlab? Of the taken ones, which are for sale?

Claude Code runs check_availability. The answer should mix taken, for-sale and available domains — on 2026-09-29, brewlab.com was taken, brewlab.co for sale and brewlab.info available. A mix like that comes from a live lookup; The tool's example shows the full result.

Disconnect or switch account​

  • claude mcp remove namebeta removes the server (add -s user or -s project if you used that scope).
  • To sign out without removing the server, open /mcp, select namebeta and clear the authentication. To sign in as a different NameBeta account afterwards, see Switch accounts.

If it does not connect​

See Troubleshooting if authentication fails.