diff --git a/packages/web/src/content/docs/docs/mcp-servers.mdx b/packages/web/src/content/docs/docs/mcp-servers.mdx
index 207b328b..0ceeb47a 100644
--- a/packages/web/src/content/docs/docs/mcp-servers.mdx
+++ b/packages/web/src/content/docs/docs/mcp-servers.mdx
@@ -95,17 +95,16 @@ Local and remote servers can be used together within the same `mcp` config objec
 
 ---
 
-## Granular access management
+## Per agent
 
-If you have a large number of MCP servers you may want to disable them globally
-and manage access at the agent level instead. To achieve this:
+If you have a large number of MCP servers you may want to only enable them per
+agent and disable them globally. To do this:
 
 1. Configure the MCP server.
 2. Disable it as a tool globally.
-3. In your [Agent Configuration](/docs/agents#agent-configuration) enable
-the MCP server as a tool.
+3. In your [agent config](/docs/agents#tools) enable the MCP server as a tool.
 
-```json title="opencode.json"
+```json title="opencode.json" {11, 14-17}
 {
   "$schema": "https://opencode.ai/config.json",
   "mcp": {