Connection troubleshooting
Work top to bottom: quick checks, then the specific symptom you are seeing.
Quick checks first
- Is the server up? Open
https://mcp.stackjack.io/healthin a browser or withcurl. A healthy response means the problem is in your tool's configuration or credentials, not the service. - Is the URL exactly right? It must be
https://mcp.stackjack.io/mcp— including the/mcppath. - Is the transport right? If your tool asks, choose Streamable HTTP (sometimes labeled just "HTTP"). Do not pick SSE or stdio.
"401 Unauthorized" on requests
A 401 means the request's credentials were rejected. Causes, roughly in order of likelihood:
| Cause | What happened | Fix |
|---|---|---|
| Tool has no valid credentials yet | A first 401 is normal for the sign-in method — it carries the information that tells the tool to open the browser sign-in | Let the tool prompt you to sign in; if it does not, re-add the server |
| Wrong or stale secret | Typo in the Client ID/secret or API key, or the secret was rotated | Re-enter the current value; ask an admin for the new secret if it was rotated |
| Credential used in the wrong lane | An API key sent as Basic auth, or a Client ID + Secret sent as an API key | Match the credential type to the header format — see authentication options |
| Credential revoked | An admin revoked the client or API key | Create/obtain a new credential |
| Your membership was revoked | Response says "Linked user access has been revoked" | Ask an admin — if intended to be restored, they reactivate you on the Team page and you sign the tool in again |
| App authorization revoked (shared apps) | An admin revoked that app for you (on the Team page → your member row → Connected apps) | Ask an admin to reinstate it |
| Idle session expired | The connection sat unused for 30+ days | Sign in again from the tool |
| Workspace deactivated | Everything fails for everyone | Contact StackJack support |
Errors during the browser sign-in
These appear as "access denied" results in your AI tool after the browser hop, each with a human-readable description:
| Message | Meaning | What to do |
|---|---|---|
| "No StackJack account found for this identity…" | Your sign-in identity is not linked to any StackJack workspace | Sign up at https://portal.stackjack.io/signup, or ask your team admin to invite you |
| "Your access to this tenant has been revoked. Ask your admin to send a new invite." | You were a member and were removed | Only an admin can restore you |
| "You are not a member of this StackJack tenant. Ask your team admin to invite you first." | Your identity resolved to the workspace but has no membership | Ask an admin for an invite |
| "This client is already linked to a different StackJack account. Reconnect with a fresh client registration." | The tool is reusing a registration that belongs to another user | Remove the StackJack server from the tool and add it again so it registers fresh |
If sign-in completed but your tool connected with almost no tools and stackjack_session_info reports pending_approval, you self-registered and are awaiting admin approval — see Self-registration and approving new members.
"403 Forbidden" on tool calls
A 403 with "No active connector subscriptions found" or "No connector credentials configured for your active subscriptions" means authentication worked but the workspace has no usable connector yet:
- The owner, a co-owner, or an Administrator needs to set up at least one connector on the Connectors page (which also activates its subscription).
- Even in this state, StackJack's built-in tools still work through the AI tool — you can check service status and open a support ticket before any connector is configured.
Connected, but tools are missing
- Pending approval — you self-registered and only see StackJack status tools. An admin approves you via Edit Tools on the Team page (details).
- Tool assignments — you only ever see tools you have been personally assigned, further limited by the credential in use (the effective set is the overlap of the two). Ask an admin to check your tools on the Team page and the credential's tools on MCP Setup.
- Plan tier — each connector's plan tier determines which of its tools exist for your workspace at all.
- Your AI tool's own limit — several AI products cap how many tools they will accept from one server and silently drop the rest (Claude Desktop truncates at 256 tools and re-sorts them alphabetically first, Cursor at ~40 across all servers, Windsurf at 100, and GitHub Copilot in VS Code hard-errors at 128). The first-line fix is catalog modes: switch StackJack to compact or minimal mode so it serves a small tool list while keeping every tool reachable on demand — no ordering on our side can protect a tool from a client that truncates. An admin must first enable catalog modes for your organization on Endpoints; until then StackJack serves the full tool list. Trimming the credential's or member's tool selection also helps. See Choosing tools for each client and managing harness tool limits; the per-harness setup guides note each client's known cap.
After an admin changes your assignments, the fix is picked up on your next request — refresh the tool list in your AI tool; no reconnect is needed.
"I revoked/rotated, but it still works"
- Rotation of a Client ID + Secret or API key kills the old secret immediately, but an OAuth access token already minted from it can keep working for up to 1 hour. If it must die now, revoke the credential instead.
- Everything else — revoking a credential, removing a member, revoking an app authorization — takes effect on the connection's next request. If something still works minutes later, verify you revoked the right row; see the timing reference.
An AI app fails for every user at once
If a specific AI product suddenly gets 401s for all of your users (sign-ins fail too), StackJack may have disabled that app platform-wide via its kill switch — this is a deliberate protective action, not an outage. Contact support@stackjack.io.
Rate limits and quotas
- There is no per-minute rate limit — bursts of requests are not throttled.
- The enforcement point is the monthly plan cap per connector subscription. If a connector's monthly allowance is exhausted, its tool calls fail until the billing cycle resets or the plan is upgraded. Check usage on the Dashboard or Billing pages.
When you contact support
Include:
- Your workspace (company) name and the signed-in email.
- Any support code shown (they start with
SJ-, e.g.SJ-ACCESS-AWAITING-APPROVAL). - The AI tool/product, the exact error text, and the time it occurred (StackJack timestamps are Eastern Time).
Email support@stackjack.io or use the Support button in the portal header.