diff --git a/fern/products/docs/pages/ai/mcp-server.mdx b/fern/products/docs/pages/ai/mcp-server.mdx index 915297500..d945e3e05 100644 --- a/fern/products/docs/pages/ai/mcp-server.mdx +++ b/fern/products/docs/pages/ai/mcp-server.mdx @@ -129,6 +129,26 @@ page-actions: This is especially useful on [authenticated sites](/learn/docs/authentication/overview) because unauthenticated agents can discover the MCP endpoint but can't read its content. Disabling the server returns 404 from the endpoint, hides the connection buttons, and stops agents from discovering it through `llms.txt` or agent prompts. +## Frequently asked questions + + + + No. The MCP server is included automatically on every Fern docs site that has Ask Fern enabled. There is no separate plan or add-on required. + + + Yes, indirectly. The MCP server enforces the same access control as a browser request. On authenticated sites, the caller must pass a valid JWT in the `FERN_TOKEN` header; the server only returns content the token's roles allow. There is no per-user MCP credential — each caller supplies their own token. See the [Authenticated sites](#authenticated-sites) section above for how to obtain and pass a token. + + + Each message sent through the MCP server runs Ask Fern under the hood and consumes 2 AI credits, the same as a direct Ask Fern query. Automated tests can be excluded from analytics (and still consume credits) using the `x-fern-skip-save-query` header described in the [Exclude test and eval traffic from analytics](#exclude-test-and-eval-traffic-from-analytics) section. + + + `llms.txt` is generated automatically from your published documentation every time you publish. There is no manual regeneration command — republishing your docs with `fern docs publish` updates it. If the file looks stale, check that your latest publish completed successfully. + + + Yes. Self-hosted containers serve `/_mcp/server` without Ask Fern or AI credits. Instead of the RAG pipeline, the self-hosted server exposes `searchDocs` (keyword search) and `fetchPage` (returns a page's Markdown). See the [Self-hosted containers](#self-hosted-containers) section for details. + + + ## Other ways agents can access your docs Agents can also fetch documentation directly over HTTP. Fern serves clean Markdown via [per-page URLs and `llms.txt`](/learn/docs/ai-features/markdown) — including on authenticated sites.