docs(agents): the MCP endpoint is /mcp/, and /mcp is a 307 #5

Merged

jlxq0 merged 1 commit from fix/mcp-endpoint-slash into master

2026-08-26 06:25:02 +00:00

jlxq0 commented

2026-08-26 06:21:29 +00:00

Owner

Fork patch. A deployment-contract detail for this fleet.

Found by smoking the released v0.2.0 image (sha256:4e502110), not by reading the source: POST /mcp answers 307 Temporary Redirect to /mcp/. Starlette mounts it that way.

The redirect preserves the method, so an SDK client that follows redirects works either way. An HTTPRoute matching the exact path /mcp and nothing else would route the redirect and never the session — which is the shape of thing that costs an afternoon on a first deploy, and it is not visible without running the image.

**Fork patch.** A deployment-contract detail for this fleet. Found by smoking the released `v0.2.0` image (`sha256:4e502110`), not by reading the source: `POST /mcp` answers `307 Temporary Redirect` to `/mcp/`. Starlette mounts it that way. The redirect preserves the method, so an SDK client that follows redirects works either way. An HTTPRoute matching the exact path `/mcp` and nothing else would route the redirect and never the session — which is the shape of thing that costs an afternoon on a first deploy, and it is not visible without running the image.

jlxq0 added 1 commit

2026-08-26 06:21:29 +00:00

docs(agents): the MCP endpoint is /mcp/, and /mcp is a 307

CI / python (pull_request) Successful in 24s

Details

CI / docker (pull_request) Successful in 11s

Details

87e9283cbd

Found smoking the released `v0.2.0` image rather than the source: `POST /mcp`
returns `307 Temporary Redirect` to `/mcp/`. The redirect preserves the method,
so an SDK client that follows redirects is unaffected — but an HTTPRoute
matching the exact path `/mcp` and nothing else would route the redirect and
never the session, and the first deploy is where that costs an afternoon.

Recorded in the deployment contract because it is what Clark needs for the
HTTPRoute, and it is not visible from the code without running it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EfH9dv5Ub8c9PRxipsBXBe

jlxq0 merged commit d79d6658f4 into master

2026-08-26 06:25:02 +00:00

jlxq0 deleted branch fix/mcp-endpoint-slash

2026-08-26 06:25:03 +00:00

jlxq0 referenced this pull request from a commit

2026-08-26 06:25:03 +00:00

Merge pull request 'docs(agents): the MCP endpoint is /mcp/, and /mcp is a 307' (#5) from fix/mcp-endpoint-slash into master