Troubleshooting

Common errors

Symptom	Cause	Fix
`401 Unauthorized`	Invalid or missing API key	Regenerate key at `app.morphic.io/home/{workspace}/settings/developers`
`401` on a valid key	Backend unreachable	Check `api.morphic.io` status; try `/health`
OAuth “No workspace found”	Account has no team workspace	Create a workspace at `app.morphic.io` first
Connector won’t load in Claude.ai	Cloudflare blocking root-level path	Use `/v1/mcp` not `/mcp` as the connector URL
Tools not showing in Claude Desktop	Config file syntax error	Validate JSON; restart Claude Desktop
`search_entities` returns empty	HydraDB index not built yet	Use `list_entities` with `search` parameter instead
OpenClaw fails to connect	Missing transport config	Add `"transport": "streamable-http"` to server config
Revoked key still accepted	Auth cache TTL	Wait up to 2 minutes for cache to clear
”Slug must contain only letters…”	Invalid characters in entity type slug	Use only `a-z`, `0-9`, `-`, `_` in slugs

Test the endpoint directly

# Health check
curl -s https://mcp.morphic.io/health | jq

# Ping tool
curl -s -X POST https://mcp.morphic.io/v1/mcp \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"ping","arguments":{}},"id":1}'

Rate limits

The OAuth authorize endpoint (/v1/mcp/authorize) is rate-limited to 20 requests per IP per minute. MCP tool calls are not rate-limited at the MCP layer — the Morphic backend may apply its own limits.

Getting help

Documentation: docs.morphic.io/mcp
Support: support@morphic.io

​Common errors

​Test the endpoint directly

​Rate limits

​Getting help

Common errors

Test the endpoint directly

Rate limits

Getting help