docs(ai): Add Fern Agent and MCP docs by devin-ai-integration[bot] · Pull Request #6672 · fern-api/docs

devin-ai-integration · 2026-08-18T16:18:42Z

Summary

Combines the full content of #6624 and #6557 into one branch so the AI features section lands as a single coherent restructure. Both original PRs are closed in favor of this one; no content was dropped from either.

From #6624: new pages/ai/fern-agent.mdx (dashboard agent — docs edits handed to an editor session, the analytics it can query, site config and deployment history, dashboard links for what it can't do), new pages/ai/fern-slack.mdx replacing ai/writer.mdx and superseding ask-fern/slack-app.mdx (one @Fern bot, per-capability setup because the two Slack installations are still separate), redirects for /learn/docs/ai-features/fern-writer and /learn/docs/ai-features/ask-fern/slack-app, the AI credits row rename to Docs update in Slack, and the 2026-08-13 changelog entry.

From #6557: new pages/ai/fern-mcp-servers.mdx (both Fern-hosted MCP servers, per-client setup, fern mcp install as the primary path, the OAuth-needs-a-human and next-session-load facts), the fern mcp install CLI reference accordion, and "Set up your coding agent" no longer llms-only in the Docs quickstart and the SDK init-fern-folder snippet.

The only real conflict was the AI features nav in fern/products/docs/docs.yml, where both PRs restructured the same region. Resolved to keep #6557's MCP / Agent skills "For your site" vs. "For building with Fern" split while slotting in #6624's pages and preserving main's hidden agent-setup entry:

- page: Fern Agent            # 6624
- page: Fern in Slack         # 6624
- section: MCP                # 6557
    - For your site           -> ai/mcp-server.mdx
    - For building with Fern  -> ai/fern-mcp-servers.mdx
- section: Agent skills       # 6557 + main
    - Agent setup (hidden)
    - For your site           -> ai/host-skills.mdx
    - For building with Fern  -> ai/agent-skills.mdx

ai/overview.mdx auto-merged cleanly: both PRs' card groups coexist (Fern Agent + @fern in Slack under "Create and update content"; Fern's MCP servers added to "Build your docs with an agent"). API catalog discovery keeps #6557's single position above llms-txt rather than being listed twice.

Validation

fern check --warnings: 0 errors, 6 pre-existing warnings (endpoint path conflicts, FDR 403 on the redirects check, accent-color contrast).
pre-commit (vale) on the changed files: 0 errors on touched lines; the one error reported is a pre-existing Microsoft.Contractions hit on an untouched line of self-hosted.mdx.
Every page path in the AI nav exists and appears once; no links remain to the removed Writer or Ask Fern Slack app pages (the 2026-02-27 changelog link is covered by the new redirect).

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

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

…d timing Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

… 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>

…://github.com/fern-api/docs into devin/1786035479-authenticated-mcp-quickstart

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

Beta/allowlisted availability, dashboard editor-first delivery, actual analytics and org capabilities, plus a Fern Agent card on the AI features overview. 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>

…eb' into devin/1787069687-combine-ai-docs

…6624) Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

devin-ai-integration · 2026-08-18T16:18:44Z

🤖 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

github-actions · 2026-08-18T16:20:17Z

🌿 Preview your docs: https://fern-preview-devin-1787069687-combine-ai-docs.docs.buildwithfern.com/learn

Here are the markdown pages you've updated:

github-actions · 2026-08-18T17:15:21Z

+
+## Your organization's server
+
+The organization server is private: each connection is scoped to a single organization, and the server returns only what your Fern account can already see. It is how you reach [Fern Agent](/learn/docs/ai-features/fern-agent) from your terminal, and it exposes your live Fern data to your agent, including:


🚫 [vale] <Microsoft.Contractions> _{reported by reviewdog 🐶}
Use 'it's' instead of 'It is'.

Suggested change

The organization server is private: each connection is scoped to a single organization, and the server returns only what your Fern account can already see. It is how you reach [Fern Agent](/learn/docs/ai-features/fern-agent) from your terminal, and it exposes your live Fern data to your agent, including:

The organization server is private: each connection is scoped to a single organization, and the server returns only what your Fern account can already see. it's how you reach [Fern Agent](/learn/docs/ai-features/fern-agent) from your terminal, and it exposes your live Fern data to your agent, including:

github-actions · 2026-08-18T17:15:21Z

@@ -0,0 +1,17 @@
+## Fern Agent


📝 [vale] <FernStyles.Headings> _{reported by reviewdog 🐶}
'Fern Agent' should use sentence-style capitalization.

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

…/fern-api/docs into devin/1787069687-combine-ai-docs

github-actions · 2026-08-18T18:37:30Z

+<br />
+
+<Prompt title="Reorganize navigation">
+Give me suggestions about how to optimize my navigation based on site analytics.


📝 [vale] <FernStyles.FirstPerson> _{reported by reviewdog 🐶}
Use first person (such as 'me') sparingly.

github-actions · 2026-08-18T18:37:31Z

+<br />
+
+<Prompt title="Follow up on empty searches">
+Find the search queries that returned no results, then add the missing content to the API reference guide.


🚫 [vale] <FernStyles.Reject> _{reported by reviewdog 🐶}
Use 'API Reference' instead of 'API reference'.

github-actions · 2026-08-18T18:37:31Z

+Fern Agent summarizes what readers ask [Ask Fern](/learn/docs/ai-features/ask-fern/overview), including resolution rates and individual conversations, so you can find topics that need better coverage — then write that coverage without leaving the conversation.
+
+<Prompt title="Summarize reader questions">
+Summarize what readers asked Ask Fern this week and suggest ways I can expand our documentation based off of those topics.


📝 [vale] <FernStyles.FirstPerson> _{reported by reviewdog 🐶}
Use first person (such as ' I') sparingly.

github-actions · 2026-08-18T18:37:31Z

+Fern Agent summarizes what readers ask [Ask Fern](/learn/docs/ai-features/ask-fern/overview), including resolution rates and individual conversations, so you can find topics that need better coverage — then write that coverage without leaving the conversation.
+
+<Prompt title="Summarize reader questions">
+Summarize what readers asked Ask Fern this week and suggest ways I can expand our documentation based off of those topics.


📝 [vale] <FernStyles.We> _{reported by reviewdog 🐶}
Try to avoid using first-person plural like 'our'.

github-actions · 2026-08-18T18:37:31Z

+
+Open the [Fern Dashboard](https://dashboard.buildwithfern.com/) and start a conversation in the chat panel. When Fern Agent starts a docs edit, it opens a Fern Editor window and edits while you watch. From the chat panel, you can also:
+
+* **Connect Fern Agent to Slack.** Click **Connect Slack**, select the workspace, and add Fern to the Slack channels where your team discusses documentation. Authorizing the app requires Slack admin access.


⚠️ [vale] <Microsoft.UIVerbs> _{reported by reviewdog 🐶}
Use 'select' instead of the input-specific verb 'Click'.

github-actions · 2026-08-18T18:37:31Z

+Open the [Fern Dashboard](https://dashboard.buildwithfern.com/) and start a conversation in the chat panel. When Fern Agent starts a docs edit, it opens a Fern Editor window and edits while you watch. From the chat panel, you can also:
+
+* **Connect Fern Agent to Slack.** Click **Connect Slack**, select the workspace, and add Fern to the Slack channels where your team discusses documentation. Authorizing the app requires Slack admin access.
+* **Connect your agents.** Click **Onboard your agent** to connect your agent to [your organization's MCP server](/learn/docs/ai-features/fern-mcp-servers#your-organizations-server).


⚠️ [vale] <Microsoft.UIVerbs> _{reported by reviewdog 🐶}
Use 'select' instead of the input-specific verb 'Click'.

github-actions · 2026-08-18T18:37:31Z

+
+Answering reader questions in Slack is a separate capability with its own install, covered on the [Ask Fern Slack app](/learn/docs/ai-features/ask-fern/slack-app) page.
+
+## Making requests in Slack


📝 [vale] <FernStyles.Headings> _{reported by reviewdog 🐶}
'Making requests in Slack' should use sentence-style capitalization.

github-actions · 2026-08-18T18:37:31Z

+
+## Making requests in Slack
+
+Tag `@Fern` in a channel where it has been added and describe the change you need or analysis you want to conduct. It only responds when directly tagged. It reacts to your message to confirm receipt, then opens a pull request and replies with a link. At any time, you can click a link to open your session in the Fern Dashboard and see Fern Agent make the updates in Fern Editor in realtime.


⚠️ [vale] <Microsoft.UIVerbs> _{reported by reviewdog 🐶}
Use 'select' instead of the input-specific verb 'click'.

github-actions · 2026-08-18T18:37:31Z

+<Note title="Fern Agent vs. Fern Writer">
+Fern Agent is an expansion of Fern Writer. Fern Writer opened documentation pull requests from Slack, and it still does — existing installations keep working and the request flow is unchanged.
+
+What Fern Agent adds is context on your organization and more places to work from. Alongside editing, it answers questions about your traffic, reader questions, deployments, and site configuration, and the same capabilities are now available in the Fern Dashboard and over MCP rather than in Slack alone.


⚠️ [vale] <FernStyles.Current> _{reported by reviewdog 🐶}
Avoid time-relative terms like 'now' that become outdated

matlegault and others added 24 commits August 6, 2026 16:57

docs: add authenticated Fern MCP server to Docs quickstart

4c33439

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

docs: harden quickstart agent guidance for existing repos and MCP loa…

7c5144a

…d timing Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

docs: add standalone Fern MCP servers page and surface agent setup to…

8c9ccb2

… humans Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

chore: drop vendored Vale style files added by local sync

3e0ef80

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

cut down quickstart language

a27faed

docs: use plain placeholder in org-scoped MCP URL

e87e512

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

clarify content

2e7fa1b

Merge branch 'devin/1786035479-authenticated-mcp-quickstart' of https…

5e60e35

…://github.com/fern-api/docs into devin/1786035479-authenticated-mcp-quickstart

add changelog

ae20033

Merge main into authenticated-mcp-quickstart

990df8b

docs: document fern mcp install

f54ce61

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

docs: tighten fern mcp install section

811db72

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

docs: make fern mcp install the setup path for the org MCP server

f64fe8d

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

Completely rewrite the Fern Slack bot page and restructure its navigati…

3ff5fd0

Add a new documentation page about "Fern Agent" — the agentic AI chat b…

83ed1b3

Add redirects to docs.yml for the two pages that were moved or remove…

941bc07

docs: fold Fern in Slack rewrite from #6623 into the Fern Agent PR

0ab04b8

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

docs: avoid time-relative wording in the Slack answers section

5507b11

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

docs: present Fern in Slack as one bot with two capability categories

d215471

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

chore: drop vale package files pulled in by vale sync

523baf9

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

add slack app page back

bd25321

Merge remote-tracking branch 'origin/2026-08-13-fern-ai-d8be69-f788c4…

a9e1185

…eb' into devin/1787069687-combine-ai-docs

Merge MCP servers docs (#6557) into Fern Agent + Fern in Slack docs (#…

1947370

…6624) Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

devin-ai-integration Bot requested a review from devalog as a code owner August 18, 2026 16:18

This was referenced Aug 18, 2026

Add Fern Agent docs, rewrite Fern in Slack, and consolidate the Slack pages #6624

Closed

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

Closed

update framing and copy

29dbf8b

github-actions Bot reviewed Aug 18, 2026

View reviewed changes

docs(ai): broaden Fern Agent privacy section beyond Slack

f486346

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

devalog changed the title ~~docs(ai): combine Fern Agent, Fern in Slack, and Fern MCP server docs~~ docs(ai): Add Fern Agent and MCP docs Aug 18, 2026

devalog added 2 commits August 18, 2026 14:35

update setup instructions

9be3304

Merge branch 'devin/1787069687-combine-ai-docs' of https://github.com…

e3ceed4

…/fern-api/docs into devin/1787069687-combine-ai-docs

github-actions Bot reviewed Aug 18, 2026

View reviewed changes

Navigation Menu

Uh oh!

docs(ai): Add Fern Agent and MCP docs - #6672

docs(ai): Add Fern Agent and MCP docs#6672
devin-ai-integration[bot] wants to merge 28 commits into
mainfrom
devin/1787069687-combine-ai-docs

devin-ai-integration Bot commented Aug 18, 2026

Uh oh!

devin-ai-integration Bot commented Aug 18, 2026

Uh oh!

github-actions Bot commented Aug 18, 2026 •

edited

Loading

Uh oh!

github-actions Bot Aug 18, 2026

Uh oh!

github-actions Bot Aug 18, 2026

Uh oh!

github-actions Bot Aug 18, 2026

Uh oh!

github-actions Bot Aug 18, 2026

Uh oh!

github-actions Bot Aug 18, 2026

Uh oh!

github-actions Bot Aug 18, 2026

Uh oh!

github-actions Bot Aug 18, 2026

Uh oh!

github-actions Bot Aug 18, 2026

Uh oh!

github-actions Bot Aug 18, 2026

Uh oh!

github-actions Bot Aug 18, 2026

Uh oh!

github-actions Bot Aug 18, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants


		## Your organization's server

		The organization server is private: each connection is scoped to a single organization, and the server returns only what your Fern account can already see. It is how you reach [Fern Agent](/learn/docs/ai-features/fern-agent) from your terminal, and it exposes your live Fern data to your agent, including:


		Open the [Fern Dashboard](https://dashboard.buildwithfern.com/) and start a conversation in the chat panel. When Fern Agent starts a docs edit, it opens a Fern Editor window and edits while you watch. From the chat panel, you can also:

		* Connect Fern Agent to Slack. Click Connect Slack, select the workspace, and add Fern to the Slack channels where your team discusses documentation. Authorizing the app requires Slack admin access.


		Answering reader questions in Slack is a separate capability with its own install, covered on the [Ask Fern Slack app](/learn/docs/ai-features/ask-fern/slack-app) page.

		## Making requests in Slack


		## Making requests in Slack

		Tag `@Fern` in a channel where it has been added and describe the change you need or analysis you want to conduct. It only responds when directly tagged. It reacts to your message to confirm receipt, then opens a pull request and replies with a link. At any time, you can click a link to open your session in the Fern Dashboard and see Fern Agent make the updates in Fern Editor in realtime.

Uh oh!

Conversation

devin-ai-integration Bot commented Aug 18, 2026

Summary

Validation

Uh oh!

devin-ai-integration Bot commented Aug 18, 2026

🤖 Devin AI Engineer

Uh oh!

github-actions Bot commented Aug 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot Aug 18, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 18, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 18, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 18, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 18, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 18, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 18, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 18, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 18, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 18, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 18, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

github-actions Bot commented Aug 18, 2026 •

edited

Loading