Preflight Checklist
What's Wrong?
When an MCP tool is configured but fails to connect/load, Claude has zero visibility into it. From Claude's perspective, the tool simply doesn't exist — it cannot distinguish between "not configured" and "configured but broken".
Claude tells the user the tool is not available, when in fact it is configured but failing. The user has to manually inform Claude of something the system already knows.
What Should Happen?
Claude should receive system-level context listing all configured MCP tools and their connection status, e.g.:
MCP tools status:
- some-tool: failed to connect
- working-tool: connected
So Claude can proactively say "X is configured but failing — check your credentials/endpoint" instead of incorrectly claiming it has no access.
Error Messages/Logs
Steps to Reproduce
- Configure an MCP tool in Claude Code settings (e.g. via mcp.json)
- Make the tool fail to connect (wrong credentials, unreachable endpoint, etc.)
- Ask Claude to use that tool
- Claude responds that the tool is not available / not installed
- Claude has no idea the tool is configured but broken
Claude Model
Sonnet (default)
Is this a regression?
No, this never worked
Last Working Version
No response
Claude Code Version
2.1.185 (Claude Code)
Platform
Anthropic API
Operating System
macOS
Terminal/Shell
Terminal.app (macOS)
Additional Information
No response
Preflight Checklist
What's Wrong?
When an MCP tool is configured but fails to connect/load, Claude has zero visibility into it. From Claude's perspective, the tool simply doesn't exist — it cannot distinguish between "not configured" and "configured but broken".
Claude tells the user the tool is not available, when in fact it is configured but failing. The user has to manually inform Claude of something the system already knows.
What Should Happen?
Claude should receive system-level context listing all configured MCP tools and their connection status, e.g.:
MCP tools status:
So Claude can proactively say "X is configured but failing — check your credentials/endpoint" instead of incorrectly claiming it has no access.
Error Messages/Logs
Steps to Reproduce
Claude Model
Sonnet (default)
Is this a regression?
No, this never worked
Last Working Version
No response
Claude Code Version
2.1.185 (Claude Code)
Platform
Anthropic API
Operating System
macOS
Terminal/Shell
Terminal.app (macOS)
Additional Information
No response