diff --git a/docs/src/ai/mcp.md b/docs/src/ai/mcp.md
index 08608a9871b7f826c4789bf2213cd7fdd6d624bb..cba02eab4da9c66ed360e0599bc52862c242c180 100644
--- a/docs/src/ai/mcp.md
+++ b/docs/src/ai/mcp.md
@@ -56,6 +56,9 @@ You can connect them by adding their commands directly to your settings file ([h
     "remote-mcp-server": {
       "url": "custom",
       "headers": { "Authorization": "Bearer <token>" }
+    },
+    "remote-mcp-server-with-oauth": {
+      "url": "https://mcp.example.com/mcp"
     }
   }
 }
@@ -64,6 +67,8 @@ You can connect them by adding their commands directly to your settings file ([h
 Alternatively, you can also add a custom server by accessing the Agent Panel's Settings view (also accessible via the `agent: open settings` action).
 From there, you can add it through the modal that appears when you click the "Add Custom Server" button.
 
+> Note: When a remote MCP server has no configured `"Authorization"` header, Zed will prompt you to authenticate yourself against the MCP server using the standard MCP OAuth flow.
+
 ## Using MCP Servers
 
 ### Configuration Check