Skip to content

docs: document Fern's two MCP servers and make agent setup human-visible - #6557

Open
devin-ai-integration[bot] wants to merge 13 commits into
mainfrom
devin/1786035479-authenticated-mcp-quickstart
Open

docs: document Fern's two MCP servers and make agent setup human-visible#6557
devin-ai-integration[bot] wants to merge 13 commits into
mainfrom
devin/1786035479-authenticated-mcp-quickstart

Conversation

@devin-ai-integration

@devin-ai-integration devin-ai-integration Bot commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Summary

Fern now hosts two MCP servers — the public documentation server and the authenticated organization server (https://fai.buildwithfern.com/mcp) — so this PR gives them a canonical page and reworks the quickstart mentions to point at it instead of introducing each server inline. It also absorbs #6575 (closed), which documented the fern mcp install CLI command for the same feature.

Implements docs for: feat(cli): add fern mcp install to connect coding agents using the login token (fern-api/fern#17336)

New page /learn/docs/ai-features/fern-mcp-servers. A table of both servers, per-client setup (Claude Code, Codex, Cursor, Copilot) in <CodeBlocks>, what the org server exposes (sites and config, deployments, analytics, reader signals, members), and the two operational facts agents get wrong: the OAuth login needs a human at the browser, and a server registered mid-session isn't callable until the next session. Capabilities and read-only scope were verified against fai/agent/mcp_server.py and the tool registry (docs-editing tools carry exclude_access_from={"mcp"}), including the org-scoped /organizations/{org}/mcp URL that multi-org accounts need.

fern mcp install is the primary setup path for the org server (folded in from #6575). The command reuses the token fern login already stored, so it replaces the manual per-client OAuth registration everywhere the org server is set up — the canonical page leads with it and keeps hand-registration as the alternative, and the quickstart's post-publish section is now fern mcp install rather than a claude mcp add one-liner. The CLI reference gets a fern mcp install accordion covering the fern login prerequisite, the config file written per client, the FERN_TOKEN rejection, the non-refreshing token, and the --client / --org flags; conceptual detail lives on the canonical page, which it links to.

"Set up your coding agent" is no longer llms-only in both the Docs quickstart and the SDK init-fern-folder snippet. Humans now see ~3 lines plus the Claude Code commands wrapped in <llms-ignore>, framed as "this is what your agent is about to do"; the full per-client instructions stay in <llms-only> unchanged. This also fixes the previous ordering problem where the public server first appeared, unexplained, in the post-publish org section.

Cross-links from ai/overview (card group, replacing the skills-only section), ai/mcp-server (distinguishing your site's generated server from Fern's), and agent-skills.

Also merges main to clear the conflict, which was an add/add on the 2026-08-06 changelog file — both entries are kept, and the MCP entry now mentions fern mcp install. Section headings on the new page dropped their Public: / Private: prefixes to satisfy Microsoft.HeadingColons.

Link to Devin session: https://app.devin.ai/sessions/f3cc1ad7109d48939b43d6ee8c30f180

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration
devin-ai-integration Bot requested a review from devalog as a code owner August 6, 2026 16:58
@devin-ai-integration

Copy link
Copy Markdown
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, CI, and merge conflict monitoring

…d timing

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration devin-ai-integration Bot changed the title docs: add authenticated Fern MCP server to Docs quickstart docs: add authenticated Fern MCP server and harden agent guidance in Docs quickstart Aug 6, 2026
matlegault and others added 2 commits August 6, 2026 17:22
… humans

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration devin-ai-integration Bot changed the title docs: add authenticated Fern MCP server and harden agent guidance in Docs quickstart docs: add Fern MCP servers page and org MCP setup to Docs quickstart Aug 6, 2026
@devin-ai-integration devin-ai-integration Bot changed the title docs: add Fern MCP servers page and org MCP setup to Docs quickstart docs: document Fern's two MCP servers and make agent setup human-visible Aug 6, 2026
devalog and others added 9 commits August 6, 2026 13:51
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devalog devalog added the blocked Blocked on engineering work/feature implementation, not ready to merge. label Aug 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

blocked Blocked on engineering work/feature implementation, not ready to merge.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants