Add MCP server docs page with cross-references

Author: fern-api[bot]

fern/docs.yml

@@ -512,13 +512,11 @@ redirects:
   - source: /learn/docs/ai/llms-txt
     destination: /learn/docs/ai-features/llms-txt
   - source: /learn/docs/ai/mcp-server
-    destination: /learn/docs/ai-features/overview
+    destination: /learn/docs/ai-features/mcp-server
   - source: /learn/docs/ai-features/writer
     destination: /learn/docs/ai-features/fern-writer
-  - source: /learn/docs/ai-features/mcp-server
-    destination: /learn/docs/ai-features/overview
   - source: /learn/docs/ai-features/mcp-server/overview
-    destination: /learn/docs/ai-features/overview
+    destination: /learn/docs/ai-features/mcp-server
   - source: /learn/docs/seo/llms-txt
     destination: /learn/docs/ai-features/llms-txt
   - source: /learn/docs/scribe-api/slack-scribe/get-scribe-slack-install-link

fern/products/docs/docs.yml

@@ -192,6 +192,9 @@ navigation:
           - page: Analytics and integration
             path: ./pages/ai/llms-txt/analytics-integration.mdx
             slug: llms-txt-analytics
+      - page: MCP server
+        path: ./pages/ai/mcp-server.mdx
+        slug: mcp-server
       - section: Ask Fern
         slug: ask-fern
         contents:

fern/products/docs/pages/ai/mcp-server.mdx

@@ -0,0 +1,56 @@
+---
+title: MCP server
+description: Connect AI clients like Claude Code and Cursor to your documentation site's MCP server for instant answers.
+---
+
+[Model Context Protocol (MCP)](https://modelcontextprotocol.io) is an open standard by Anthropic that enables AI applications to connect with external data sources and tools.
+
+Fern automatically generates and hosts a production-ready MCP server for every documentation site with [Ask Fern](/learn/docs/ai-features/ask-fern/overview) enabled. Developers using AI clients like Claude Code, Cursor, and Windsurf can get instant answers about your product directly within their development environment.
+
+Your MCP server is available at `your-documentation-site.com/_mcp/server`.
+
+## Connect from your docs site
+
+Page action buttons on every page let users connect to the MCP server in one click. **Claude Code** and **Cursor** connections are enabled by default on sites with Ask Fern enabled.
+
+<AccordionGroup>
+<Accordion title="Connect to Claude Code">
+
+Under **Page actions** on any page on your site, click **Connect to Claude Code**. This copies a `claude mcp add` command to your clipboard. Paste it into your terminal to register the MCP server with Claude Code.
+
+</Accordion>
+<Accordion title="Connect to Cursor">
+
+Under **Page actions** on any page on your site, click **Connect to Cursor**. Cursor opens with the server URL automatically populated — click **Install** to connect.
+
+<video
+    src="cursor-mcp.mp4"
+    autoPlay
+    loop
+    controls
+    playsInline
+    muted
+>
+</video>
+</Accordion>
+<Accordion title="Connect to other agents (Claude Desktop, Windsurf, etc.)">
+
+Visit `your-documentation-site.com/_mcp/server` in a browser to see the server information, then add this URL to your AI client's MCP server configuration.
+
+</Accordion>
+</AccordionGroup>
+
+To hide or customize these buttons, see [Page actions configuration](/learn/docs/configuration/site-level-settings#page-actions-configuration).
+
+## Direct API access for AI agents
+
+AI agents can access your documentation directly via HTTP. Fern serves content as clean Markdown for token efficiency.
+
+For authenticated sites, agents obtain a JWT via [`/api/fern-docs/get-jwt`](/learn/docs/fern-api-reference/get-jwt) with a Fern API key to access protected documentation content and search functionality.
+
+```bash Access protected content
+curl https://docs.example.com/platform/overview \
+  -H 'Accept: text/plain' \
+  -H 'x-fern-host: docs.example.com' \
+  -H 'FERN_TOKEN: your-jwt-here'
+```

fern/products/docs/pages/ai/overview.mdx

@@ -39,9 +39,10 @@ AI helps keep your documentation current. Fern Writer is a Slack-based technical
 
 ## Optimize for AI
 
-Your site is automatically optimized for AI tools and search engines. Fern hosts `llms.txt` and `llms-full.txt` files so LLMs can index your documentation efficiently, and serves Markdown instead of HTML to AI agents. These features reduce token consumption and helping agents process your content faster.
+Your site is automatically optimized for AI tools and search engines. Fern hosts `llms.txt` and `llms-full.txt` files so LLMs can index your documentation efficiently, and serves Markdown instead of HTML to AI agents. These features reduce token consumption and help agents process your content faster.
 
-<CardGroup cols={2}>
+<CardGroup cols={3}>
+  <Card title="MCP server" icon="plug" href="/learn/docs/ai-features/mcp-server" />
   <Card title="`llms.txt`" icon="file-text" href="/learn/docs/ai-features/llms-txt" />
   <Card title="Agent directives" icon="compass" href="/learn/docs/ai-features/agent-directives" />
 </CardGroup>

fern/products/docs/pages/changelog/2026-04-24.mdx

@@ -4,7 +4,7 @@ tags: ["ai-features"]
 
 ## "Connect to Claude Code" page action
 
-Fern Docs sites with [Ask Fern](/learn/docs/ai-features/ask-fern/overview) enabled now display a "Connect to Claude Code" button alongside existing page actions. Clicking the button copies a `claude mcp add` command. Readers can paste it into their terminal to register your site's MCP server with Claude Code.
+Fern Docs sites with [Ask Fern](/learn/docs/ai-features/ask-fern/overview) enabled now display a "Connect to Claude Code" button alongside existing page actions. Clicking the button copies a `claude mcp add` command. Readers can paste it into their terminal to register your site's [MCP server](/learn/docs/ai-features/mcp-server) with Claude Code.
 
 The action is enabled by default and can be toggled off with `page-actions.options.claude-code: false` in `docs.yml`.
 

fern/products/docs/pages/navigation/site-level-settings.mdx

@@ -820,11 +820,11 @@ page-actions:
 </ParamField>
 
 <ParamField path="page-actions.options.claude-code" type="boolean" required={false} default="true" toc={true}>
-  Controls the "Connect to Claude Code" button, which copies a `claude mcp add` command to the clipboard so users can register the docs site's MCP server with Claude Code. Displays by default when [Ask Fern](/learn/docs/ai-features/ask-fern/overview) is enabled. Set to `false` to hide it.
+  Controls the "Connect to Claude Code" button, which copies a `claude mcp add` command to the clipboard so users can register the docs site's [MCP server](/learn/docs/ai-features/mcp-server) with Claude Code. Displays by default when [Ask Fern](/learn/docs/ai-features/ask-fern/overview) is enabled. Set to `false` to hide it.
 </ParamField>
 
 <ParamField path="page-actions.options.cursor" type="boolean" required={false} default="true" toc={true}>
-  Controls the "Connect to Cursor" button, which installs the docs site's MCP server in Cursor via a deeplink. Displays by default with [Ask Fern](/learn/docs/ai-features/ask-fern/overview) is enabled. Set to `false` to hide it.
+  Controls the "Connect to Cursor" button, which installs the docs site's [MCP server](/learn/docs/ai-features/mcp-server) in Cursor via a deeplink. Displays by default when [Ask Fern](/learn/docs/ai-features/ask-fern/overview) is enabled. Set to `false` to hide it.
 </ParamField>
 
 <ParamField path="page-actions.options.vscode" type="boolean" required={false} default="false" toc={true}>