Liste de débogage MCP : corriger 80 % des problèmes en 10 minutes
Quick troubleshooting checklist for common MCP issues. This concise checklist covers config validation, restart requirements, auth headers, tool listing, and minimal test calls—with links to detailed troubleshooting guides for each item.
⚡ Quick Fix Checklist
Run through these checks in order. Most issues are resolved within the first 5 steps.
Step 1: Validate Config File
Config Validation
- Config file exists in correct location
- JSON syntax is valid (no trailing commas, proper quotes)
- Server name matches expected format
- URL endpoint is correct:
https://mcp.corcava.com - Config structure matches client requirements
Step 2: Check Authorization Header
Auth Header Validation
- Authorization header present in config
- Format is correct:
"Bearer YOUR_API_KEY" - Space after "Bearer" (required)
- API key is active and not revoked
- No extra whitespace or special characters in key
Step 3: Restart Client
Restart Requirements
- Client fully quit (not just window closed)
- Client restarted after config changes
- Config file saved before restart
- No config file changes during client runtime
Step 4: Verify Tools List
Tool Availability
- MCP server appears in available servers list
- Tools list is not empty
- Expected tools visible (list_tasks, create_task, etc.)
- No connection errors in client logs
Step 5: Test with Minimal Call
Minimal Test
- Test with read-only operation: "List my projects from Corcava"
- Operation completes without errors
- Response time is reasonable (<5 seconds)
- Data returned is accurate
Step 6: Check Network & Connection
Network Validation
- Can reach endpoint:
https://mcp.corcava.com - No firewall blocking MCP connections
- Corporate proxy configured if needed
- DNS resolution working correctly
Step 7: Verify Permissions
Permission Check
- API key has required permissions for operation
- Key has access to correct workspace
- No 403 Forbidden errors on tool calls
- Write permissions verified if doing writes
Quick Diagnostic Commands
Test Prompts
Use these prompts to test your setup:
"List my projects from Corcava"
"List available MCP tools from Corcava"
"Get task [Task ID] details from Corcava"
If these work, your basic setup is correct. If not, follow the checklist above.
Common Issues & Quick Fixes
Issue: Tools Not Appearing
Quick Fix:
- Validate config JSON
- Check auth header format
- Fully restart client
Issue: 401 Unauthorized
Quick Fix:
- Verify API key is active
- Check "Bearer " format (space required)
- Regenerate key if needed
Issue: Connection Failed
Quick Fix:
- Test endpoint reachability
- Check firewall/proxy settings
- Verify DNS resolution
Related Resources
Troubleshooting Index
Complete troubleshooting guide
First MCP Session
Smoke test script
Config Generator
Generate correct config
Config JSON Errors
Fix config syntax
Fix MCP Issues Quickly
Use this checklist to resolve most MCP problems in minutes