From fa15d32bd1e906dd92d8c5910683cb8445685ef2 Mon Sep 17 00:00:00 2001
From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com>
Date: Sun, 1 Nov 2026 16:32:00 +0000
Subject: [PATCH] Add FAQ accordion section to MCP server page

---
 fern/products/docs/pages/ai/mcp-server.mdx | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/fern/products/docs/pages/ai/mcp-server.mdx b/fern/products/docs/pages/ai/mcp-server.mdx
index 9152975006..d945e3e05e 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
+
+<AccordionGroup>
+  <Accordion title="Is the MCP server a separate SKU or add-on?">
+    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.
+  </Accordion>
+  <Accordion title="Can the MCP server be scoped by user or role?">
+    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.
+  </Accordion>
+  <Accordion title="How many AI credits does the MCP server use?">
+    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.
+  </Accordion>
+  <Accordion title="Can the llms.txt file be updated or forcibly regenerated?">
+    `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.
+  </Accordion>
+  <Accordion title="Does the MCP server work on self-hosted containers?">
+    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.
+  </Accordion>
+</AccordionGroup>
+
 ## 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.