Skip to content

Conversation

@devin-ai-integration
Copy link
Contributor

Update MCP server documentation to describe auto-generated functionality

Summary

Updated the MCP server documentation to describe Fern's auto-generated MCP server functionality instead of linking to the external fern-api/fern-mcp-server repository. The changes include:

  1. Revised /docs/ai/mcp-server page: Rewrote the content to explain that Fern automatically generates and hosts an MCP server for every documentation site, describing how it works, how to access it, and its features
  2. Updated getting-started overview card: Changed the card from linking to the GitHub repository to linking to the internal MCP server documentation page
  3. Corrected MCP server URL: Updated from /mcp to /_mcp/server based on the middleware implementation in fern-platform

The documentation now explains that the MCP server:

  • Is automatically generated and hosted for every docs site
  • Provides a searchDocs tool powered by Ask Fern AI
  • Is available at your-documentation-site.com/_mcp/server
  • Supports authentication and requires no configuration

Review & Testing Checklist for Human

⚠️ High Priority - Please Verify:

  • Test the MCP server URL: Visit /_mcp/server on a live Fern docs site to confirm this is the correct public-facing URL (I found this in the middleware code but couldn't test it)
  • Verify link path: Check that the internal link /docs/ai/mcp-server resolves correctly when the documentation is published
  • Test MCP functionality: If possible, connect an AI client (Claude Desktop, Cursor, etc.) to a docs site's MCP server to verify the documentation accurately describes the behavior
  • Check for other references: Search the codebase for any remaining references to fern-api/fern-mcp-server that should be removed or updated
  • Review content accuracy: Verify that the description of how the MCP server works matches the actual implementation (I based this on reading the fern-platform code but couldn't test it)

Notes

  • I couldn't access the Slack thread mentioned in the request, so there may be additional context or requirements I missed
  • Vale linting couldn't be run locally (command not found), but I followed the documentation style guidelines
  • The URL was corrected from /mcp to /_mcp/server based on the middleware.ts implementation at line 175-178

Link to Devin run: https://app.devin.ai/sessions/ff3bcad83fc9458989fac948b0838de8
Requested by: [email protected] (@dannysheridan)

@devin-ai-integration
Copy link
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

<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>
## Accessing your MCP server
Copy link
Contributor

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] 'Accessing your MCP server' should use sentence-style capitalization.


## Features

The auto-generated MCP server includes:
Copy link
Contributor

Choose a reason for hiding this comment

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

🚫 [vale] reported by reviewdog 🐶
[Microsoft.Auto] In general, don't hyphenate 'auto-generated'.


- **Semantic search**: Powered by your site's Ask Fern AI functionality
- **Authentication support**: Respects your documentation's authentication settings
- **Automatic updates**: Always reflects your latest documentation content
Copy link
Contributor

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.Current] Avoid time-relative terms like 'latest' that become outdated

@github-actions
Copy link
Contributor

github-actions bot commented Nov 3, 2025

<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>
## Access your MCP server
Copy link
Contributor

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.

@github-actions
Copy link
Contributor

github-actions bot commented Nov 3, 2025

@github-actions
Copy link
Contributor

github-actions bot commented Nov 3, 2025

@dannysheridan dannysheridan requested a review from devalog November 4, 2025 18:18
@github-actions
Copy link
Contributor

github-actions bot commented Nov 4, 2025

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants