Troubleshooting
Find the problem you see, then apply the solution. The first rows come from a user's real attempts to connect Claude Code in October 2026.
Before you begin
- Know which client you use and which credential: a subscriber sign-in or a partner API key.
Connection
| Problem | Cause | Solution |
|---|---|---|
Claude Code: invalid_request, redirect_uri does not match the client's registered redirect URLs | A Client ID registered for Claude Desktop was used. Claude Desktop calls back to claude.ai; Claude Code listens on localhost | Do not set a Client ID in Claude Code. It registers its own |
| Removing the Client ID changed nothing | Claude Code keeps the old sign-in outside its configuration file | In /mcp choose the server, then Clear authentication. On Claude Code 2.1.186 or later you can run claude mcp logout lawatlas instead. Then authenticate again |
The server is not listed in /mcp | The server was added at a scope this project does not read, for example from a symlinked path | Add it with --scope user |
| The server is still not listed | The session started before the server was added | Restart Claude Code |
| OpenAI Codex cannot connect to the SSE address | Codex uses streamable HTTP | Use https://advisor.lawatlas.ai/api/mcp-http/mcp |
Credentials
| Problem | Cause | Solution |
|---|---|---|
| HTTP 401 | No credential, or the key is unknown, revoked, suspended or expired, or issued in another environment | Check LAWATLAS_API_KEY; check the key on the partner page |
FORBIDDEN: keys are paused | The owning organisation's AI Pro subscription is not active | Renew the subscription |
| A paid tool returns a sentence with a renewal link | A subscriber's AI Pro subscription has lapsed | Renew, or call renew_subscription for the link |
FORBIDDEN: not permitted from this network address | The key's client has an IP allowlist that excludes your address | Add your address on the partner page |
Calls
| Problem | Cause | Solution |
|---|---|---|
INSUFFICIENT_SCOPE | The partner client does not hold the tool's scope | Add the scope to the client |
TERMS_REQUIRED on a Hansard tool | The organisation has not accepted the current Hansard conditions | Accept them on the partner page |
RATE_LIMITED | The client used its calls for the minute or day | Wait retry_after_seconds |
TITLE_NOT_IN_FORCE | The title is not in force | Show the user the frl_link; Advisor does not serve its text |
| A response is cut short | It hit the response size limit | Page with the cursor, next_offset or next_from_paragraph the response gives |
Check it worked
Call health. A good response has "status": "ok".
What to do if it did not
Contact support with the tool, the time and any reference in the error (Support).