docs: fix MCP client transport to http (was sse)

Server uses Streamable HTTP (StreamableHTTPSessionManager), but README
told users to register the client with --transport sse / "type": "sse".
An SSE client waits for an endpoint event the server never emits, so
Claude Code reports "Failed to connect" despite a healthy container.

Switch all client config snippets to http transport and point at the
trailing-slash /mcp/ URL to avoid the 307 redirect that can drop the
auth header.

Fixes #274

ha-relevant: no
This commit is contained in:
Pouzor
2026-07-12 00:04:59 +02:00
parent 2e4b353fcd
commit 5fada99e25
+5 -5
View File
@@ -317,7 +317,7 @@ docker compose up -d mcp
**Claude Code** — run this command in your terminal: **Claude Code** — run this command in your terminal:
```bash ```bash
claude mcp add --transport sse homelable http://<your-homelab-ip>:8001/mcp \ claude mcp add --transport http homelable http://<your-homelab-ip>:8001/mcp/ \
--header "X-API-Key: mcp_sk_yourkey" --header "X-API-Key: mcp_sk_yourkey"
``` ```
@@ -326,8 +326,8 @@ Or add it manually to `~/.claude.json`:
{ {
"mcpServers": { "mcpServers": {
"homelable": { "homelable": {
"type": "sse", "type": "http",
"url": "http://<your-homelab-ip>:8001/mcp", "url": "http://<your-homelab-ip>:8001/mcp/",
"headers": { "headers": {
"X-API-Key": "mcp_sk_yourkey" "X-API-Key": "mcp_sk_yourkey"
} }
@@ -341,8 +341,8 @@ Or add it manually to `~/.claude.json`:
{ {
"mcpServers": { "mcpServers": {
"homelable": { "homelable": {
"type": "sse", "type": "http",
"url": "http://<your-homelab-ip>:8001/mcp", "url": "http://<your-homelab-ip>:8001/mcp/",
"headers": { "headers": {
"X-API-Key": "mcp_sk_yourkey" "X-API-Key": "mcp_sk_yourkey"
} }