Skip to content

Update MCP server documentation to describe auto-generated functionality #1720

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

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open

Update MCP server documentation to describe auto-generated functionality #1720

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
8c2de12
docs: update MCP server documentation to describe auto-generated func…
devin-ai-integration[bot] Nov 3, 2025
64445a8
fix: address Vale linting suggestions for MCP server docs
devin-ai-integration[bot] Nov 3, 2025
2da2b0c
docs: remove work in progress callout from MCP server page
devin-ai-integration[bot] Nov 3, 2025
b1647a2
make page more concise, fix link
devalog Nov 4, 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
1 change: 1 addition & 0 deletions .vale/styles/FernStyles/Headings.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -115,3 +115,4 @@ exceptions:
- YAML
- fern.config.json
- Font Awesome
- MCP
19 changes: 11 additions & 8 deletions fern/products/docs/pages/ai/mcp-server.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,18 +3,21 @@ title: MCP server for your site
description: Learn how to use the Model Context Protocol (MCP) to integrate AI capabilities with your Fern documentation
---

<Markdown src="/snippets/wip-callout.mdx" />

[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 can build a production-ready MCP server for your documentation site. This enables developers using AI clients (like Claude Desktop, Cursor, and Windsurf) to get instant answers about your product directly within their development environment.
Fern automatically generates and hosts a production-ready MCP server for every documentation site. This enables developers using AI clients (like Claude Desktop, Cursor, and Windsurf) to get instant answers about your product directly within their development environment.

## How it works

Fern analyzes your docs site structure and content, then creates an MCP server.
Fern automatically creates an MCP server for your documentation site that uses Ask Fern AI search to answer questions about your documentation.

When developers connect to your MCP server, they can ask questions about your product. Their AI client will search through your documentation and provide accurate, contextual answers. The server respects your documentation's authentication settings and reflects your current documentation content.

## Access your MCP server
Copy link
Contributor

@github-actions github-actions bot Nov 3, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[FernStyles.Headings] 'Access your MCP server' should use sentence-style capitalization.


Developers can access your MCP server by visiting `your-documentation-site.com/mcp` and copying the configuration snippet to add to their AI client settings. Once integrated, developers can ask their AI client questions about your products. The AI client will search through your documentation and provide accurate answers.
Your MCP server is automatically available at `your-documentation-site.com/_mcp/server`. To connect to your MCP server:

<Tip>
**Looking for Fern's own MCP server?** If you want to connect your AI client to Fern's MCP server for help with Ask Fern, Docs, and SDKs, see the [fern-mcp-server repository](https://github.com/fern-api/fern-mcp-server).
</Tip>
1. Visit `your-documentation-site.com/_mcp/server` in a browser to see the server information
2. Add this URL to your AI client's MCP server configuration (Claude Desktop, Cursor, Windsurf, etc.)
3. Authenticate if your documentation requires authentication
4. Start asking questions about your product directly in the AI client
10 changes: 5 additions & 5 deletions fern/products/docs/pages/getting-started/overview.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -138,18 +138,18 @@ subtitle: A website builder for beautiful agent and developer-friendly docs.
</div>
</a>

<a class="fern-card interactive not-prose rounded-3 relative block border p-6 text-base" href="https://github.com/fern-api/fern-mcp-server">
<a class="fern-card interactive not-prose rounded-3 relative block border p-6 text-base" href="/learn/docs/ai-features/mcp-server">
<div class="flex items-start flex-col space-y-3">
<img class="mx-auto dark:hidden" alt="Fern's MCP Server" src="./images/mcp-server-light.png" />
<img class="mx-auto hidden dark:block" alt="Fern's MCP Server" src="./images/mcp-server-dark.png" />
<img class="mx-auto dark:hidden" alt="MCP server for your site" src="./images/mcp-server-light.png" />
<img class="mx-auto hidden dark:block" alt="MCP server for your site" src="./images/mcp-server-dark.png" />
<div class="w-full space-y-1 overflow-hidden">
<div class="text-(color:--grayscale-a12) text-body text-base font-semibold card-title">
Fern's MCP server
MCP server for your site
<img src="./images/arrow-right-black.svg" alt="Arrow right light" className="arrow-right dark:hidden m-0" noZoom />
<img src="./images/arrow-right-white.svg" alt="Arrow right light" className="arrow-right hidden dark:block m-0" noZoom />
</div>
<div class="text-(color:--grayscale-a11) font-light">
<p>Add Fern's MCP server to your AI workflows.</p>
<p>Auto-generated MCP server for AI client integration.</p>
</div>
</div>
</div>
Expand Down
Loading