Skip to content
For real estate agents

Troubleshooting

Plain-English fixes for the most common Claude-to-ActuallyCare connection problems, with what you should see when each fix works.

Last updated

Most connection problems have a two-minute fix. Find the line below that sounds like what you're seeing, follow the steps, and check the "What you should see" line under each step to confirm it worked before moving on. If none of these match, contact support and include what you asked Claude and what it said back.

It says Reconnect#

When the connection lapses, Claude shows it in two places: on the Connectors page, ActuallyCare has a ⚠ warning sign and a Reconnect button; in a chat, under + → Connectors, ActuallyCare has a ⚠ and no on/off switch. Claude can't reach your CRM until you reconnect.

  1. In Claude, click Customize in the left sidebar, then Connectors, then the Yours tab.

    What you should see: ActuallyCare with a ⚠ warning sign and a Reconnect button.

    ActuallyCare in Claude's connectors list with a warning sign and a Reconnect button
    A lapsed connection: click Reconnect
  2. Click Reconnect. Sign in to ActuallyCare in the window that opens, then click Continue on the screen titled "Connect with ActuallyCare".

    What you should see: the window closes, the ⚠ and the Reconnect button are gone, and in a chat ActuallyCare has its switch back.

If Reconnect doesn't fix it, remove the connector and add it again: see It says I'm unauthorized or my session expired.

It says I'm unauthorized or my session expired#

Normally the connection renews itself in the background. It does lapse if you haven't used ActuallyCare in Claude for 30 days, and occasionally it just loses its footing. Either way, a fresh connection fixes it.

  1. Go to app.actuallycare.com in your browser and log in.

    What you should see: your normal ActuallyCare dashboard. If you can't log in here, fix that first — reset your password or contact support — because the connection can't work without a healthy account.

  2. In Claude, click Customize in the left sidebar, then Connectors, then the Yours tab. If ActuallyCare shows a Reconnect button, click it, sign in to ActuallyCare, and click Continue on the screen titled "Connect with ActuallyCare".

    What you should see: the Reconnect button is gone and ActuallyCare shows as connected. If so, skip to step 5.

  3. If there was no Reconnect button, or reconnecting didn't help, remove the ActuallyCare connector (it may be behind the three-dot menu next to it).

    What you should see: ActuallyCare disappears from your connector list.

  4. Add it back: click + Add, then Add custom connector, name it ActuallyCare, paste https://mcp.actuallycare.com/mcp, and click Continue. Leave the settings Claude shows as they are, click Continue, then Add. Log in to ActuallyCare in the window that opens, then click Continue on the screen titled "Connect with ActuallyCare".

    What you should see: the window closes and ActuallyCare is back in your connector list.

  5. Start a new chat and ask: "Using ActuallyCare, give me my daily summary."

    What you should see: Claude checks ActuallyCare and answers with your real appointments, deals, and leads — no more "unauthorized" message.

Claude can't see my escrows#

This is almost always one of three things: the connector is switched off for that chat, Claude wasn't told to use it, or you're connected under a different ActuallyCare account than you think.

  1. In the chat, click the + button by the message box, then Connectors, and make sure ActuallyCare is switched on for this conversation.

    What you should see: ActuallyCare in the Connectors list with its switch turned on.

  2. Ask again, explicitly: "Using ActuallyCare, list my escrows."

    What you should see: Claude lists your actual escrows by address — the same ones you see in the app.

  3. If it still comes back empty, log into app.actuallycare.com and check that the escrows are visible there.

    What you should see: your escrows in the app. If they aren't there either, they may be archived or under a different account — that's the real problem, not the connection.

  4. If you suspect you approved the connection while logged into the wrong account, disconnect and reconnect and log in with the right one this time.

    What you should see: after reconnecting, Claude's answers match what you see in the app.

I can't find the Connectors option in Claude#

Claude has moved connectors: they're under Customize now, not Settings.

  1. Go to claude.ai in a web browser (not just the phone app) and log in.

    What you should see: your normal Claude chat screen, with a sidebar on the left.

  2. In the left sidebar, click Customize.

    What you should see: Claude's Customize page, open on its Skills tab, with Connectors and Plugins as tabs beside it. If a pop-up covers it the first time, close it.

  3. Click Connectors.

    What you should see: the Connectors page. It opens on the Discover tab; click Yours to see the connectors you've added. + Add → Add custom connector is where ActuallyCare goes.

If there's no + Add button or no Add custom connector option:

  • On a Claude Team or Enterprise plan, only an owner can add a custom connector. Ask your owner to add it under Organization settings → Connectors (Add → Custom → Web, with the address https://mcp.actuallycare.com/mcp). Then find ActuallyCare on your Customize → Connectors page and click Connect to sign in with your own ActuallyCare account.
  • On Claude's free plan, you can have one custom connector. If you already use a different one, remove it or upgrade your Claude plan.

These are Claude settings, not something ActuallyCare can switch on for you. Once you can add a custom connector, come back to the quickstart.

The ActuallyCare sign-in window never opened#

You pasted the connector address, confirmed, and… nothing. Nine times out of ten, a pop-up blocker quietly stopped the sign-in window from opening.

  1. Look for a blocked pop-up message. Most browsers show a small icon or note near the address bar when they block a window — if you see one, choose to allow pop-ups for claude.ai.

    What you should see: the ActuallyCare sign-in window opens as soon as the pop-up is allowed.

  2. On an iPhone or iPad using Safari, open the Settings app, scroll down to Safari, and turn off Block Pop-ups. (You can turn it back on after setup.)

    What you should see: the Block Pop-ups switch turned off — gray instead of green.

  3. Go back to Claude and try the add-connector step again.

    What you should see: a new window opens asking you to sign in to ActuallyCare.

  4. If it still won't open, double-check the address you pasted. It must be exactly https://mcp.actuallycare.com/mcp — no spaces before or after, nothing missing from the end.

    What you should see: after re-pasting the exact address and confirming, the ActuallyCare sign-in window opens.

Claude says it doesn't have a tool for that#

It may be right. Claude has ActuallyCare's everyday tools: escrows, clients, leads, contacts, listings, today's calendar, drafts, checklists, deadlines, and calculators. Some features aren't available in Claude yet — like production reports, lead-source reports, open-house lists, leases, and goals. Use the ActuallyCare app for those.

If what you asked for is an everyday task, try this:

  1. Say it with the magic words: "Using ActuallyCare, …".

    What you should see: Claude checks ActuallyCare before it answers.

  2. Rephrase your ask in plain words, describing the outcome you want — "show me my clients who are buyers" rather than naming a feature.

    What you should see: Claude comes back with your data instead of an apology.

It connected but answers seem generic#

If Claude answers your CRM questions with general real-estate advice instead of your actual numbers, it's answering from memory instead of checking your CRM.

  1. Start your request with "Using ActuallyCare, …" — for example, "Using ActuallyCare, how many active escrows do I have?"

    What you should see: Claude visibly checks ActuallyCare before it answers.

  2. Ask something only your CRM could answer, like a specific client's phone number, and see if the answer matches the app.

    What you should see: your real names, addresses, and numbers — not ranges, guesses, or "typically, agents…".

  3. In the chat, click +, then Connectors, and make sure ActuallyCare is switched on for this conversation.

    What you should see: ActuallyCare in the Connectors list with its switch turned on.

How do I disconnect or reconnect?#

To disconnect:

  1. In Claude, click Customize in the left sidebar, then Connectors.

    What you should see: the Connectors page. Click Yours to see ActuallyCare among your connectors.

  2. Remove the ActuallyCare connector (it may be behind the three-dot menu next to it).

    What you should see: ActuallyCare disappears from the connector list. Claude stops using the connection, and your CRM data is untouched. There's nothing to undo on the ActuallyCare side.

To reconnect:

  1. In Customize → Connectors, click + Add, then Add custom connector.

    What you should see: a form asking for a name and the connector's web address.

  2. Type ActuallyCare in the Name box, paste https://mcp.actuallycare.com/mcp into the MCP server URL box, and click Continue. Leave the settings Claude shows as they are, then click Continue and Add.

    What you should see: a window opens asking you to log into ActuallyCare.

  3. Log into ActuallyCare in the window that opens, then click Continue on the screen titled "Connect with ActuallyCare".

    What you should see: the window closes and ActuallyCare is back in your connector list. The full walkthrough is in the quickstart.

It says ActuallyCare does not recognize this application#

The connect screen shows this yellow notice when the app asking for access isn't one ActuallyCare already knows.

  1. If you connected from Claude on the web, Desktop, or your phone, you should not see it. Click Cancel, then start again from Claude's Customize → Connectors.
  2. If you connected from Claude Code, the notice can appear because Claude Code signs in through your own computer. If you started it yourself, click Continue.
  3. If you didn't start a connection just now, click Cancel. Something else is asking for your data.

What you should see: After Continue, the window closes and ActuallyCare shows as connected in the app you started from.

Still stuck?#

Contact support and include three things: what you asked Claude, what Claude said back, and a screenshot if you can grab one. That's usually everything we need to spot the problem on the first reply.