Skip to main content

Troubleshooting

Auth and billing​

SymptomLikely causeFix
401 on every callToken incomplete, trimmed, or wrong header shapeRe-copy the full token from API Settings. Cursor / Claude: Authorization: Bearer <token>. Codex: export MASSED_COMPUTE_API_KEY before launching the GUI.
401 then a browser loginClient is using MCP OAuth, not a pasted tokenExpected. Finish sign-in and consent. Review the grant under Connected Apps.
Auth error -32001 on tool callsMissing/invalid Authorization headerUse exact Authorization: Bearer <token> (capital Bearer). Raw token or lowercase bearer is rejected on tools/call.
Tool list missing launch / terminate / SSH writesRead-only API key or read-only OAuth grantExpected. Create a full-access key, or reconnect the app and approve full access.
Client never shows an OAuth promptToken already in config, or old clientRemove the Authorization header if you want OAuth. Confirm the client supports HTTP MCP + OAuth.
402 on launchBilling not configuredSet recharge amount and threshold under Billing.

Client setup​

SymptomLikely causeFix
Cursor shows red MCP statusBad token, bad JSON, or Cursor older than 0.45Fix token/JSON; update Cursor (HTTP MCP needs 0.45+).
Claude Desktop shows no tools / fails with a raw urlDesktop speaks stdio MCP onlyUse the npx -y mcp-remote … bridge on the Claude Desktop tab. Fully quit and reopen.
Codex / ChatGPT: enabled but tools auth-failEnv var not visible to the GUI processSet MASSED_COMPUTE_API_KEY where the app inherits it (export + launch the app executable from that terminal, or launchctl setenv for the GUI login session). Fully quit first, then launch with that environment; see client setup. bearer_token_env_var alone is useless if the var is unset.

Inventory and launch​

SymptomLikely causeFix
Image incompatible errorImage fabric/driver mismatch for the GPUPick another image or product. SXM-only images do not run on PCIe cards and vice versa. Use images_list to find a current compatible image, or use the image selected by the setup recipe.
Launch fails with thin -32602 despite capacityCapacity race or product/image pairingRe-check gpu_inventory_list, try the next available SKU, select a compatible imageId from images_list or the setup recipe.
instances_get with a bad UUID returns []Soft missConfirm the instance id from instances_list.
Rate-limit (429)Hitting request limitsWait about a minute and retry.
Coupon tools say a required field is missing when you passed codeField name is couponUse { "coupon": "..." }, not code.

Direct HTTP / scripts​

SymptomLikely causeFix
Python / some HTTP clients get Cloudflare 1010Bot User-Agent blocked at the edgeSet a normal browser or curl User-Agent; default Python-urllib is blocked.

Known eng issues​

These are server-side quirks — work around them rather than treating them as setup mistakes:

SymptomWorkaround
ssh_keys_create returns -32602Use an existing marketplace SSH key for launch. Do not treat create-key as a first-run step.
recipes_search / recipes_get bad input → -32603Retry with a valid query/slug. Empty, unknown, or very long inputs may return an internal error instead of clean validation.
ssh_keys_delete bad id → {}Confirm via ssh_keys_list; do not trust an empty object alone.

If you're still stuck, reach out via Discord or Support.