diff --git a/packages/docs/config.mdx b/packages/docs/config.mdx
index f0ae18f7c7..25d9cb0989 100644
--- a/packages/docs/config.mdx
+++ b/packages/docs/config.mdx
@@ -318,7 +318,7 @@ be overridden by an individual server.
 }
 ```
 
-See the [MCP guide](/mcp) for remote servers, OAuth, environment variables, and timeouts.
+See the [MCP guide](/mcp-servers) for remote servers, OAuth, environment variables, and timeouts.
 
 ### Compaction
 
diff --git a/packages/docs/docs.json b/packages/docs/docs.json
index f2793789b2..fbbf84d3fa 100644
--- a/packages/docs/docs.json
+++ b/packages/docs/docs.json
@@ -34,7 +34,7 @@
               "commands",
               "skills",
               "instructions",
-              "mcp",
+              "mcp-servers",
               "attachments",
               "compaction",
               "formatters",
diff --git a/packages/docs/index.mdx b/packages/docs/index.mdx
index 474d7f6454..454f374b9f 100644
--- a/packages/docs/index.mdx
+++ b/packages/docs/index.mdx
@@ -37,7 +37,7 @@ You can also install it with the following package managers.
   </Tab>
 </Tabs>
 
-<Note>During beta, the executable is named `opencode2`.</Note>
+<Note>During beta, the binary is called `opencode2`.</Note>
 
 ### Homebrew
 
diff --git a/packages/docs/mcp.mdx b/packages/docs/mcp-servers.mdx
similarity index 100%
rename from packages/docs/mcp.mdx
rename to packages/docs/mcp-servers.mdx
diff --git a/packages/docs/migrate-v1.mdx b/packages/docs/migrate-v1.mdx
index 44b59cd08c..328a1dcaa0 100644
--- a/packages/docs/migrate-v1.mdx
+++ b/packages/docs/migrate-v1.mdx
@@ -217,7 +217,7 @@ V2 groups servers under `mcp.servers`, replaces `enabled` with the inverse `disa
 
 Remote OAuth fields use snake case: `clientId` becomes `client_id`, `clientSecret` becomes `client_secret`,
 `callbackPort` becomes `callback_port`, and `redirectUri` becomes `redirect_uri`. The V1 `experimental.mcp_timeout` value
-also becomes the default `mcp.timeout.catalog` and `mcp.timeout.execution` values. See [MCP servers](/mcp).
+also becomes the default `mcp.timeout.catalog` and `mcp.timeout.execution` values. See [MCP servers](/mcp-servers).
 
 ### Compaction