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