Troubleshooting Connections — Docs

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:

Is the server URL correct? Copy it directly from your Bridges dashboard — don't modify it.
Did you authorize the connection? The first connection requires browser-based approval.
Is your AI tool up to date? MCP support requires recent versions.
Is your subscription active? Bridges require an active account.
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

Tools Don't Run, or Your AI Keeps Asking to "Approve" / "Allow" Each Action

Cause: This is your AI app's own per-call tool-approval gate, not a Tempreon error. Many MCP clients ask you to approve the first time the AI tries to use a connected tool — and if that approval isn't granted, the call never reaches Tempreon. The clearest sign during a Memory Import: the connection succeeded but the items counter never moves, or your AI says something like "No approval received."

Try:

Look for an approval prompt in your AI app — usually a small "Allow" or "Approve" button near the chat, or a dialog naming the tool (for example session_start or remember). Approve it.
If your app offers "Always allow" (or "Allow for this chat" / "Always approve for this tool"), choose it so Tempreon's tools run without interrupting you each time.
This is separate from the one-time OAuth connection approval — you can be fully connected and still need to approve the first tool call.
Per client: Claude Desktop and Cursor show an inline "Allow" button the first time a tool is called; ChatGPT surfaces a "Confirm" action; Claude Code prompts in the terminal. Approve once and continue.

"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:

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