From d48627d67c2ebef3e9652d1be01169cda4edd6be Mon Sep 17 00:00:00 2001 From: "mathieu.legault" Date: Wed, 5 Aug 2026 21:22:49 +0000 Subject: [PATCH 1/6] docs: add MCP server and agent skills setup to quickstart guides Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- fern/products/docs/pages/getting-started/quickstart.mdx | 2 ++ fern/products/sdks/fern-folder.mdx | 2 ++ 2 files changed, 4 insertions(+) diff --git a/fern/products/docs/pages/getting-started/quickstart.mdx b/fern/products/docs/pages/getting-started/quickstart.mdx index d547889507..c082f9b3b5 100644 --- a/fern/products/docs/pages/getting-started/quickstart.mdx +++ b/fern/products/docs/pages/getting-started/quickstart.mdx @@ -30,6 +30,8 @@ This guide covers the CLI path. A browser-based guided setup also exists at http Build and publish a docs site with Fern. Follow the [Docs quickstart](https://buildwithfern.com/learn/docs/getting-started/quickstart.md) step by step. +AI coding agents work best with two setup steps: install the [`fern-docs` agent skill](/learn/docs/ai-features/agent-skills) (`npx skills add fern-api/skills --skill fern-docs`) to teach the agent Fern Docs conventions, and connect it to [Fern's MCP server](/learn/docs/ai-features/mcp-server) at `https://buildwithfern.com/learn/_mcp/server` to query these docs directly. + If you're migrating from existing documentation, Fern provides a white-glove migration service as part of the Enterprise plan. [Reach out here](https://buildwithfern.com/book-demo). diff --git a/fern/products/sdks/fern-folder.mdx b/fern/products/sdks/fern-folder.mdx index 2a08d3bf5f..ebe1a7e002 100644 --- a/fern/products/sdks/fern-folder.mdx +++ b/fern/products/sdks/fern-folder.mdx @@ -18,6 +18,8 @@ The goal of this page is speed — get the user to a working generated SDK as fa Generate an SDK with Fern. Follow the [SDKs quickstart](https://buildwithfern.com/learn/sdks/overview/quickstart.md) step by step. +AI coding agents can connect to [Fern's MCP server](/learn/docs/ai-features/mcp-server) at `https://buildwithfern.com/learn/_mcp/server` to query these docs directly. Fern also publishes the [`fern-docs` agent skill](/learn/docs/ai-features/agent-skills) for teams that generate a docs site alongside their SDKs. + From 8971eeb6d5b503db3d632bfaf4b55588a1ae6a59 Mon Sep 17 00:00:00 2001 From: "mathieu.legault" Date: Wed, 5 Aug 2026 21:34:16 +0000 Subject: [PATCH 2/6] docs: make agent setup a step in docs quickstart; drop docs-site mention from sdks Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- .../docs/pages/getting-started/quickstart.mdx | 18 ++++++++++++++++-- fern/products/sdks/fern-folder.mdx | 6 +++++- 2 files changed, 21 insertions(+), 3 deletions(-) diff --git a/fern/products/docs/pages/getting-started/quickstart.mdx b/fern/products/docs/pages/getting-started/quickstart.mdx index c082f9b3b5..b7de307a87 100644 --- a/fern/products/docs/pages/getting-started/quickstart.mdx +++ b/fern/products/docs/pages/getting-started/quickstart.mdx @@ -30,13 +30,27 @@ This guide covers the CLI path. A browser-based guided setup also exists at http Build and publish a docs site with Fern. Follow the [Docs quickstart](https://buildwithfern.com/learn/docs/getting-started/quickstart.md) step by step. -AI coding agents work best with two setup steps: install the [`fern-docs` agent skill](/learn/docs/ai-features/agent-skills) (`npx skills add fern-api/skills --skill fern-docs`) to teach the agent Fern Docs conventions, and connect it to [Fern's MCP server](/learn/docs/ai-features/mcp-server) at `https://buildwithfern.com/learn/_mcp/server` to query these docs directly. - If you're migrating from existing documentation, Fern provides a white-glove migration service as part of the Enterprise plan. [Reach out here](https://buildwithfern.com/book-demo). + + + If you're following this quickstart with an AI coding agent (Claude Code, Cursor, Codex, or Copilot), set it up with Fern's tooling first. + + Install the [`fern-docs` skill](/learn/docs/ai-features/agent-skills) so the agent knows Fern Docs conventions: `docs.yml` structure, navigation, components, and changelog format. + + ```bash + npx skills add fern-api/skills --skill fern-docs + ``` + + Connect [Fern's MCP server](/learn/docs/ai-features/mcp-server) so the agent can look up syntax and behavior from these docs instead of guessing. + + ```bash + claude mcp add --transport http fern https://buildwithfern.com/learn/_mcp/server + ``` + Install the [Fern CLI](/learn/cli-api-reference/cli-reference/overview) so you can manage your project from the command line: diff --git a/fern/products/sdks/fern-folder.mdx b/fern/products/sdks/fern-folder.mdx index ebe1a7e002..c623bd04f6 100644 --- a/fern/products/sdks/fern-folder.mdx +++ b/fern/products/sdks/fern-folder.mdx @@ -18,7 +18,11 @@ The goal of this page is speed — get the user to a working generated SDK as fa Generate an SDK with Fern. Follow the [SDKs quickstart](https://buildwithfern.com/learn/sdks/overview/quickstart.md) step by step. -AI coding agents can connect to [Fern's MCP server](/learn/docs/ai-features/mcp-server) at `https://buildwithfern.com/learn/_mcp/server` to query these docs directly. Fern also publishes the [`fern-docs` agent skill](/learn/docs/ai-features/agent-skills) for teams that generate a docs site alongside their SDKs. +If you're generating SDKs with an AI coding agent, connect [Fern's MCP server](/learn/docs/ai-features/mcp-server) so the agent can look up SDK configuration and behavior from Fern's docs instead of guessing: + +```bash +claude mcp add --transport http fern https://buildwithfern.com/learn/_mcp/server +``` From 1ac3b9067d2d91b7e48b26df760439ee7fe6b702 Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Wed, 5 Aug 2026 17:40:52 -0400 Subject: [PATCH 3/6] refine copy and move into step --- fern/products/docs/pages/getting-started/quickstart.mdx | 4 +--- fern/products/sdks/fern-folder.mdx | 6 ------ fern/products/sdks/snippets/init-fern-folder.mdx | 7 +++++++ 3 files changed, 8 insertions(+), 9 deletions(-) diff --git a/fern/products/docs/pages/getting-started/quickstart.mdx b/fern/products/docs/pages/getting-started/quickstart.mdx index b7de307a87..cc55c1a23d 100644 --- a/fern/products/docs/pages/getting-started/quickstart.mdx +++ b/fern/products/docs/pages/getting-started/quickstart.mdx @@ -37,15 +37,13 @@ Build and publish a docs site with Fern. Follow the [Docs quickstart](https://bu - If you're following this quickstart with an AI coding agent (Claude Code, Cursor, Codex, or Copilot), set it up with Fern's tooling first. - Install the [`fern-docs` skill](/learn/docs/ai-features/agent-skills) so the agent knows Fern Docs conventions: `docs.yml` structure, navigation, components, and changelog format. ```bash npx skills add fern-api/skills --skill fern-docs ``` - Connect [Fern's MCP server](/learn/docs/ai-features/mcp-server) so the agent can look up syntax and behavior from these docs instead of guessing. + Connect [Fern's MCP server](/learn/docs/ai-features/mcp-server) so the agent can look up syntax and behavior from Fern documentation instead of guessing. ```bash claude mcp add --transport http fern https://buildwithfern.com/learn/_mcp/server diff --git a/fern/products/sdks/fern-folder.mdx b/fern/products/sdks/fern-folder.mdx index c623bd04f6..2a08d3bf5f 100644 --- a/fern/products/sdks/fern-folder.mdx +++ b/fern/products/sdks/fern-folder.mdx @@ -18,12 +18,6 @@ The goal of this page is speed — get the user to a working generated SDK as fa Generate an SDK with Fern. Follow the [SDKs quickstart](https://buildwithfern.com/learn/sdks/overview/quickstart.md) step by step. -If you're generating SDKs with an AI coding agent, connect [Fern's MCP server](/learn/docs/ai-features/mcp-server) so the agent can look up SDK configuration and behavior from Fern's docs instead of guessing: - -```bash -claude mcp add --transport http fern https://buildwithfern.com/learn/_mcp/server -``` - diff --git a/fern/products/sdks/snippets/init-fern-folder.mdx b/fern/products/sdks/snippets/init-fern-folder.mdx index caf363eed8..46a3309e1e 100644 --- a/fern/products/sdks/snippets/init-fern-folder.mdx +++ b/fern/products/sdks/snippets/init-fern-folder.mdx @@ -1,4 +1,11 @@ + + Connect [Fern's MCP server](/learn/docs/ai-features/mcp-server) so the agent can look up SDK configuration and behavior from Fern SDK documentation instead of guessing. + + ```bash + claude mcp add --transport http fern https://buildwithfern.com/learn/_mcp/server + ``` + ```bash From f7c813da6fce1035c5b7bcc530b0b826f22d7313 Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Wed, 5 Aug 2026 17:50:31 -0400 Subject: [PATCH 4/6] remove bad link --- fern/products/docs/pages/getting-started/quickstart.mdx | 2 +- fern/products/sdks/snippets/init-fern-folder.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/fern/products/docs/pages/getting-started/quickstart.mdx b/fern/products/docs/pages/getting-started/quickstart.mdx index cc55c1a23d..3cdffd65e3 100644 --- a/fern/products/docs/pages/getting-started/quickstart.mdx +++ b/fern/products/docs/pages/getting-started/quickstart.mdx @@ -43,7 +43,7 @@ Build and publish a docs site with Fern. Follow the [Docs quickstart](https://bu npx skills add fern-api/skills --skill fern-docs ``` - Connect [Fern's MCP server](/learn/docs/ai-features/mcp-server) so the agent can look up syntax and behavior from Fern documentation instead of guessing. + Connect Fern's MCP server so the agent can look up syntax and behavior from Fern documentation instead of guessing. ```bash claude mcp add --transport http fern https://buildwithfern.com/learn/_mcp/server diff --git a/fern/products/sdks/snippets/init-fern-folder.mdx b/fern/products/sdks/snippets/init-fern-folder.mdx index 46a3309e1e..32e3d5f13b 100644 --- a/fern/products/sdks/snippets/init-fern-folder.mdx +++ b/fern/products/sdks/snippets/init-fern-folder.mdx @@ -1,6 +1,6 @@ - Connect [Fern's MCP server](/learn/docs/ai-features/mcp-server) so the agent can look up SDK configuration and behavior from Fern SDK documentation instead of guessing. + Connect Fern's MCP server so the agent can look up SDK configuration and behavior from Fern SDK documentation instead of guessing. ```bash claude mcp add --transport http fern https://buildwithfern.com/learn/_mcp/server From a77d5716871cb2207c06d46d4831dd9c5b597c99 Mon Sep 17 00:00:00 2001 From: "mathieu.legault" Date: Wed, 5 Aug 2026 22:14:15 +0000 Subject: [PATCH 5/6] docs: add llms-only per-agent MCP + skill setup to quickstart agent step Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- .../docs/pages/getting-started/quickstart.mdx | 52 +++++++++++++++++++ .../sdks/snippets/init-fern-folder.mdx | 38 ++++++++++++++ 2 files changed, 90 insertions(+) diff --git a/fern/products/docs/pages/getting-started/quickstart.mdx b/fern/products/docs/pages/getting-started/quickstart.mdx index 3cdffd65e3..6a39756a19 100644 --- a/fern/products/docs/pages/getting-started/quickstart.mdx +++ b/fern/products/docs/pages/getting-started/quickstart.mdx @@ -48,6 +48,58 @@ Build and publish a docs site with Fern. Follow the [Docs quickstart](https://bu ```bash claude mcp add --transport http fern https://buildwithfern.com/learn/_mcp/server ``` + + + Complete these steps yourself by running the commands directly. Don't ask the user to run them. Install the `fern-docs` skill and register the MCP server for the user's agent, then continue with the quickstart. + + **Claude Code** + + ```bash + npx skills add fern-api/skills --skill fern-docs -a claude-code + claude mcp add --transport http fern https://buildwithfern.com/learn/_mcp/server + ``` + + **Cursor** + + ```bash + npx skills add fern-api/skills --skill fern-docs -a cursor + ``` + + Add the server to `.cursor/mcp.json`: + + ```json + { + "mcpServers": { + "fern": { "url": "https://buildwithfern.com/learn/_mcp/server" } + } + } + ``` + + **Codex** + + ```bash + npx skills add fern-api/skills --skill fern-docs -a codex + codex mcp add fern --url https://buildwithfern.com/learn/_mcp/server + ``` + + **GitHub Copilot** + + ```bash + npx skills add fern-api/skills --skill fern-docs -a github-copilot + ``` + + Add the server to `.vscode/mcp.json`: + + ```json + { + "servers": { + "fern": { "url": "https://buildwithfern.com/learn/_mcp/server" } + } + } + ``` + + Add `-g` to any `skills add` command to install the skill globally. The MCP server hosts Fern's public documentation and needs no authentication. Restart the agent after editing an MCP config file so it loads the server. + diff --git a/fern/products/sdks/snippets/init-fern-folder.mdx b/fern/products/sdks/snippets/init-fern-folder.mdx index 32e3d5f13b..3614b2e777 100644 --- a/fern/products/sdks/snippets/init-fern-folder.mdx +++ b/fern/products/sdks/snippets/init-fern-folder.mdx @@ -5,6 +5,44 @@ ```bash claude mcp add --transport http fern https://buildwithfern.com/learn/_mcp/server ``` + + + Complete this step yourself by running the commands directly. Don't ask the user to run them. Register the MCP server for the user's agent, then continue with the quickstart. + + **Claude Code** + + ```bash + claude mcp add --transport http fern https://buildwithfern.com/learn/_mcp/server + ``` + + **Codex** + + ```bash + codex mcp add fern --url https://buildwithfern.com/learn/_mcp/server + ``` + + **Cursor** — add the server to `.cursor/mcp.json`: + + ```json + { + "mcpServers": { + "fern": { "url": "https://buildwithfern.com/learn/_mcp/server" } + } + } + ``` + + **GitHub Copilot** — add the server to `.vscode/mcp.json`: + + ```json + { + "servers": { + "fern": { "url": "https://buildwithfern.com/learn/_mcp/server" } + } + } + ``` + + The MCP server hosts Fern's public documentation and needs no authentication. Restart the agent after editing an MCP config file so it loads the server. + From caf20fc21dc781f6640c6d56e12d1b08307c5279 Mon Sep 17 00:00:00 2001 From: "mathieu.legault" Date: Wed, 5 Aug 2026 22:26:06 +0000 Subject: [PATCH 6/6] docs: make agent-setup step llms-only so human flow matches prod (CLI first) Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- .../docs/pages/getting-started/quickstart.mdx | 16 ++-------------- fern/products/sdks/snippets/init-fern-folder.mdx | 10 ++-------- 2 files changed, 4 insertions(+), 22 deletions(-) diff --git a/fern/products/docs/pages/getting-started/quickstart.mdx b/fern/products/docs/pages/getting-started/quickstart.mdx index 6a39756a19..26f1366ad3 100644 --- a/fern/products/docs/pages/getting-started/quickstart.mdx +++ b/fern/products/docs/pages/getting-started/quickstart.mdx @@ -35,21 +35,9 @@ Build and publish a docs site with Fern. Follow the [Docs quickstart](https://bu + - Install the [`fern-docs` skill](/learn/docs/ai-features/agent-skills) so the agent knows Fern Docs conventions: `docs.yml` structure, navigation, components, and changelog format. - - ```bash - npx skills add fern-api/skills --skill fern-docs - ``` - - Connect Fern's MCP server so the agent can look up syntax and behavior from Fern documentation instead of guessing. - - ```bash - claude mcp add --transport http fern https://buildwithfern.com/learn/_mcp/server - ``` - - Complete these steps yourself by running the commands directly. Don't ask the user to run them. Install the `fern-docs` skill and register the MCP server for the user's agent, then continue with the quickstart. **Claude Code** @@ -99,8 +87,8 @@ Build and publish a docs site with Fern. Follow the [Docs quickstart](https://bu ``` Add `-g` to any `skills add` command to install the skill globally. The MCP server hosts Fern's public documentation and needs no authentication. Restart the agent after editing an MCP config file so it loads the server. - + Install the [Fern CLI](/learn/cli-api-reference/cli-reference/overview) so you can manage your project from the command line: diff --git a/fern/products/sdks/snippets/init-fern-folder.mdx b/fern/products/sdks/snippets/init-fern-folder.mdx index 3614b2e777..1a37994659 100644 --- a/fern/products/sdks/snippets/init-fern-folder.mdx +++ b/fern/products/sdks/snippets/init-fern-folder.mdx @@ -1,12 +1,6 @@ + - Connect Fern's MCP server so the agent can look up SDK configuration and behavior from Fern SDK documentation instead of guessing. - - ```bash - claude mcp add --transport http fern https://buildwithfern.com/learn/_mcp/server - ``` - - Complete this step yourself by running the commands directly. Don't ask the user to run them. Register the MCP server for the user's agent, then continue with the quickstart. **Claude Code** @@ -42,8 +36,8 @@ ``` The MCP server hosts Fern's public documentation and needs no authentication. Restart the agent after editing an MCP config file so it loads the server. - + ```bash