Most connection problems come down to one of five things, and all of them are quick to fix. Find your symptom below.
The server doesn't show up at all
You added Redreach but your assistant acts as if nothing happened.
- Restart the app properly. This fixes it most of the time. In Claude Desktop, quitting means
⌘Qon Mac or the tray icon then Quit on Windows. Closing the window is not enough, it keeps running in the background.
- Check you pasted the whole address. It must be
https://connect.redreach.ai/mcpexactly, includinghttps://and the/mcpon the end.
- Look for a toggle. Some tools add a server switched off. In ChatGPT you also have to enable the connector in the + (tools) menu inside a chat before it can be used.
It says I need to sign in, and never lets me
You clicked connect but the approval never completes.
- Let the browser window finish. A window opens on Redreach. Sign in there, click Approve, and wait for it to say you can close it. Closing it early cancels the connection.
- Check you signed in to the right account. If you have a personal and a work Redreach login, the approval applies to whichever one the browser is signed in to. Sign out and back in as the right one, then try again.
- Approve within two minutes. The approval expires quickly for security. If you got distracted, just start the connect flow again.
- Try a normal browser window. Private and incognito windows sometimes block the handover back to your AI tool.
"Authorization code expired, restart the connect flow"
You took too long on the approval screen. Start the connection again and click Approve without pausing.
Error messages about your key or plan
"Unauthorized. Connect via OAuth, or pass a Redreach API key as a header"
Your tool reached Redreach but did not identify itself. Either the browser approval never completed, or you are using a token setup and the token is missing from your config.
If you are using a token, check that the header line reads exactly:
Authorization: Bearer rr_YOUR_API_KEYThe word Bearer, a single space, then your token starting with rr_. A missing Bearer is the most common slip.
"Invalid or revoked API key"
The token is real but no longer valid. Usually one of:
- It was deleted in Account Settings → MCP
- Part of it was lost when copying, tokens are long and easy to truncate
- It belongs to a different Redreach account than the one you meant
Create a fresh token and paste it in again. Copy it in one go rather than typing any of it.
"No API access, needs an active Growth, Professional or Agency plan"
The connection works, but the project you asked about is on a plan without MCP access, or the subscription has lapsed.
Ask your assistant to list your projects and it will show which ones have access. Upgrade or renew and it starts working again straight away, with no need to reconnect.
"Rate limit exceeded, retry in 30s"
Something made a lot of requests very quickly. Normal conversation never hits this. Wait the number of seconds it names and carry on. If it keeps happening, an automation somewhere is probably looping.
"Redreach API is unreachable, try again shortly"
A temporary problem on our side rather than anything you did. Wait a moment and try again.
Your assistant finds nothing
It returns zero opportunities or zero mentions
If the project is new, monitoring has probably not finished its first pass. It takes several minutes after setup. Your assistant will normally say so rather than reporting a confident zero.
If the project is established, try widening the question. Ask for all opportunities rather than a filtered set, or drop any search term. Your assistant may have applied a narrow filter you did not intend.
Check your keywords. If Redreach has little to monitor, there is little to return. See Optimizing your keywords for better Reddit opportunities and Managing competitors and tracking their Reddit activity.
"Thread not found in Redreach"
You pasted a Reddit link that Redreach has not indexed for your project. Your assistant can only open threads that your own monitoring surfaced, it cannot fetch arbitrary Reddit URLs.
If that thread matters, add a keyword that would catch it and monitoring will pick it up on the next run.
"Unknown project id"
Your assistant used a stale project reference, usually from an earlier conversation. Ask it to list your projects again, then repeat your question.
"This project has no competitors configured"
You asked about competitors before any were added. Add them under Settings → Competitors in Redreach first.
If you have several competitors and your assistant asks which one you mean, name the domain, for example "canny.io".
"This project has no website configured yet"
The project has not finished onboarding. Complete the project setup in the dashboard and the connection will work.
The CRM numbers look out of date
Lead and outreach data comes from the Redreach Chrome extension, and the extension only sends data while it is open.
Open Reddit in Chrome with the extension running and give it a moment to sync. Your assistant flags this itself when the data looks stale.
I pasted the address into my browser and got an error page
That is expected. https://connect.redreach.ai/mcp is not a web page, it is an address for AI tools to talk to. You will see a page explaining exactly that, which also confirms the server is running normally.
Claude Desktop config file route fails to start
If you used the claude_desktop_config.json route rather than adding a connector, that method runs a small helper through npx, which needs Node.js installed.
Install Node from nodejs.org and restart Claude. Or switch to the connector method instead, which needs nothing installed at all.
Quickest way to tell whether the connection itself is healthy: ask "Which Redreach projects do you have access to?". If your projects come back, the connection is fine and the problem is with the specific question you asked, not the setup.
Still stuck?
Get in touch with support and include:
- Which AI tool you are using, and whether you connected through the browser or with a token
- The exact error message you saw
- What you asked your assistant
That is usually enough for us to spot it straight away.
Still setting up? Getting started with the Redreach MCP walks through the whole connection from scratch.
Powered by