> For the complete documentation index, see [llms.txt](https://help.cubelet.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.cubelet.ai/platform-and-integration/connecting-a-client/claude.md).

# Claude

*Connect Claude Code, Claude Desktop, or claude.ai to a cubelet.ai MCP server.*

## Claude Code (CLI)

Claude Code registers remote MCP servers with `claude mcp add`. The cubelet.ai fleet authenticates with a bearer token (see Auth & access), which you attach with the `--header` flag:

```bash
claude mcp add --transport http cubelet-manufacture \
  https://manufacture.cubelet.ai/mcp \
  --header "Authorization: Bearer ${CUBELET_MCP_TOKEN}"
```

Replace the URL with the `/mcp` URL of the server you picked from the MCP servers page.

Avoid hardcoding secrets: Claude Code expands `${VAR_NAME}` inside header values, so reference an environment variable rather than pasting the raw credential into the command or into a checked-in config file.

### Scope

* `--scope local` (default) — visible only to you, only in the current project.
* `--scope project` — written to `.mcp.json` and shared with everyone who has the project; don't commit real credentials this way.
* `--scope user` — available to you across every project.

### Managing the connection

```bash
claude mcp list
claude mcp get <name>
claude mcp remove <name>
```

If a server enforces an OAuth sign-in instead of a static header, Claude Code detects the 401 challenge automatically — run `/mcp` inside a session to complete the sign-in.

## Claude Desktop and claude.ai (custom connectors)

Claude's connector UI (Customize → Connectors → **Add custom connector**) registers a remote MCP server by URL, and its advanced settings only accept OAuth client credentials — there is no field for a static header. Because the cubelet.ai fleet currently authenticates with a static bearer token, fleet servers are not reachable from Claude Desktop or claude.ai connectors today. Use Claude Code (above) or Cursor, both of which attach static headers directly.