Troubleshooting
Tools do not appear in my AI app
| Check | What to do |
|---|---|
| MCP URL | Use https://mcp.cortexhub.ai/v1/mcp (include /v1/mcp). |
| OAuth | Complete sign-in and select Allow access on the CortexHub consent screen. |
| Toolkit not connected | In CortexHub Cloud, My space -> Toolkits, connect the integration (Slack, Gmail, etc.). |
| Toolkit not published to you | Ask your org admin to enable the toolkit for the organisation and publish it to a group you belong to. |
| Agent blocked | An org admin may have blocked the gateway identity. Check with your admin. |
"Connection required" or connect prompts
The gateway found a tool you are entitled to, but you have not connected vendor credentials for that toolkit yet. Open My space -> Toolkits in CortexHub Cloud and complete the connect flow, or finish the Connect prompt your assistant shares in chat.
Policy denied or approval required
These are normal governed outcomes, not connection failures:
- Policy denied: a group access rule blocked the action. Ask your org admin if you believe you should have access.
- Approval required: the action needs a human decision. Use the assistant's approval flow or ask an approver to check the org Approvals inbox.
See Groups and access and Policies and approvals.
Tool call failed after you approved (CREDENTIAL_REFRESH_FAILED)
If the assistant parked an action for your approval, you approved it, and the call failed with CREDENTIAL_REFRESH_FAILED, the approval succeeded but the toolkit connection could not refresh its OAuth tokens. Open My space -> Toolkits, reconnect the toolkit, then ask the assistant to try again.
Sign-in or consent errors
| Symptom | What to do |
|---|---|
| "Couldn't register with Cortexhub's sign-in service" (Cursor) | Remove the MCP server, add it again with URL https://mcp.cortexhub.ai/v1/mcp, and retry. If it persists, paste a pre-registered OAuth Client ID in Cursor's connector settings (create one via My space -> Developer in CortexHub Cloud, or ask support). |
| Consent session expired | Start the connection again from your AI app. |
| Cannot sign in | Use the email address on your organisation invitation. If you were not invited, ask your org admin to add you. |
| Already decided | The consent was already approved or denied; remove and re-add the MCP server in your app. |
Still stuck?
- Org members: contact your org admin.
- Org admins: see the Admin guide or email support@cortexhub.ai.
Developers integrating programmatically: see SDK errors and Outcomes.