Description

Claude Code requires "type": "http" in its .mcp.json configuration for HTTP-based MCP servers. Without this field, the config silently fails schema validation — the server doesn't appear in the tools list, no error message is shown.

Current documentation

The README shows:

https://mcp.excalidraw.com

Users configuring Claude Code's ~/.mcp.json write:

{
  "mcpServers": {
    "excalidraw": {
      "url": "https://mcp.excalidraw.com"
    }
  }
}

This fails schema validation in Claude Code. The /doctor command reports: "Does not adhere to MCP server configuration schema".

Fix

Add "type": "http" to the configuration:

{
  "mcpServers": {
    "excalidraw": {
      "type": "http",
      "url": "https://mcp.excalidraw.com"
    }
  }
}

Impact

This cost about 30 minutes of troubleshooting and Claude Docs review. The failure is silent, tools simply don't appear, with no error in the conversation. The fix is one line.

Confirmed working with Claude Code v2.1.84 on macOS. All 5 tools connect and function correctly after adding the type field.

Suggested docs update

Adding a note under the "Remote (recommended)" install section:

Claude Code users: Add "type": "http" to your .mcp.json config alongside the URL.