FAQ & Troubleshooting
Frequently asked questions and solutions to common issues.
Diagnostics & troubleshooting
| Symptom | Likely cause & recommended solution |
|---|---|
| 401 Unauthorized | Expired or revoked MCP token. Generate a new token in Settings › MCP Connections. |
| “Missing write scope” | The token was created with read-only permissions. Create a token with write access. |
| Agent detects no tools | Verify that the endpoint ends in /api/mcp and restart your Claude or Cursor client. |
| 429 Too Many Requests | 60 req/min rate limit exceeded. Wait a few seconds before retrying. |
| “Insufficient permissions” | Your role does not possess the capability for this action on the target project. |
Frequently asked questions
- Can I recover an MCP token after creation? No, tokens are stored as irreversible SHA-256 hashes. Generate a new one if lost.
- Can external agents view private notes of other members? No, agents strictly adhere to the permissions of the authenticated user.
- Do MCP tools consume AI credits? No, MCP tools operate as direct API gateways without consuming LLM generation credits.
- Is organizational data segregated? Yes, every request is strictly tenant-scoped to your organization.
Recommended testing tool
Use the official MCP Inspector to test your server setup: npx @modelcontextprotocol/inspector.