# Connect an AI agent to formbase

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

## Connect an AI agent to formbase

An AI agent reaches formbase over MCP, the protocol AI tools use to call other apps. You paste one URL, sign in, and pick a workspace; the agent can then build forms, send requests and read answers in that workspace.

<h2 id="before-you-start">Before you start</h2>

<ul>
  <li>A formbase account that is a member of the workspace you want to connect.</li>
  <li>
    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.
  </li>
</ul>

<p>
  An agent's work spends no formbase AI credits; your AI tool bills you under its own pricing. See{' '}
  <a href="/ai/ai-credits-usage#mcp">AI credits & usage</a>.
</p>

<h2 id="add-the-url">1. Add the formbase server to your AI tool</h2>

<p>Every tool asks for the same thing, the server URL:</p>

```
https://api.formbase.so/api/mcp
```

<p>
  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:
</p>

Customize</strong> › <strong>Connectors</strong> › <strong>+</strong> › <strong>Add custom connector</strong>. A connector added on claude.ai also works in the desktop and mobile apps. On Team and Enterprise, an owner adds it first under <strong>Organization settings</strong> › <strong>Connectors</strong>; on Free you can add one custom connector.',
        '<a href="https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp">Anthropic</a>',
      ],
    },
    {
      label: 'Claude Code',
      cells: [
        'Run <code>claude mcp add --transport http formbase https://api.formbase.so/api/mcp</code>, then type <code>/mcp</code> in Claude Code to sign in.',
        '<a href="https://code.claude.com/docs/en/mcp">Anthropic</a>',
      ],
    },
    {
      label: 'ChatGPT',
      cells: [
        'Turn on developer mode, then <strong>Settings</strong> › <strong>Apps</strong> › <strong>Create</strong>. Creating and changing forms needs ChatGPT Business, Enterprise or Edu, on the web. On Business, a workspace admin turns on developer mode first.',
        '<a href="https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt">OpenAI</a>',
      ],
    },
    {
      label: 'Codex',
      cells: [
        'Run <code>codex mcp add formbase --url https://api.formbase.so/api/mcp</code>, then <code>codex mcp login formbase</code>.',
        '<a href="https://learn.chatgpt.com/docs/extend/mcp">OpenAI</a>',
      ],
    },
    {
      label: 'Cursor',
      cells: [
        'Click <a href="https://cursor.com/install-mcp?name=formbase&config=eyJ1cmwiOiJodHRwczovL2FwaS5mb3JtYmFzZS5zby9hcGkvbWNwIn0=">Add to Cursor</a>. Or add <code>{"mcpServers": {"formbase": {"url": "https://api.formbase.so/api/mcp"}}}</code> to <code>.cursor/mcp.json</code> in your project, or to <code>~/.cursor/mcp.json</code> for every project.',
        '<a href="https://cursor.com/docs/mcp">Cursor</a>',
      ],
    },
    {
      label: 'VS Code',
      cells: [
        'Run <strong>MCP: Add Server</strong> from the Command Palette and choose HTTP.',
        '<a href="https://code.visualstudio.com/docs/agent-customization/mcp-servers">Microsoft</a>',
      ],
    },
  ]}
/>

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

<h2 id="authorize">2. Sign in and pick the workspace</h2>

<p>
  The first time the agent uses formbase, your AI tool opens a formbase page in the browser. Sign in if you are asked to. formbase then
  shows which tool is asking, what it may do, and the workspaces you belong to:
</p>

<p>
  Pick the workspace and click <strong>Authorize</strong>. The browser returns to your AI tool. The connection reaches that one workspace
  only; to use another workspace, add formbase to your tool a second time and pick the other one.
</p>

<h2 id="check">3. Check that it works</h2>

<p>Ask the agent something only formbase can answer:</p>

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

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

> ℹ️ **Some actions ask first**
> <p>
>     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{' '}
>     <a href="/developers/mcp-server#confirmation">MCP server reference</a>.
>   </p>

<h2 id="disconnect">See or remove the connection</h2>

<p>
  In formbase, open <strong>OAuth and API Keys</strong> in the workspace sidebar. Your connection is listed under{' '}
  <strong>Connected apps</strong>, with when it was connected and last used:
</p>

<p>
  Click the <strong>Disconnect</strong> button and confirm. The agent loses access at once, and asks you to sign in again the next time it
  needs formbase.
</p>

<h2 id="next">Next</h2>

<div class="not-prose grid gap-3 sm:grid-cols-2">
  - [MCP server reference](/developers/mcp-server) — Every tool, limits, and how to connect with an API token instead.
  - [Build a form with an AI agent](/guides/ai-agents/build-a-form) — Describe the form, watch the preview, and publish it.
</div>