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