Skip to content

docs: change MCP's default port from 5000 to 8000 #8375

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
DaleSeo merged 5 commits into from
Oct 21, 2025
Merged

docs: change MCP's default port from 5000 to 8000 #8375

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
01f51f8
docs: change MCP's default port from 5000 to 8000
DaleSeo Oct 3, 2025
dbb34a8
chore: add changeset
DaleSeo Oct 3, 2025
13f55ff
fix: port 800 and clarify default port
mabuyo Oct 17, 2025
0dc1106
fix changeset description
mabuyo Oct 17, 2025
5d12c13
Merge branch 'dev' into AIR-42
mabuyo Oct 17, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .changesets/docs_mcp_port.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
### docs: change MCP's default port from 5000 to 8000 ([PR #8375](https://github.com/apollographql/router/pull/8375))

MCP's default port changed from 5000 to 8000.
4 changes: 2 additions & 2 deletions docs/source/routing/self-hosted/containerization/docker.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,12 +39,12 @@

## Enabling MCP

To serve MCP requests, enable the [Apollo MCP Server](/apollo-mcp-server) using the `MCP_ENABLE` environment variable. You'll also need to export container port `5000` for Streamable HTTP connections to the MCP server, using the `-p 5050:5000` flag.
To serve MCP requests, enable the [Apollo MCP Server](/apollo-mcp-server) using the `MCP_ENABLE` environment variable. You'll also need to export the container port where the MCP server is running, port `8000` by default, for Streamable HTTP connections to the MCP server, using the `-p 8000:8000` flag.

Check warning on line 42 in docs/source/routing/self-hosted/containerization/docker.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/routing/self-hosted/containerization/docker.mdx#L42 

Use the imperative mood for instructions. The proposed change also improves clarity and uses more precise terminology.

```suggestion
To serve MCP requests, enable the [Apollo MCP Server](/apollo-mcp-server) using the <code>MCP_ENABLE</code> environment variable. Also, publish the MCP server's container port (<code>8000</code> by default) for Streamable HTTP connections with the <code>-p 8000:8000</code> flag.
```

```bash title="Docker" {3, 6}
docker run \
-p 4000:4000 \
-p 5050:5000 \
-p 8000:8000 \
--env APOLLO_GRAPH_REF="<your-graph-ref>" \
--env APOLLO_KEY="<your-graph-api-key>" \
--env MCP_ENABLE=1 \
Expand Down