Troubleshooting & FAQ

The connector's tools don't appear in my chat. Start a new conversation, or toggle the connector off and on in Claude's settings. Claude only loads a connector's tools at the start of a chat.

Claude shows "Connection expired". Usually a Claude-side OAuth refresh quirk, not OpenOrg logging you out. Click Connect — it often restores access without a full login. See "Connection expired" in Claude.

I'm asked to sign in again (full OpenOrg login). This happens if access was revoked, your OpenOrg session ended, or refresh failed entirely. Complete the OpenOrg sign-in to reconnect. See Account Settings → Connections to check active connections.

I can't find "Add custom connector" in Claude. Your Claude plan or org role may not allow it. Personal accounts add connectors at Customize → Connectors. On Team or Enterprise, only an Owner can add a new custom connector — members connect to one the admin enabled. See Claude account requirements or speak to your Claude/IT admin.

I get an "active OpenOrg subscription required" message. The connector is a Pro feature and your account isn't on a paid plan (or a gift/team seat has expired). Upgrade from Account Settings → Subscription or the Connections tab.

I see "too many requests" or "daily limit reached". You've hit the per-minute rate limit or daily quota. Wait a moment (rate) or until the next day (quota) and try again.

Search returns nothing useful. Rephrase as a clear, specific query — semantic search rewards detail. For example, "best practices for manager 1:1s at a 50-person startup" works better than "1:1s".

Which clients are supported? Claude.ai (web) and Claude Desktop are what we officially support. Any MCP client that supports remote servers with OAuth should work too, but Claude is the recommended setup.

Is my chat content sent to OpenOrg? Only the search queries and resource requests Claude makes are sent to OpenOrg (and logged for audit). Your wider conversation stays in Claude.

Can the connector change my OpenOrg data? No. It is strictly read-only.