From 0933ba015ae7ff8ddd911f6cacd3d8a92adc346b Mon Sep 17 00:00:00 2001
From: shamoon <4887959+shamoon@users.noreply.github.com>
Date: Fri, 21 Aug 2026 06:32:38 -0700
Subject: [PATCH] Docs: clarify Claude use of mcp-remote

---
 docs/configs/mcp.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/configs/mcp.md b/docs/configs/mcp.md
index 744ffc55d..453fe7ac9 100644
--- a/docs/configs/mcp.md
+++ b/docs/configs/mcp.md
@@ -49,6 +49,23 @@ environment:
   HOMEPAGE_MCP_TOKEN: "generate-with-openssl-rand-base64-32"
 ```
 
+## Connecting Claude Desktop
+
+Claude Desktop can use [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) to communicate with the homepage MCP endpoint in `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "homepage": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "http://localhost:3000/api/mcp", "--header", "X-Homepage-MCP-Token: your-token"]
+    }
+  }
+}
+```
+
+The **Add custom connector** option will not work: remote connectors authenticate with OAuth and cannot supply `HOMEPAGE_MCP_TOKEN`.
+
 ## Read-only by default
 
 The MCP endpoint exposes tools for reading and validating supported Homepage config files. File writes are disabled unless you opt in with: