# Connect an AI agent to Formstep

Add Formstep to Claude, ChatGPT, Cursor or any tool that supports remote MCP servers, sign in, and pick the workspace the agent may use.

## Before you start

- A Formstep account that is a member of the workspace you want to connect.
- An AI tool that supports remote MCP servers. Some tools limit this to certain plans; the table below links to each tool’s own guide.

An agent’s work spends no Formstep AI credits; your AI tool bills you under its own pricing. See [AI credits & usage](https://formstep.io/docs/ai/ai-credits-usage/#mcp).

## 1. Add the Formstep server to your AI tool

Every tool asks for the same thing, the server URL:

```text
https://api.formstep.io/api/mcp
```

Leave any client ID, secret or token field empty. The tool finds the sign-in page from the server and registers itself. Where to paste the URL depends on the tool:

| Tool | Where to add the URL | Official guide |
| - | - | - |
| Claude (web, desktop and mobile) | **Customize** › **Connectors** › **+** › **Add custom connector**. A connector added on claude.ai also works in the desktop and mobile apps. On Team and Enterprise, an owner adds it first under **Organization settings** › **Connectors**; on Free you can add one custom connector. | [Anthropic](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) |
| Claude Code | Run `claude mcp add --transport http formstep https://api.formstep.io/api/mcp`, then type `/mcp` in Claude Code to sign in. | [Anthropic](https://code.claude.com/docs/en/mcp) |
| ChatGPT | Turn on developer mode under **Settings** › **Apps** › **Advanced settings**. Then open **Settings** › **Apps** › **Create**, paste the URL, choose OAuth, click **Scan Tools**, sign in to Formstep, and click **Create**. Developer mode works on the web only. On Pro, ChatGPT can only read: tools that change something, such as sending a request or editing a form, need Business, Enterprise or Edu. On Business, only admins and owners can use developer mode. | [OpenAI](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt) |
| Cursor | Click [Add to Cursor](https://cursor.com/install-mcp?name=formstep\&config=eyJ1cmwiOiJodHRwczovL2FwaS5mb3Jtc3RlcC5pby9hcGkvbWNwIn0=). Or add `{"mcpServers": {"formstep": {"url": "https://api.formstep.io/api/mcp"}}}` to `.cursor/mcp.json` in your project, or to `~/.cursor/mcp.json` for every project. | [Cursor](https://cursor.com/docs/mcp) |

Any other tool that supports remote MCP servers with sign-in works the same way: look for where it adds a server by URL.

## 2. Sign in and pick the workspace

The first time the agent uses Formstep, your AI tool opens a Formstep page in the browser. Sign in if you are asked to. Formstep then shows which tool is asking, the account you are signed in as (**Not you?** switches it), what the tool may do, and the workspaces you belong to:

![The Formstep Authorize access page: Claude Code (formstep) wants to connect to your Formstep workspace, a note that Formstep has not verified the app, the account you are signed in as, a list of permissions, the Acme Inc workspace selected, and Deny and Authorize buttons](https://formstep.io/docs/guides/ai-agents/authorize-access.png)

Pick the workspace and click **Authorize**. The browser returns to your AI tool. The connection reaches that one workspace only; to use another workspace, add Formstep to your tool a second time and pick the other one.

## 3. Check that it works

Ask the agent something only Formstep can answer:

```
List my Formstep forms and whether each one is published.
```

The agent calls Formstep and answers with the forms in the workspace you picked. Some tools, like Claude Code, first say they are loading tool definitions: Formstep lists all its tools at once, and the tool fetches the details of the ones a task needs.

> **Some actions ask first**
>
> Deleting a form, unpublishing it, canceling a request and a few other actions are marked for confirmation, and most AI tools ask you before running them. The prompt comes from your AI tool, so check its own approval settings. The full list is in the [MCP server reference](https://formstep.io/docs/developers/mcp-server/#confirmation).

## See or remove the connection

In Formstep, open **OAuth and API Keys** in the workspace sidebar. Your connection is listed under **Connected apps**, with when it was connected and last used:

![The Connected apps card listing Claude Code (formstep), connected 1 minute ago and last used now, with a Disconnect button](https://formstep.io/docs/guides/ai-agents/connected-apps.png)

Click the **Disconnect** button and confirm. The agent loses access at once, and asks you to sign in again the next time it needs Formstep.

## Next steps

[Build a form with an AI agent](https://formstep.io/docs/guides/ai-agents/build-a-form/) — Describe the form, watch the preview, and publish it

[MCP server](https://formstep.io/docs/developers/mcp-server/) — Every tool, limits, and how to connect with an API token instead