diff --git a/apps/docs/content/docs/ai/getting-started.mdx b/apps/docs/content/docs/ai/getting-started.mdx
index 458dc8e0..1da58953 100644
--- a/apps/docs/content/docs/ai/getting-started.mdx
+++ b/apps/docs/content/docs/ai/getting-started.mdx
@@ -6,34 +6,46 @@ description: Follow the ProofKit AI path from install to deployed Web Viewer app
import { Callout } from "fumadocs-ui/components/callout";
import { Step, Steps } from "fumadocs-ui/components/steps";
-This guide is the happy path for ProofKit v2. It mirrors the planned video series: install and connect, explore your FileMaker file, build a Web Viewer app, and deploy it back into FileMaker.
+This guide is the happy path for ProofKit v2. It mirrors the planned video series: install ProofKit, connect and verify your FileMaker file, explore your file, build a Web Viewer app, and deploy it back into FileMaker.
- Embed the complete install-to-deploy walkthrough here, or link to the four individual videos once they are published.
+ Embed the complete install-to-deploy walkthrough here, or link to the individual videos once they are published.
## Before you start
You need FileMaker Pro, a supported Node.js LTS release, and an MCP-compatible coding agent such as Cursor, Claude Code, Codex, OpenCode, or another agent that can use MCP servers.
-For Node.js, choose a release that is explicitly marked LTS. Today that means **Node.js 22**, **Node.js 24**, or **Node.js 26**. If you are setting up Node for the first time, start with the [official Node.js download page](https://nodejs.org/en/download/).
+For Node.js, choose a release that is explicitly marked LTS. If you are setting up Node for the first time, start with the [official Node.js download page](https://nodejs.org/en/download/).
If you are using a chat-first tool such as Claude Desktop or ChatGPT, you can still use ProofKit to explore FileMaker metadata and data. Building Web Viewer apps requires a coding agent that can work in a project folder. See [Chat Mode vs Code Mode](/docs/ai/chat-vs-code-mode) for the difference.
See [Technical Requirements](/docs/ai/technical-requirements) for the full support matrix.
-## The four-step path
+## The five-step path
- **Install ProofKit and connect to your FileMaker file.**
+ **Install ProofKit and add it to your FileMaker file.**
- Run the installer, add the ProofKit add-on to your file, enable the plug-in if needed, and confirm your agent can see the open file.
+ Run the installer and add the ProofKit add-on to your file.
Continue with [Install and Connect](/docs/ai/install-and-connect).
-
- Show downloading ProofKit, installing the add-on, enabling the plug-in, and confirming the agent can see the file.
+
+ Show downloading ProofKit and installing the add-on.
+
+
+
+
+ **Connect your FileMaker file to MCP and verify it.**
+
+ Run the **Connect to MCP** script in FileMaker Pro, keep the connector Web Viewer open in Browse mode, and ask your agent to confirm it can see the open file.
+
+ Continue with [Install and Connect](/docs/ai/install-and-connect#verify-the-connection).
+
+
+ Show running the Connect to MCP script, leaving the connector open, and confirming the agent can see the file.
diff --git a/apps/docs/content/docs/ai/install-and-connect.mdx b/apps/docs/content/docs/ai/install-and-connect.mdx
index 081eff73..97ad8452 100644
--- a/apps/docs/content/docs/ai/install-and-connect.mdx
+++ b/apps/docs/content/docs/ai/install-and-connect.mdx
@@ -8,7 +8,7 @@ import { Step, Steps } from "fumadocs-ui/components/steps";
The first milestone is simple: your coding agent should be able to communicate with an open FileMaker file through ProofKit.
-ProofKit installs several pieces that work together: a FileMaker add-on, a FileMaker plug-in, an MCP server, and agent integrations.
+ProofKit installs several pieces that work together: a FileMaker add-on, a FileMaker plug-in, a connector script, an MCP server, and agent integrations.
Capture the installer screen for macOS, including any step where the agent integrations are selected or confirmed.
@@ -36,9 +36,15 @@ ProofKit installs several pieces that work together: a FileMaker add-on, a FileM
- **Enable the plug-in if FileMaker asks.**
+ **Run the Connect to MCP script.**
- The plug-in provides the local API used by the MCP server and the Web Viewer proxy used for verification.
+ In FileMaker Pro, run the **Connect to MCP** script installed by the add-on. It opens the connector Web Viewer that registers your file with the local MCP server.
+
+
+
+ **Keep the connector open and enable the plug-in if asked.**
+
+ Leave the connector Web Viewer open in Browse mode while you work. The plug-in provides the local API used by the MCP server and the Web Viewer proxy used for verification.
@@ -56,7 +62,7 @@ If nothing is connected, tell me what to fix before I continue.
_Claude Code following the prompt and confirming the connected file and layouts._
-If the agent cannot see your file, open FileMaker Pro, run the **Connect to MCP** script in your file, and keep the connector Web Viewer open in Browse mode. For the full checklist, see [fmBridge troubleshooting](/docs/webviewer/fm-bridge#troubleshooting).
+If the agent cannot see your file, re-run **Connect to MCP** in FileMaker Pro and confirm the connector Web Viewer remains open in Browse mode. For the full checklist, see [fmBridge troubleshooting](/docs/webviewer/fm-bridge#troubleshooting).
## Next step