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

1

Open the MCP add screen

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

2

Register the URL

Add the FORMLOVA URL in your client MCP settings.

3

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

Register this URL in your client MCP settings.

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.

Connection requirements by client

Choose the AI client you use to see only its requirements and connection steps.

Last verified against each client's official information on 2026-08-27.

Claude

Web / App

Requirements
Available on Free, Pro, Max, Team, and Enterprise. Free is limited to one custom connector.
Connection method
In Claude, open Customize > Connectors, add the FORMLOVA remote MCP URL, and authenticate with OAuth.
Read support
Supported Read supported. You can use read-oriented MCP tools for forms, responses, analytics, and more.
Write support
Supported Write supported. You can use write-oriented MCP tools for creation, updates, delivery, and more.
Limitations
Free is limited to one custom connector. On Team and Enterprise, an Owner must add the connector first.
Official source
Connection and operations
View the detailed setup guide
Compare all clients

Claude

Requirements
Available on Free, Pro, Max, Team, and Enterprise. Free is limited to one custom connector.
Connection method
In Claude, open Customize > Connectors, add the FORMLOVA remote MCP URL, and authenticate with OAuth.
Read support
Read supported. You can use read-oriented MCP tools for forms, responses, analytics, and more.
Write support
Write supported. You can use write-oriented MCP tools for creation, updates, delivery, and more.
Limitations
Free is limited to one custom connector. On Team and Enterprise, an Owner must add the connector first.

ChatGPT

Requirements
Available on Plus and Pro on the web. Business, Enterprise, and Edu are also officially eligible for developer mode.
Connection method
In ChatGPT on the web, enable Developer mode under Settings > Security and login, create a remote MCP app for FORMLOVA, and authenticate with OAuth.
Read support
Read supported. FORMLOVA read-oriented MCP tools are available in Developer mode.
Write support
Write supported. FORMLOVA write-oriented MCP tools are available in Developer mode.
Limitations
Developer mode on the web is required. Write actions follow ChatGPT confirmation settings and FORMLOVA permissions.

Claude Code

Requirements
Requires an Anthropic account with access to Claude Code or an environment with Anthropic API access.
Connection method
Add the FORMLOVA URL with `claude mcp add --transport http`, then authenticate with OAuth.
Read support
Read supported. Claude Code can use FORMLOVA read-oriented MCP tools.
Write support
Write supported. Claude Code can use FORMLOVA write-oriented MCP tools.
Limitations
Check the local, project, or user configuration scope and the approval state of project-scoped settings.

Gemini CLI

Requirements
Requires a Google account, Google Cloud environment, or API key that can use Gemini CLI.
Connection method
Add the FORMLOVA HTTP URL under `mcpServers` in `settings.json`, then authenticate with OAuth.
Read support
Read supported. Gemini CLI can use FORMLOVA read-oriented MCP tools.
Write support
Write supported. Gemini CLI can use FORMLOVA write-oriented MCP tools.
Limitations
Availability follows the settings-file scope, tool trust settings, and granted OAuth permissions.

Codex

Requirements
Available with ChatGPT Free, Go, Plus, Pro, Business, Edu, or Enterprise, or with an API key.
Connection method
Add the FORMLOVA remote URL to the Codex MCP configuration, then authenticate with OAuth.
Read support
Read supported. Codex can use FORMLOVA read-oriented MCP tools.
Write support
Write supported. Codex can use FORMLOVA write-oriented MCP tools.
Limitations
API key usage is billed at OpenAI API rates. Write actions follow Codex approval settings and FORMLOVA permissions.

Cursor

Requirements
Requires an MCP-compatible version of Cursor and an eligible Cursor account.
Connection method
Register the FORMLOVA remote URL in Cursor MCP settings, then authenticate with OAuth.
Read support
Read supported. Cursor Agent can use FORMLOVA read-oriented MCP tools.
Write support
Write supported. Cursor Agent can use FORMLOVA write-oriented MCP tools.
Limitations
Availability follows Agent mode, MCP tool enablement, execution approvals, and FORMLOVA permissions.

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. Copy errors are common -- make sure there are no extra slashes or characters.

Cannot connect from Claude+

Claude on the Free plan allows one custom connector only. Team / Enterprise may require Owner permission for connector setup.

Connection error on ChatGPT+

On ChatGPT Plus / Pro web, enable developer mode first, then connect using Add MCP. If configured with /api/sse, remove it and re-add with https://formlova.com/api/mcp.

Cannot connect from Codex+

Add FORMLOVA from Codex MCP settings. This is a separate flow from ChatGPT web, and you can use the API key path when needed.

Authentication screen does not appear+

Your browser's popup blocker may be the cause. Most clients use a browser window for authentication. Allow popups for formlova.com and try again.

Tools are not showing+

Restart the client. The tool list needs to load after the first connection. If it still does not update, remove the connection and add it again.

"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.

Cursor status shows red+

Check the URL in settings and try Reconnect. If it still does not work, remove the connection and add it again.

Can I use multiple clients at the same time?+

Yes. You can connect from multiple clients simultaneously with the same FORMLOVA account. Data is synced in real time.

Screenshot match is close but not exact+

AI interpretation cannot guarantee a perfect match. Providing a public image URL or page URL as additional context improves accuracy. Specifying the exact font name helps further.

Responses come back in the wrong language+

Change your language in profile settings. You can also say "Set my language to English" in the chat.

Cannot create a form / plan limit error+

Some features require the Standard or Premium plan. Form creation itself is unlimited on all plans. Say "Tell me about plans" in the chat to check your plan details.

File upload error+

Supported formats: JPEG, PNG, GIF, WebP, PDF, Word, Excel, PowerPoint, TXT, CSV, and ZIP. The effective per-file limit is 4 MB (images are auto-compressed in the browser to fit; non-image files above 4 MB are rejected). Storage retains files up to 25 MB, but the effective submission limit is the ceiling. File upload requires the Standard plan or above.

Emails are not being delivered+

Check your monthly sending limit (Free: 100, Standard: 1,000, Premium: 10,000). Limits reset on the first of each month. Recipients on the suppression list will not receive emails.

A cloned external form behaves differently+

Cloning recreates only the visible field structure. Internal logic such as conditional branching and validation rules must be configured manually after cloning.

Webhook notifications are not arriving+

Check the receiving endpoint URL and its response code. You can review delivery history and failure reasons in the Webhook logs on the dashboard.

Cannot log in to the dashboard+

Try resetting your password. If the reset email does not arrive, double-check the email address for typos.

Data appears to be missing+

FORMLOVA never deletes data on its own. Check whether the form is archived or if a filter is active. If you still cannot find it, please contact support.

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