Skip to main content

Set up your client

Endpoint: https://vm.massedcompute.com/api/mcp
Auth: Authorization: Bearer <token>

Two ways to authenticate:

  • API token — paste a Bearer token into the client config. Snippets below use MC_TOKEN as a placeholder; replace it with the API token from API Settings. Restart the client after saving (full quit and reopen for Codex / Claude Desktop).
  • OAuth — some MCP clients (Claude, Codex, ChatGPT) discover OAuth from https://vm.massedcompute.com/api/mcp when no token is sent. Sign in, approve full or read-only, then manage the grant under Connected Apps.

Use the tabs for the API-token path. Setup images are schematic illustrations; menu names and layout may vary by client version.

Before you start

Create a read-only key if the assistant only needs to inspect inventory, billing, and instances. Create a full-access key if it needs to launch, restart, terminate, or manage SSH keys.

The fastest path is the CLI:

claude mcp add --transport http massed-compute \
https://vm.massedcompute.com/api/mcp \
--header "Authorization: Bearer MC_TOKEN"

This registers the server globally. Run claude from any project and ask "list my Massed Compute instances" — Claude Code discovers and calls the tools automatically.

To configure by hand instead, edit ~/.claude.json (global) or .mcp.json in a project root:

{
"mcpServers": {
"massed-compute": {
"type": "http",
"url": "https://vm.massedcompute.com/api/mcp",
"headers": {
"Authorization": "Bearer MC_TOKEN"
}
}
}
}

Useful commands: claude mcp list shows registered servers, claude mcp remove massed-compute uninstalls, and claude --debug traces tool list/call activity if something looks off.

Example tool list and response​

These are client-neutral illustrations rendered from synthetic data, not captures of Cursor, Codex, or Claude Desktop. Your client's layout will differ. All identifiers in the response are placeholders; no VM was launched to make this example.

Client-neutral illustration of the Massed Compute tool list Client-neutral illustrated response with a zero UUID and reserved documentation IP

Verify you're connected​

Ask your assistant:

  • "Validate my Massed Compute API key"
  • "List my running Massed Compute VMs"
  • "Search setup recipes for Jupyter"

If it returns real account data (or a recipe list), you're wired up. If not, see Troubleshooting.

What's next​