Orbicue MCP Setup Guide

PUBLIC DOCUMENTATION

Connect your agent to the board in five minutes.

Orbicue exposes a Streamable HTTP MCP endpoint. Give a compatible client your endpoint and MCP Client ID, then verify tool discovery.

PRODUCTION ENDPOINThttps://orbicue.com/mcp

Use the Mcp-Client-Id request header whenever your client supports custom headers.

Copy your MCP Client ID

Open an Orbicue workspace and copy the MCP Client ID shown in the sidebar.

Configure your client

Prefer user-level configuration so the credential never lands inside a project repository.

Claude Code

HTTP

Connect directly, then restart the client so it discovers Orbicue's tools.

TERMINAL

claude mcp add --scope user --transport http orbicue \
  https://orbicue.com/mcp \
  --header "Mcp-Client-Id: YOUR_CLIENT_ID"

Cursor

HTTP

Add a remote MCP server with the endpoint and header below. Prefer Cursor's user-level MCP settings.

MCP CONFIG

{
  "mcpServers": {
    "orbicue": {
      "url": "https://orbicue.com/mcp",
      "headers": {
        "Mcp-Client-Id": "YOUR_CLIENT_ID"
      }
    }
  }
}

Claude Desktop

BRIDGE

Claude Desktop uses stdio, so Node.js and the mcp-remote bridge are required.

CLAUDE_DESKTOP_CONFIG.JSON

{
  "mcpServers": {
    "orbicue": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://orbicue.com/mcp",
        "--header", "Mcp-Client-Id:YOUR_CLIENT_ID"
      ]
    }
  }
}

Verify tool discovery

Test the server directly before debugging client configuration.

TERMINAL

curl -sS -X POST "https://orbicue.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Mcp-Client-Id: YOUR_CLIENT_ID" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

A successful JSON-RPC response includes a result.tools array. Restart your client after configuration so it runs discovery again.

Fix the common failures

The response usually tells you which layer needs attention.

401 Unauthorized: Re-copy the Client ID from the Orbicue sidebar and confirm your account belongs to a project.
No tools found: Fully restart the MCP client. Tool discovery normally runs only when the connection starts.
Tools never run: Switch the client to Agent mode and approve the requested tool call.
Claude Desktop cannot spawn npx: Install Node.js or configure the absolute path to npx.cmd on Windows.

Keep destructive tools such as task deletion behind manual approval. MCP actions use the same project access as your Orbicue identity.

Ready to connect?

Open Orbicue, copy your MCP Client ID, and keep the setup page beside your client configuration.