Troubleshooting & Fixes
info
Most connection issues come down to one thing: reconnect the connector and re-enter your Client ID and Secret Key. Try that first if you're in a hurry.
| Symptom | Cause | Fix |
|---|---|---|
| Connector won't register or reach the server | Wrong or mistyped base URL | Confirm the URL is exactly https://ai.shuftipro.com/mcp |
401 on a tool call | Access token expired | Reconnect the connector to refresh it |
tool_not_permitted | Connection wasn't authenticated with a valid Client ID and Secret Key | Reconnect and complete the sign-in step with your API keys |
text_confirmation_required from initiate_consent_verification | No text given and the default wasn't confirmed | Pass text, or resend with confirm_use_default_text="1" |
| Verification calls fail after connecting | Stale or incorrect API keys | Go to Backoffice → Settings → API Configuration → API Keys, re-copy your Client ID, generate a fresh Secret Key if needed, and reconnect |
429 while connecting | Rate limited | Wait briefly and retry |
| Timeout on an offsite call | Large base64 proof upload | Retry with a smaller file, or use the onsite journey instead |
| Knowledge tools return nothing useful | Query too narrow, or content gap | Rephrase, or try search_shufti_knowledge with broader terms |
Shufti <service> API error | Shufti API rejected the request | Check the details field against the relevant service docs |
tip
Still stuck?
- Double-check your Client ID and Secret Key match what's in Backoffice → Settings → API Configuration → API Keys.
- If tools are missing, confirm you completed the sign-in step and entered valid API keys when connecting.
- Try disconnecting and reconnecting the connector, since this resolves most token and permission issues.