vh/homepage
1
0
Fork 0
mirror of https://github.com/gethomepage/homepage.git synced 2026-09-12 07:05:56 -07:00
Code Issues Actions 12 Packages Projects Releases Wiki Activity

Docs: clarify Claude use of mcp-remote

Browse Source
This commit is contained in:
shamoon
2026-08-21 06:32:38 -07:00
parent 93763b7c10
commit 0933ba015a
1 changed files with 17 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/configs/mcp.md
+17
View File
@@ -49,6 +49,23 @@ environment:
HOMEPAGE_MCP_TOKEN: "generate-with-openssl-rand-base64-32" 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 ## 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: The MCP endpoint exposes tools for reading and validating supported Homepage config files. File writes are disabled unless you opt in with: