> ## Documentation Index
> Fetch the complete documentation index at: https://docs.morphic.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Fix common issues with the Morphic MCP connection.

## 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

```bash theme={null}
# 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](https://docs.morphic.io/mcp)
* Support: [support@morphic.io](mailto:support@morphic.io)