# Troubleshooting

> Causes of and fixes for connection, permission, missing tool, and rate limit problems.

| Symptom | Cause | Fix |
|---|---|---|
| Claude says "couldn't connect" | The URL is wrong, or the installation is running an old version. | Check that the URL is `https://<company>.solk.app/mcp` and that the `version` value at `https://<company>.solk.app/health` is `v22` or later. |
| The consent screen says "Uygulama tanınmadı" (app not recognized) | The client registration was deleted or belongs to another installation. | Remove the connector in Claude and add it again. |
| "Dönüş adresi bu uygulamaya kayıtlı değil" (redirect URI not registered for this app) | The client is using a redirect URI that differs from the one in its registration. | Re-register the client (remove the connector in Claude and add it again). |
| The connection drops after a while | The refresh token went unused for 60 days, or access was removed. | Grant access again with **Connect**. |
| Some tools are missing | A scope or module permission is missing. | Remove the connection and reconnect, granting both permissions; ask an admin for the module permission. |
| "Bu işlem için kayıt oluşturma / güncelleme izni gerekli" (create/update permission required for this action) | Only `crm.read` was granted. | When you reconnect, approve the write permission too. |
| The assistant can't find a record | The record is outside your visibility, or the company is inactive. | Check that you can see the record in the web app with the same user. |
| "Dakikalık istek sınırı aşıldı" (per-minute request limit exceeded) | Too many calls in a bulk operation. | Wait a minute; ask the assistant to work with a narrower filter. |
| License error | The installation's license has expired. | The connection works only for admins; renew the license. |

## Manual testing

To test the token and the server directly:

```bash
# 1) discovery (without a token, this should return 401 and resource_metadata)
curl -i -X POST https://ornek.solk.app/mcp -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"ping"}'

# 2) list tools with an API key
curl https://ornek.solk.app/mcp -H "Authorization: Bearer sk_…" \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
```

You can also use the official **MCP Inspector** (`npx @modelcontextprotocol/inspector`): enter the URL and step through the OAuth flow and the tools.