Setup Guide

Add the URL first, then start after the client-side first authentication.

Open the MCP add screen in your AI client and paste the FORMLOVA URL. You do not need an account to review the setup or register the URL. On real use, the client starts the authentication flow where you can log in or sign up.

3 steps to get started

Open the MCP add screen

In the AI client you already use, open the screen for adding an MCP server.

Add the FORMLOVA URL in your client MCP settings.

Authenticate on first use

When you first use FORMLOVA, the client starts the authentication flow where you can log in or sign up.

If you prefer to create an account before connecting, start here.Create a free account

The easiest way to start

Ask your AI chat, "How do I add an MCP server?" Once it opens the right settings screen, paste the URL below and save it.

MCP Server URL

https://formlova.com/api/mcp

Settings menus and setup steps can change without notice when clients update. If you get stuck, asking your AI client directly "How do I add an MCP server?" is often the fastest way.

Supported Clients

Examples for major clients. The exact add screen and reload behavior vary by client.

Web / App

Claude

Standard setup

Claude: Settings > MCP > Add Remote Server

Official docs

ChatGPT

Standard setup

Enable ChatGPT developer mode first, then use Add MCP

Official docs

Developer Tools

One-shot setup (optional)

For developer tools. Generates project-level config files in one command. Authentication and client reload still happen separately.

bash

npx -y formlova-mcp install --client all --scope project --yes

Public helper repository

README, helper CLI, and sample configs are collected in this public repository.

https://github.com/formlova/formlova-mcp

Claude Code

Standard setup

Add from Claude Code CLI

bash

claude mcp add --transport http formlova https://formlova.com/api/mcp

Official docs

Gemini CLI

Standard setup

Add using Gemini CLI mcp add

bash

gemini mcp add --transport http formlova https://formlova.com/api/mcp

Official docs

Codex

Standard setup

Add from Codex CLI

bash

codex mcp add formlova --url https://formlova.com/api/mcp

Official docs

Cursor

Standard setup

Settings > MCP > Add new MCP server

Config-file setup

json

{
  "mcpServers": {
    "formlova": {
      "url": "https://formlova.com/api/mcp"
    }
  }
}

Official docs

Client-side setup menus and steps may change without notice.

Try these first

Once first authentication is complete and the client has loaded the tools, just talk to your AI chat.

“"Create a form"”

Asks about your goals, then creates a form and returns the URL.

“"Match this screenshot"”

Applies the visual tone of your screenshot to the form design.

“"Show me the current status"”

Shows response counts and statuses across all your forms.

Troubleshooting

Cannot connect+

Check that the URL is correct. All clients use https://formlova.com/api/mcp. Make sure there are no extra slashes or characters.

Authentication screen does not appear+

Your browser's popup blocker may be the cause. Allow popups for formlova.com and try again.

Cannot return to client after authentication+

Make sure you are logged in to FORMLOVA in your browser, then reconnect from the client. Some clients require you to switch windows manually.

Tools are not showing+

Restart the client. Tool discovery can take a moment after the first connection. If tools still do not appear, remove the connection and add it again.

Only some tools are showing+

Restart the client. The tool list may not have refreshed yet. If it still doesn't update after restarting, remove the connection and add it again.

A public form URL does not recreate the fields+

Private or login-required pages cannot be extracted. Use a publicly accessible form URL that anyone can open.

The screenshot match is close but not exact+

A screenshot alone may not reveal the exact font name, hover states, or hidden elements. Adding a public image URL or a public page URL usually improves accuracy.

A cloned external form behaves a little differently+

Visible fields can be recreated, but service-specific behaviors like confirm-email validation or complex branching may still need review after cloning.

"Unauthorized" error+

Your session may have expired or the client-side authentication may not have completed cleanly. Remove the connection, add it again, and repeat authentication.

I ran the helper install, but it still does not work+

The install helper only writes config files. Reopen the client or reload MCP settings, then complete the authentication flow on first use.

Connection error on ChatGPT+

In ChatGPT, enable developer mode first and then use Add MCP. Settings & Integrations and Add MCP are separate flows. Confirm the URL is https://formlova.com/api/mcp, and if /api/sse is configured, remove it and re-add with /api/mcp.

Cursor status shows red+

Check that the URL is correct in settings, then click "Reconnect". If it still does not work, remove the configuration and add it again.

Cannot create forms / "plan limit" error+

Form creation is unlimited on all plans, including the free plan. If you see this error, log out and log back in. If it persists, clear your browser cache and try again.

Responses come back in English even though I'm chatting in Japanese+

Change your language to Japanese in your profile settings. Just say "Set my profile language to Japanese" in the chat.

File upload error+

Supported formats: PDF, Word, Excel, PowerPoint, images (JPEG / PNG / GIF / WebP), text, CSV, and ZIP. The limit is 10 MB per file. Uploads that exceed these constraints will fail. File upload is available on the Standard plan and above.

A field type is not showing on the form+

FORMLOVA supports 29 field types. hidden_field is invisible to respondents and is used for UTM parameters and tracking. statement and section_break are display-only elements used for descriptions and visual separation -- they do not require input. This behavior is intentional.

Emails are not being delivered+

Check your email sending quota. Monthly limits are 100 for the Free plan, 1,000 for the Standard plan, and 10,000 for the Premium plan. Quotas reset on the first day of each month. Recipients on the suppression list will not receive emails.

The form is loading slowly+

If the form has many fields, try splitting it into multiple pages. You can assign page numbers when creating the form to divide it across pages.

All set?

Explore the usage guide to see all features and prompt examples.

View the guide

Don't have an account yet? Get started for free