Troubleshooting Connections

Connection Checklist

If you're on a client not covered by our specific guides, start with the universal connection guide — it covers the pattern every OAuth-capable MCP client follows, plus the catalog of compatible tools.

If your Bridge isn't working, run through this checklist:

1. Is the server URL correct? Copy it directly from your Bridges dashboard — don't modify it.
2. Did you authorize the connection? The first connection requires browser-based approval.
3. Is your AI tool up to date? MCP support requires recent versions.
4. Is your subscription active? Bridges require an active account.
5. Are you within your Bridge limit? Check your tier's allocation in the Bridges dashboard.

Common Issues

"Connection Failed" or "Server Unreachable"

Cause: The AI tool can't reach Tempreon's server.

Try:

• Verify your internet connection
• Confirm the server URL matches your Bridges dashboard exactly (no extra spaces or characters)
• Check if your network/VPN blocks external MCP connections
• Wait 30 seconds and try again — brief connectivity blips resolve on their own

Authorization Window Doesn't Open

Cause: Your AI tool can't open a browser for the OAuth flow.

Try:

• Ensure your default browser is set and working
• Check that pop-up blockers aren't preventing the authorization window
• Some tools open the link in the terminal instead — look for a URL to copy and paste into your browser

"Unauthorized" or "Token Expired"

Cause: Your authorization has expired or been revoked.

Try:

• Remove the Tempreon configuration from your AI tool
• Re-add it with fresh connection details from your Bridges dashboard
• Go through the authorization flow again

AI Doesn't Seem to Know My Context

Cause: The Bridge might be connected but your context isn't loading.

Try:

• Start a new conversation or session — context loads at session start, not mid-conversation
• Ask your AI directly: "What Tempreon tools do you have access to?" — if it lists tools, the Bridge is working but context may need to be explicitly loaded
• Try: "Start my session" — this triggers a full context load

"Bridge Limit Reached"

Cause: You've used all the Bridge slots your subscription tier allows.

Try:

• Disconnect a Bridge you're no longer using
• Upgrade to a higher tier for more Bridge slots
• Check your Bridges dashboard to see which connections are active

Session Data Not Appearing in Dashboard

Cause: There may be a brief delay between a session and dashboard updates.

Try:

• Wait a few minutes and refresh the Bridges page
• Verify the session completed successfully (wasn't interrupted)
• Check that you're logged into the same Tempreon account your Bridge is configured for

Configuration Reference

Expected Configuration Format

Most MCP-compatible tools use this JSON structure:

{
  "mcpServers": {
    "tempreon": {
      "url": "YOUR_SERVER_URL"
    }
  }
}

Where Configuration Files Live

Tool	Config Location
Claude Desktop	Settings UI > MCP Servers
Claude Code	~/.mcp.json (global) or .mcp.json (project)
Cursor	Settings > MCP
Windsurf	Settings > MCP

Still Stuck?

If none of the above resolves your issue:

1. Check the FAQ for additional answers
2. Contact support with details about your issue, including the AI tool you're using and any error messages you see