Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Troubleshooting

Each entry below ends at a verifiable state, usually a safe read confirmed in Audit.

Connection

The client cannot reach Stackyapper
Confirm the endpoint first. ChatGPT uses https://mcp.stackyapper.dev. Claude, Codex, and most other AI clients use https://mcp.stackyapper.dev/mcp.
Workspaces with a verified custom access domain must use the origin the portal shows on the AI clients page instead of mcp.stackyapper.dev; the same path rules apply.
ChatGPT says "Something went wrong with setting up the connection."
ChatGPT shows this error when connector setup fails, most often because /mcp was appended to the URL. ChatGPT must use the root URL https://mcp.stackyapper.dev; with /mcp appended it receives the full generic tool surface, and the oversized response makes setup fail. Remove the path and create the connector again.

Authorization

OAuth keeps looping
Try the cheapest fix first: complete a fresh sign-in in the same client and check that the expected workspace is shown on the Stackyapper consent page. If the loop continues, remove the Stackyapper connection from the AI client, add it again, and authorize from scratch.
The client asks me to authorize again
Stackyapper OAuth authorization is long-lived (see the note on the Claude page), but a user or workspace administrator can revoke it sooner. If authorization is requested unexpectedly, confirm that access was not revoked and then complete a fresh sign-in. Routine Stackyapper deployments should reconnect automatically and should not require reauthorization.

Apps and credentials

An app shows a status other than Connected
The two most common cases:
  • Needs attention: the provider credential may have expired or been revoked. Reconnect the app from the Stackyapper portal, run one safe read, and verify the result in Audit. If reconnecting does not change the state, confirm the provider account still has access to the intended tenant.
  • Configured but not yet Connected: the credential is saved, but Stackyapper does not yet have a complete provider verification signal. Run the smallest available read and review Audit. Do not test with a write operation.
For every other status — Ready to configure, Admin setup required, Approval required, Platform setup required — see App status and ownership for what the label means and who can act on it.

Permissions

The client is connected but tools are missing
Seeing only a handful of stackyapper_ tools is expected. Most AI clients receive a small set of router and workflow tools and discover the full authorized catalog on demand — see What your AI client sees. Ask the client to search Stackyapper for the operation you need before concluding anything is missing.
If a search finds no permitted operation, the user may genuinely lack an app or tool grant. Ask a workspace administrator to check Apps and Users & Groups in the portal.
A grant changed but the client still sees the old tools
AI client sessions pin their tool catalog when they connect, and Stackyapper does not push catalog updates into a live session. After an administrator changes app or tool grants, start a new conversation or disconnect and reconnect the client, then retry. Tools discovered through stackyapper_search_tools always reflect current access.
A portal page is missing
Stackyapper hides pages that the current role cannot use. Owners manage billing, identity, and domains. Owners and administrators manage shared apps, access, and Audit. See Roles and page access.
A call is denied
Check the active workspace, app availability, group and direct user grants, explicit restrictions, and confirmation requirements. Do not grant an entire app until you identify the exact missing tool.
A call fails after working previously
Check whether the app now needs attention, whether the provider is experiencing an outage, and whether the provider account or tenant scope changed. Use the Audit timestamp to correlate the attempt.
An operation asks for confirmation
Stackyapper requires confirmation for approved risk classes. Review the proposed operation carefully. The confirmation is bound to that operation.

Keys

An API key was copied to the wrong place
Revoke the API client immediately. Create a replacement, store it only in the intended client's secret store, and verify the replacement in Audit.

Still blocked?

Capture the client name, approximate time, active workspace, and the exact error message. Do not include provider secrets, OAuth tokens, or MCP API keys. Then contact Stackyapper support with those details.