MCP: Update docs for the configured URI /path (#67634)

* MCP: Update docs for the configured URI /path

* Use /.well-known/oauth-authorization-server in examples
This commit is contained in:
Pawel Kopiczko
2026-06-24 15:39:04 +01:00
committed by GitHub
parent 0cbc5fc40a
commit 18e014736c
5 changed files with 14 additions and 1 deletions
@@ -37,6 +37,8 @@ app_service:
# Use "mcp+http://" and "mcp+https://" as scheme for streamable HTTP MCP servers.
# Use "mcp+sse+http://" and "mcp+sse+https://" as scheme for SSE MCP servers.
# Leave it empty or use "mcp+stdio://" for stdio MCP servers.
# For streamable HTTP MCP servers, the path in the URI is used when the MCP
# client requests "/" but is not appended to requests for other paths.
uri: "mcp+http://localhost:12345/mcp"
# Free-form application description.
description: "Example Everything MCP server"
@@ -95,6 +97,8 @@ spec:
# Use "mcp+http://" and "mcp+https://" as scheme for streamable HTTP MCP servers.
# Use "mcp+sse+http://" and "mcp+sse+https://" as scheme for SSE MCP servers.
# Leave it empty or use "mcp+stdio://" for stdio MCP servers.
# For streamable HTTP MCP servers, the path in the URI is used when the MCP
# client requests "/" but is not appended to requests for other paths.
uri: "mcp+http://localhost:12345/mcp"
mcp:
@@ -73,3 +73,5 @@ server you desire to run.
</TabItem>
</Tabs>
(!docs/pages/includes/mcp-access/endpoint-path-note.mdx!)
@@ -0,0 +1,3 @@
<Admonition type="note" title="MCP endpoint paths">
If the MCP endpoint includes a path such as `/mcp` or `/sse`, it can be included in the `uri`. For streamable-HTTP servers, Teleport uses the path in `uri` when an MCP client requests `/`. When the client requests a different path, Teleport forwards the request to that path instead of appending it to the path in `uri`. For example, if `uri` is `mcp+https://localhost:3000/mcp` and the MCP client requests `/.well-known/oauth-authorization-server`, Teleport forwards the request to `/.well-known/oauth-authorization-server`, not `/mcp/.well-known/oauth-authorization-server`.
</Admonition>
@@ -80,4 +80,6 @@ $ terraform apply
```
</TabItem>
</Tabs>
</Tabs>
(!docs/pages/includes/mcp-access/endpoint-path-note.mdx!)
@@ -68,3 +68,5 @@ $ terraform apply
</TabItem>
</Tabs>
(!docs/pages/includes/mcp-access/endpoint-path-note.mdx!)