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

ryanpinsker · ryanpinsker · commit c23a8dfdbad0 · 2026-06-05T12:17:43.000-04:00
diff --git a/content/docs/tooling/ai-llm/mcp-server.mdx b/content/docs/tooling/ai-llm/mcp-server.mdx
@@ -79,15 +79,15 @@ Add this to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 {
   "mcpServers": {
     "avalanche-mcp": {
-      "transport": {
-        "type": "http",
-        "url": "https://build.avax.network/api/mcp"
-      }
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://build.avax.network/api/mcp"]
     }
   }
 }
 ```
 
+Claude Desktop uses stdio transport and does not support HTTP MCP servers natively. [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) acts as a bridge from stdio to the HTTP endpoint. Node.js must be installed for `npx` to work.
+
 ## JSON-RPC Examples
 
 Search docs:

Original file line number	Diff line number	Diff line change
@@ -79,15 +79,15 @@ Add this to `~/Library/Application Support/Claude/claude_desktop_config.json`:
`79`	`79`	`{`
`80`	`80`	`"mcpServers": {`
`81`	`81`	`"avalanche-mcp": {`
`82`		`- "transport": {`
`83`		`- "type": "http",`
`84`		`- "url": "https://build.avax.network/api/mcp"`
`85`		`- }`
	`82`	`+ "command": "npx",`
	`83`	`+ "args": ["-y", "mcp-remote", "https://build.avax.network/api/mcp"]`
`86`	`84`	`}`
`87`	`85`	`}`
`88`	`86`	`}`
`89`	`87`	```
`90`	`88`
	`89`	+Claude Desktop uses stdio transport and does not support HTTP MCP servers natively. [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) acts as a bridge from stdio to the HTTP endpoint. Node.js must be installed for `npx` to work.
	`90`	`+`
`91`	`91`	`## JSON-RPC Examples`
`92`	`92`
`93`	`93`	`Search docs:`