Camber MCP

Camber MCP

CamberCloud runs a remote Model Context Protocol (MCP) server. Register it in your editor or CLI with your Camber API token, then use tools such as agents_chat to talk to Camber agents with the same @mention tags as in Nova.

The page has four parts: Set up Camber MCP (shared for every client), MCP clients (Claude Code CLI, Claude Code VS Code extension, Cursor, and Claude Desktop), Context Mirror (sync local project context into Camber), and Camber MCP tools (technical reference).

Set up Camber MCP

ℹ️
Heads-up: To use the full Camber environment through Camber MCP, you need the Camber CLI on your computer. If you do not have it yet, Camber MCP setup will install the CLI for you. If you are not logged in to Camber, you will need to log in as well (your API key in the MCP client is for the remote server). See Installation for details.

Get your Camber API key

The value you pass as <YOUR_CAMBER_API_KEY> is your Camber API token:

  1. Log in to app.cambercloud.com
  2. Open your profile settings
  3. Copy your API token

For using that token with the Camber CLI (environment variable, one-off flags), see Login — API token.

Camber MCP server endpoint

Every client must use this HTTP MCP endpoint:

https://camber-mcp.cambercloud.com/mcp

Pair it with an Authorization header: Bearer <YOUR_CAMBER_API_KEY> (see above).

Shared MCP JSON (reference)

Most clients accept a server entry named camber-mcp with the same fields. This is the shape Claude Code uses in a project .mcp.json; Cursor often uses in a project .cursor/mcp.json.

{
  "mcpServers": {
    "camber-mcp": {
      "type": "http",
      "url": "https://camber-mcp.cambercloud.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_CAMBER_API_KEY>"
      }
    }
  }
}

Replace <YOUR_CAMBER_API_KEY> with your token from Get your Camber API key.

MCP clients

Claude Code, Cursor, and Claude Desktop all connect to the same Camber MCP server. Complete Set up Camber MCP first, then follow the subsection for your client. Agent addressing uses the same @mention tag formats as in Nova.

Claude Code

Claude Code is Anthropic’s agentic CLI (and related editor flows). Install and sign in per Anthropic’s documentation, then register the Camber server.

⚠️
Claude Pro (or eligible plan) required: Claude Code needs an active Claude Pro subscription or another plan that includes Claude Code. CamberCloud does not replace Anthropic’s requirements.

Global (all projects on this machine):

claude mcp add --transport http camber-mcp \
  https://camber-mcp.cambercloud.com/mcp \
  --header "Authorization: Bearer <YOUR_CAMBER_API_KEY>"

Project-only (current repository):

claude mcp add --transport http camber-mcp \
  https://camber-mcp.cambercloud.com/mcp \
  --header "Authorization: Bearer <YOUR_CAMBER_API_KEY>" \
  --scope project

Alternatively, add a project .mcp.json using the shared MCP JSON shape.

Use agents in Claude Code

In the Claude Code terminal, you can invoke Camber agents with the camber CLI pattern (your UI may show the agents_chat tool and JSON). Example:

camber @username.agent_alias Your question here

Example: camber @camberuser.titanic How many passengers?

Claude Code terminal: Camber MCP calling the Titanic agent via agents_chat

Claude Code for VS Code

If you use Claude Code through the VS Code extension, follow these steps:

  1. Create a .mcp.json file in your project root with the shared MCP JSON shape:
{
  "mcpServers": {
    "camber-mcp": {
      "type": "http",
      "url": "https://camber-mcp.cambercloud.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_CAMBER_API_KEY>"
      }
    }
  }
}
  1. Open a new Claude Code session or restart VS Code.
  2. In the Claude chat panel, type /mcp and select MCP servers.
  3. Click on camber-mcp and click Enable.

Use agents in the VS Code extension

Once connected, start a chat in the Claude Code panel. Address Camber agents the same way as in the terminal:

camber @username.agent_alias Your question here

Cursor

Cursor connects to MCP servers from Settings and/or JSON config files. Cursor’s MCP UI and file locations change between releases—use Cursor’s MCP documentation for the exact panel names on your version.

  1. Open Cursor Settings.
  2. Go to the Tools & MCPs section.
  3. Select Add a Custom MCP Server button.
ℹ️
Tokens and Git: Do not commit real API keys. Use a placeholder in committed .cursor/mcp.json and set your token locally, or rely on a private, gitignored override file if your team uses that pattern.

Use agents in Cursor

  1. Open Chat or Composer (or Agent mode, if available).
  2. Start a thread where MCP tools are allowed—Cursor should list tools from camber-mcp (for example agents_chat, agents_list).
  3. Address your agent with the same tags as in Nova: @<username>.<agent_alias> or @<teamname>.<agent_alias>.

If tools do not appear, confirm the server is enabled in MCP settings, your token is valid, and your Cursor build supports HTTP MCP for remote URLs.

Claude Desktop

Claude Desktop connects to MCP servers through its config file. Because Claude Desktop supports stdio servers, use mcp-remote (via npx) to bridge to the remote Camber HTTP endpoint.

⚠️
Prerequisite — Node.js: The setup below uses npx, which ships with Node.js. Install Node.js from nodejs.org/en/download before continuing, then verify with node --version and npx --version.
  1. Open Claude Desktop.
  2. Open Settings (from the menu bar, or the menu inside the app).
  3. Go to the Developer tab.
  4. Click Edit Config. Claude Desktop opens (or creates) the claude_desktop_config.json file and reveals it in your file explorer.
  5. Open claude_desktop_config.json in a text editor and add the camber-mcp server entry below (merge it into any existing mcpServers object):
{
  "mcpServers": {
    "camber-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://camber-mcp.cambercloud.com/mcp",
        "--header",
        "Authorization: Bearer <YOUR_CAMBER_API_KEY>"
      ]
    }
  }
}
  1. Replace <YOUR_CAMBER_API_KEY> with your token from Get your Camber API key, then save the file.
  2. Restart Claude Desktop (quit completely and reopen) so it picks up the new server.

Use agents in Claude Desktop

Once Claude Desktop restarts, you can call camber-mcp tools (for example agents_chat, agents_list) from chat box. Address your agent with the same tags as in Nova: @<username>.<agent_alias> or @<teamname>.<agent_alias>.

ℹ️
Output formats: Agents shared for Claude Desktop will use text or markdown output formats. Claude Desktop cannot render plots at this time.
ℹ️
No CLI access: Claude Desktop cannot access the CLI. If you need to run a CLI action — such as installing npm/npx or running a Camber CLI command — ask Claude Code to do it instead.

Camber MCP tools

The camber-mcp server currently exposes these tools:

ToolPurpose
user_infoShows the authenticated Camber user and available teams.
agents_createCreates a personal or team Camber agent.
agents_chatChats with a Camber agent by @owner.alias tag.
agents_listLists available Camber agents by scope.

Your MCP client also shows the live parameter schema for each tool.

user_info

Shows the Camber account connected to MCP, including your username, email, and teams. This is useful when you want to confirm which personal or team workspace your agents belong to.

Example response:

{
  "email": "user@example.com",
  "username": "camberuser",
  "teams": [
    {
      "display_name": "Research Team",
      "team_name": "research-team"
    }
  ]
}

agents_create

Create a Camber agent. Creates a personal agent by default; pass team_name to create the agent for a team you belong to.

ParameterDescription
nameDisplay name for the agent.
aliasAlias used in the agent tag, for example my-agent in @owner.my-agent.
descriptionOptional short description of the agent.
instructionsOptional instructions that define the agent behavior. For Context Mirror agents, this should include the synthesized workspace understanding.
team_nameOptional team unique name. Omit for a personal agent.
structured_outputWhether the agent should return structured output. Default is false.

agents_chat

Chat with a Camber agent by tag and message. Returns the agent’s reply as text.

ParameterDescription
agent_tagTag of the agent to use. Include the leading @; format is @<owner_name>.<agent_alias> (for example, @camber_user.ai-agent-1).
messageThe message to send to the agent.
model_idModel name for the agent run (for example, Haiku, Sonnet). Default is claude-sonnet-4-6.
conversation_idOptional existing conversation ID to continue a multi-turn thread.

Use agents_chat from Claude Code (for example via the camber CLI pattern shown above) and from Cursor when camber-mcp tools are available in Chat, Composer, or Agent mode.

agents_list

List Camber agents you can use, with optional scope and pagination. Returns agent metadata and page info (for example total count and page size).

ParameterDescription
scopeWhich agents to include: community (community agents), system (system agents), or team (agents for a specific team). Omit or leave unset to list your personal agents.
team_nameWhen scope is team, the team’s unique name. Ignored for other scopes.
pagePage number to fetch (default: 1).
sizeAgents per page (default: 20).