MCP server not showing up in Claude Code
The client never completed a handshake. This is a config problem, not an auth
problem — a server that is connecting or failed in /mcp has not got as
far as sending a key. If you would rather not debug a hand-written config,
/connect writes one and confirms the handshake live.
Work through it in order
- Restart the client. MCP configs are read at startup. This is the fix surprisingly often.
- Check the URL ends in
/mcp.https://api.witwiki.app/mcp, nothttps://api.witwiki.app. A bare host returns 404 and the client reports it as a generic connection failure. - Check the transport is HTTP.
"type": "http", or--transport httpon the CLI. Clients default to stdio, which will try to execute your URL as a command. - Check the server is reachable:
curl -i https://api.witwiki.app/mcp \
-H "Authorization: Bearer YOUR_API_KEY"
Anything other than a connection error means the network path is fine and the problem is in your client config.
In Claude Code, /mcp lists servers and their state — a server stuck in
connecting or failed is a config problem, not an auth problem.
Related
- Connect Claude Code to a shared wiki over MCP — the config, generated.
- 401 Unauthorized from the MCP server — the server answered and refused the key.
- Troubleshooting — everything else.