Skip to content

fix(docs): use mcp-remote for Claude Desktop MCP setup#4272

Merged
owenwahlgren merged 1 commit into
masterfrom
fix/claude-desktop-mcp-config
Jun 5, 2026
Merged

fix(docs): use mcp-remote for Claude Desktop MCP setup#4272
owenwahlgren merged 1 commit into
masterfrom
fix/claude-desktop-mcp-config

Conversation

@ryanpinsker

Copy link
Copy Markdown
Contributor

Summary

  • Replaces the broken transport: { type: "http" } config in the Claude Desktop setup section with the working mcp-remote approach
  • Adds a note explaining why: Claude Desktop uses stdio transport and doesn't support HTTP MCP servers natively
  • The transport object format causes Claude Desktop to skip the entry entirely with the error: "The following entries in claude_desktop_config.json are not valid MCP server configurations and were skipped: avalanche-mcp"

Working config

{
  "mcpServers": {
    "avalanche-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://build.avax.network/api/mcp"]
    }
  }
}

The Claude Code setup section (which uses --transport http) is unaffected — that format works correctly in Claude Code CLI.

🤖 Generated with Claude Code

@vercel

vercel Bot commented Jun 5, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
builder-hub Ready Ready Preview, Comment Jun 5, 2026 4:54pm

Request Review

@ryanpinsker ryanpinsker force-pushed the fix/claude-desktop-mcp-config branch from c23a8df to f0125e8 Compare June 5, 2026 16:45
@owenwahlgren owenwahlgren merged commit 41d281b into master Jun 5, 2026
4 of 5 checks passed
@owenwahlgren owenwahlgren deleted the fix/claude-desktop-mcp-config branch June 5, 2026 16:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants