# MCP setup generator

> Connect FormDoc’s MCP server to Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Gemini CLI or Codex. Pick your assistant and copy the exact setup.

Pick your AI assistant and copy the exact setup that connects it to FormDoc’s MCP server. Once connected, your assistant can create a form, fetch the code for your framework, test it and check the forms in your project. It works with Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Gemini CLI and Codex.

-   Free
-   No account
-   Runs in your browser
-   Updated 2 November 2026

## Get your setup

Your AI assistant 

Your computer  macOS or Linux  Windows

You need Node.js 18 or newer. FormDoc’s server runs with npx, so there’s nothing else to install.

### Setup

## How to use the MCP setup generator

1.  Choose your AI assistant and your computer’s operating system.
2.  Copy the command or the settings shown.
3.  Paste it where the generator says: your terminal, or the assistant’s MCP settings file.
4.  Restart or refresh the assistant and check that FormDoc is connected.
5.  Ask the assistant to add a contact form to your site with FormDoc.

## What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants use tools outside the chat. FormDoc’s MCP server runs on your computer with `npx -y @formdocdev/cli mcp` and gives your assistant a few form tools. There’s nothing to install beyond Node.js 18 or newer.

## What your assistant can do with FormDoc

| Tool | What it does |
| --- | --- |
| `create_form` | Creates a form for your email address. You confirm it from your inbox and get the access key |
| `get_verification_status` | Checks whether the form is confirmed and active |
| `get_snippet` | Returns ready form code for HTML, Astro or vagejs, with your key filled in |
| `send_test_submission` | Sends one real test to your inbox |
| `check_forms_in_project` | Finds forms in your project that post to FormDoc and lists problems |

The assistant is told to ask for your real email address and never to make one up. It can’t read your submissions: those stay in your inbox and your FormDoc dashboard.

## Tips

-   **Use it inside your project.** Assistants that edit code (Claude Code, Cursor, VS Code, Windsurf) can paste the form into the right file for you.
-   **Confirm the email.** FormDoc sends a confirmation link the first time; the form starts working when you click it.
-   **Check afterwards.** Ask the assistant to run `check_forms_in_project`, or paste the form into the [AI form checker](https://www.formdoc.dev/tools/ai-form-checker/).

Prefer the terminal or a different assistant? The [AI assistants guide](https://www.formdoc.dev/docs/ai-assistants/) covers the command line tool too, and the [AI form prompt generator](https://www.formdoc.dev/tools/ai-form-prompt-generator/) writes prompts for tools without MCP.

## Common questions

### Is FormDoc’s MCP server free?

Yes. The server is free, and forms on FormDoc’s Free plan receive 250 submissions a month.

### Why does Windows need cmd /c?

Some apps on Windows can’t start npx directly, because npx is a script rather than a program. Running it through cmd /c works everywhere, so the generator adds it when you choose Windows.

### Does the assistant need my password or an API key?

No. Creating a form only needs your email address, and you confirm it yourself by clicking the link FormDoc sends.

### The assistant says FormDoc isn’t connected. What should I check?

Make sure Node.js 18 or newer is installed (run node --version), that the settings file is valid JSON with the formdoc entry inside the servers list, and that you restarted the assistant after saving.