Large Language ModelsGenerate imagesGenerate videos
Claude Connectors Not Working or Not Showing? How to Fix Them
Claude connectors missing from settings, stuck on Connect, or throwing errors mid chat? This article sorts the causes by symptom: plan limits, admin approval, sign-in loops, unreachable servers, bad config files, and tool errors, each with a concrete fix.
Few things in Claude feel as annoying as a connector that worked yesterday and has vanished today. The Connectors menu is empty, the Connect button spins forever, or a tool that looked healthy throws an error halfway through a chat. The good news is that nearly every case traces back to one of a handful of causes, and you can rule them out in about ten minutes if you go in the right order.
This article follows that order. It starts with the boring checks (plan, admin settings, account) because they explain most "not showing" reports, then moves on to sign-in failures, server reachability, local config mistakes, and errors that only appear after a connector shows as connected. Menus and labels move around often, so if a button is not where you expect it, look for the Connectors or Customize area in settings.
💡 Rule of thumb: If the connector is not visible, suspect your plan or an admin setting. If it is visible but will not connect, suspect sign-in or reachability. If it connects but fails in chat, suspect the tool call itself.
Why Connectors Go Missing
Start by naming your symptom, because each one points to a different fix:
The Connectors option is absent from settings. This is almost always a plan or organization issue.
The connector is listed, but the Connect button is missing or does nothing. Think URL typos, blocked pop-ups, or a stale session.
The connector shows as connected, but Claude never uses it. Check the per-chat toggle and the tool permissions.
Your Plan Sets the Limits
Connectors, and custom connectors that point at a remote MCP server in particular, belong to paid plans. On a plan without them, the Connectors option simply does not appear, and no refresh will bring it back. Open your account settings, confirm which plan is active, and compare it against the official connectors help article. If you recently upgraded or switched workspaces, sign out and back in so the new plan is picked up.
Admins Hold the First Switch
On Team and Enterprise plans, an Owner or Primary Owner has to enable a connector for the organization before anyone can use it. In the admin area that means opening the connector list through Browse connectors and choosing Add to your team. Enabling a connector only makes it available. Each person still has to sign in to it individually, so a colleague seeing "connected" tells you nothing about your own account.
Three questions worth putting to your admin:
Is the connector enabled for the whole organization, or only for certain groups?
Did a recent policy change block custom connectors?
Are you signed in with the same email address the workspace invited?
Run These Quick Checks First
These take two minutes and fix a surprising share of cases. Do them before you touch any server settings.
Refresh, Sign Out, Sign Back In
Stale sessions cause ghost problems. Work through these in order and test after each step:
Hard refresh the page (Ctrl+Shift+R on Windows, Cmd+Shift+R on Mac).
Sign out of Claude, close the tab, and sign in again.
Fully quit the desktop app, including the tray or menu bar icon, then reopen it.
Try a private window with extensions off, in case an ad blocker swallows the sign-in pop-up.
Update the desktop app to the latest version.
Switch It On Per Chat
A connector can be connected and still be switched off for the conversation you are in. Open the tools menu near the message box and make sure the connector is toggled on. Then check its tool permissions: individual tools can be set to ask first, always allow, or stay blocked. A blocked tool looks exactly like a missing one.
Symptom
Most likely cause
Fastest fix
No Connectors option in settings
Your plan does not include it
Check the plan, upgrade, or ask your admin
Connector exists for others, not for you
Never signed in, or not added by an Owner
Ask the Owner to add it, then sign in yourself
Connect button does nothing
Blocked pop-up or stale session
Allow pop-ups, hard refresh, retry
Connected, but Claude ignores it
Switched off in this chat
Enable it in the tools menu
Worked yesterday, fails today
Expired or revoked token
Disconnect, then connect again
Fix Connectors That Won't Connect
When the connector is visible but sign-in fails, the problem sits somewhere between your browser, the other service's login page, and Claude.
The Sign-In Window Never Finishes
Connecting opens a login page from the other service: your calendar, your CRM, or your own server. If that window never appears, closes instantly, or loops back to the start:
Allow pop-ups for the Claude site.
Sign in to the other service first, in the same browser, so the login page does not have to start from nothing.
Pause your VPN or content filter if it rewrites redirects.
Check permissions. Many services only let an admin approve third-party apps.
💡 Reconnect cleanly. Remove the connector, close the tab, sign in again, and add it fresh. A half-finished earlier attempt can leave a broken state that repeated retries never repair.
Authorization Failed Messages
"Authorization with the MCP server failed" usually appears after sign-in has already started. Anthropic's connector troubleshooting documentation lists these server-side causes:
Issuer or audience mismatch. Tokens must come from the authority the server advertises, and be issued for that server's own URL.
Missing PKCE support. Claude sends an S256 PKCE challenge with every authorization request, so a server without it fails at the token step.
A slow token endpoint. Claude waits up to 10 seconds for the token response. A gateway that adds latency can push you past it.
A redirect to another host. When the registered URL redirects (apex to www is the classic case), the credential is dropped on the way and the target answers 401.
If you only use someone else's connector, send them this list. If you run the server, the next section is yours.
Fix "Couldn't Reach the MCP Server"
This message sounds like a network outage, yet the cause is often quieter. The important fact: remote connectors on claude.ai run on Anthropic's infrastructure, not on your computer. Claude resolves your server's hostname from the public internet, and if the result is not globally routable, it rejects the connection before a single request is sent. Your access logs show nothing at all.
Private IPs and Split DNS
Claude rejects hostnames that resolve to private ranges (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16), carrier-grade NAT addresses (100.64.0.0/10), loopback or link-local addresses, or a mix of public and private results. Connectors are also IPv4 only, so a hostname with nothing but AAAA records fails.
That explains the classic complaint: "It works in Claude Code and curl, but not on claude.ai." Those tools connect from your machine, while claude.ai connects from the cloud. If your hostname resolves one way inside your network and another outside (split-horizon DNS), or hides behind a VPN, a dynamic DNS provider, or a home router with CGNAT, the web app never receives a usable address.
Check it from a network outside your own:
dig +short your-server.example.com
Every address returned must be public. For a server on your laptop, expose it through a public tunnel or reverse proxy instead of a localhost URL.
Firewalls and Hidden Redirects
With correct DNS, a CDN, WAF, or rate limiter can still reject the request before your application sees it. Look for 403 or 429 responses in your edge logs during a Connect attempt, then allowlist the outbound range published on Anthropic's IP address page, or exempt the MCP and sign-in paths from the blocking rule.
Then check for redirects:
curl -sI https://your-server.example.com/mcp
If the response is a 301, 302, 307, or 308 pointing at a different host, register that target URL instead. Local clients fail on the redirect right away, while claude.ai follows it, drops the credential, and reports an authorization error later.
OAuth Metadata Lookup Fails
When a server needs sign-in, Claude first looks up its OAuth metadata. Request each document from a public network and expect a 200 with valid JSON:
Only one of the last two has to answer. The metadata must also offer a way to register Claude as a client (dynamic client registration, client ID metadata documents, or pre-registered credentials) and advertise S256 PKCE support. A proxy that drops the WWW-Authenticate header, or returns 403 on /.well-known/ paths, produces the same "couldn't reach" message with a perfectly healthy server behind it.
Microsoft Entra deserves its own note. If the token request fails with AADSTS9010010, Entra is rejecting the resource value Claude sends. Register your full MCP server URL as an Application ID URI on the API app registration, using a verified custom domain if you are on a platform hostname.
💡 Save the reference ID. When a connection fails on claude.ai, the error page URL contains a value that starts with ofid_. Copy it right away, because it expires, and include it when you file an issue on the anthropics/claude-ai-mcp tracker.
Fix Local Servers in Claude Desktop
Servers that run on your own machine take a different path. The desktop app launches them from a config file, so nothing travels over the internet and none of the DNS advice above applies.
Config File Mistakes
The most common local failures are small:
Invalid JSON. One trailing comma or missing quote and the whole file is ignored, so no servers load.
A wrong command path. The app may not inherit your shell PATH, so npx or node works in a terminal but not from the app. Use the absolute path to the executable.
Relative paths in arguments. Use absolute paths for scripts and data folders.
No full restart. Changes only apply after you quit the app fully and reopen it.
Run the file through a JSON validator before you restart.
Read the Logs
The desktop app writes MCP logs to %APPDATA%\Claude\logs on Windows and ~/Library/Logs/Claude on macOS, with a general MCP log plus one file per server. A server that crashes on startup usually prints the reason there: a missing package, the wrong Node version, or an absent environment variable. In Claude Code, claude mcp list shows the status of every configured server, and /mcp inside a session shows details and lets you sign in.
Fix Tool Errors Mid Conversation
Connected but Failing
"Unexpected error while invoking tool", followed by a tool name, means the connection itself is healthy. Claude's request reached the server and the server answered with an error. There is no ofid_ reference ID here, because nothing failed at connection time.
Narrow it down in this order:
Run the same call in MCP Inspector and compare the result with the error Claude shows.
Check the server logs for the handler error at that exact moment.
Find out whether every user hits it or only your account. Only your account points to permissions on the other service.
Disconnect and reconnect, in case the token expired or was revoked.
Rate limits are another frequent culprit, and they look random. Many services cap how much work runs at once. PicassoIA's own MCP connection is a good example: its image, image editing and video models share a limit of 5 predictions running at once per account, across every credential and MCP connection. At the time of writing, you add that connection from the MCP page of your account, which needs a login. If Claude fires ten generations in one request, some will fail. Ask it to work in smaller batches.
Here is a quick decoder for the messages you will meet most often:
Message
What it means
Where to look
Couldn't reach the MCP server
The handshake failed
DNS, firewall, redirects, OAuth metadata
Authorization with the MCP server failed
Sign-in started but did not finish
Issuer, audience, PKCE, token speed, redirects
Unexpected error while invoking tool
Connected, but the tool call failed
Server logs, MCP Inspector, rate limits
No Connectors option at all
Plan or organization setting
Plan page, admin settings
Keep Working While You Debug
A broken connector should not stop your day. While you fix it, paste the error text, a log excerpt, or a screenshot into a model that does not depend on any connector. Claude Sonnet 5 is available on PicassoIA, handles code and tool-heavy tasks, and accepts image input, which suits screenshots of error pages.
Paste your error message, config file, or log excerpt into the Prompt field. Say what you expected and what happened instead.
Optionally add a screenshot in the Image field, such as the failing settings screen.
Pick an Effort level. Low gives the fastest answer for a typo hunt, while high or max suits a tangled OAuth problem.
Add a System Prompt, for example: "You are a careful MCP debugging assistant. Ask for missing details before suggesting changes."
Leave Max Tokens at the default of 8192 unless you want shorter replies, then run it.
💡 Strip secrets first. Remove tokens, client secrets, and passwords from any config or log before you paste it anywhere.
Make Your Own Images on Picasso IA
Before you close the settings tab, run this final checklist:
Plan includes connectors, and an Owner enabled the connector for your team
Signed in with the right account, connector toggled on in the current chat
Pop-ups allowed, and a clean reconnect attempted
Server hostname resolves to a public IPv4 address, with no redirect to another host
OAuth metadata answers with a 200, and the ofid_ reference ID is saved if you need support
Once your connectors behave again, give them something creative to do. Picasso IA turns a short prompt into a photorealistic image in seconds with PicassoIA Image, lets you refine the result with PicassoIA Image Editor Pro, and animates a still with PicassoIA Video. Open the platform, write one prompt about a scene you have in mind, change the lighting or the camera angle, and run it again. Ten minutes of experimenting will show you what each model does best, and you can browse every option on the all models page.