Mcp Troubleshooting | Corcava Help Center

Claude Desktop MCP Troubleshooting: Server Not Showing Up

Corcava not appearing in Claude Desktop usually means the remote connector was not added, was not enabled for the conversation, or browser authorization did not finish. Corcava is a remote MCP server,...

MCP Config JSON Errors: How to Fix Common Mistakes

This guide applies to MCP clients configured with a static JSON file and API key. If your client offers Add custom connector and asks only for a server URL, use Corcava's OAuth flow instead: enter htt...

Remote MCP Connection Failed: Diagnosing Network, TLS, and Proxies

Can't connect to a remote MCP server? This diagnostic guide helps you troubleshoot network issues, DNS problems, corporate proxy configuration, TLS inspection, and firewall rules. Follow the checklist...

401 Unauthorized in MCP: Fix Authentication Safely

A 401 response means the Corcava MCP endpoint received the request but could not authenticate it. The correct fix depends on whether the connection uses OAuth or a static API key.

403 Forbidden in MCP: Fix Workspace and Resource Access

A 403 response means Corcava understood the authenticated request but refused it in the current workspace or resource context. Unlike a 401, repeatedly copying the same credential usually will not sol...

MCP Tools Not Listed: Why `tools/list` Is Empty

If the Corcava connection appears active but the client advertises no tools, troubleshoot connector enablement, authorization, and configuration loading in that order. Do not confuse an empty MCP tool...

MCP Tool Calls Fail: Debugging Inputs, Validation, and Error Payloads

MCP tools are listed but calls fail? This generic troubleshooting guide helps you debug tool call failures: invalid arguments, missing required fields, wrong IDs, and server-side validation errors. Le...

MCP Timeouts and Slow Responses: How to Stabilize Your Setup

Experiencing timeouts or slow MCP tool calls? This performance troubleshooting guide helps you diagnose timeout causes, optimize long-running operations, implement retry patterns, and reduce response...

Continue MCP SSE Issues: Connection Drops, Streaming, and Retries

Having trouble with Continue's SSE connection to Corcava MCP? This Continue-specific troubleshooting guide helps you fix SSE disconnects, streaming failures, and connection issues. Learn how to valida...

Cursor MCP Troubleshooting: Changes Not Applied After Editing Config

Edited your Cursor MCP config but changes aren't taking effect? This Cursor-specific troubleshooting guide helps you fix issues when config updates don't apply. Learn about restart/reload requirements...

Windsurf MCP Troubleshooting: Auth Headers Not Being Sent

Windsurf connects to Corcava MCP but tool calls fail? This Windsurf-specific troubleshooting guide helps you fix cases where the server connects but tool calls fail due to missing authorization header...

Windows MCP Config Paths: Where to Find and Edit the Right File

Need to find or edit your MCP configuration on Windows? This Windows-specific guide shows you exactly where each MCP client stores its config files, how to open and edit them safely, and how to avoid...

macOS MCP Config Paths: Where to Find and Edit the Right File

Need to find or edit your MCP configuration on macOS? This macOS-specific guide shows you exactly where each MCP client stores its config files, how to open and edit them safely using Finder or Termin...

429 Rate Limited in MCP: How to Reduce Tool Calls and Retry Safely

Getting 429 rate limit errors from your MCP server? This troubleshooting guide helps you understand rate limiting, identify the causes (bursting, loops, large lists), implement safe retry/backoff stra...

Preventing Accidental Writes in MCP: Confirmation Prompts That Work

Worried about assistants accidentally creating, updating, or deleting tasks? This safety playbook provides reusable prompt templates that force a preview and explicit confirmation token before any wri...