> For the complete documentation index, see [llms.txt](https://docs.rooks.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rooks.ai/get-started/connect-your-ai.md).

# Connect your AI

Connect your AI to Rooks before asking it to build a form. The connection uses MCP, which lets your AI save and publish forms in your Rooks workspace.

For an overview of supported tasks, see [What you can do with Rooks MCP](https://docs.rooks.ai/get-started/what-you-can-do-with-rooks-mcp.md).

## What you need

* A Rooks account and workspace.
* An AI client that supports the Rooks MCP connection and can run shell commands.
* Permission for the AI's environment to download and upload files using the temporary URLs returned by Rooks.

A client that supports MCP but cannot run shell commands cannot complete the current form-editing workflow.

## Install through your AI client

If your AI client supports adding plugin marketplaces through its interface, add the Rooks marketplace first, then install the Rooks plugin from it. Menu names and placement vary by client. You may see options such as **Plugins**, **Add**, or **Add marketplace**.

{% stepper %}
{% step %}

### Add the Rooks marketplace

1. Open your AI client's plugins or marketplace area.
2. Choose the option to add a marketplace.
3. Enter the Rooks marketplace repository URL:

```
https://github.com/formsort/rooks-plugin.git
```

Complete the marketplace-add flow. The marketplace makes the Rooks plugin available to install; adding it does not install the plugin.
{% endstep %}

{% step %}

### Install the Rooks plugin

Open the newly added **Rooks** marketplace, select the **Rooks** plugin, and install it.

The plugin provides the Rooks MCP connection and the instructions your AI uses to build forms.
{% endstep %}

{% step %}

### Connect your Rooks account

Start a new chat or session in your AI client and ask:

> Use Rooks, check my connection, and show my approved workspaces.

Complete the browser sign-in and approve the workspaces you want your AI to use. See [Sign in and choose workspaces](#sign-in-and-choose-workspaces) below.

Once your AI can list the intended workspace, you can ask it to create a form.
{% endstep %}
{% endstepper %}

If your client does not offer marketplace installation through its interface, use the client-specific options below.

## Client-specific installation options

Use the commands for your client below, or follow the settings-based instructions in the VS Code tab.

{% tabs %}
{% tab title="Codex" %}

```sh
codex plugin marketplace add https://github.com/formsort/rooks-plugin.git
codex plugin add rooks@rooks
```

{% endtab %}

{% tab title="Claude Code" %}

```sh
claude plugin marketplace add formsort/rooks-plugin
claude plugin install rooks@rooks
```

{% endtab %}

{% tab title="GitHub Copilot CLI" %}

```sh
copilot plugin marketplace add formsort/rooks-plugin
copilot plugin install rooks@rooks
```

{% endtab %}

{% tab title="VS Code" %}
Add the marketplace to your user settings, then install **rooks** from the **Agent Plugins** view.

```json
"chat.plugins.marketplaces": ["formsort/rooks-plugin"]
```

{% endtab %}
{% endtabs %}

## Sign in and choose workspaces

1. Start a fresh AI session.
2. Ask: “Use Rooks and check the connection.”
3. Complete the sign-in flow in your browser.
4. Review the requested access and approve the workspaces you want this AI connection to use.
5. Return to your AI and ask it to list your Rooks workspaces.

The connection uses your account's permissions. It does not give the AI additional access to forms. The current MCP tools do not provide access to submitted responses.

If your AI needs permission to transfer files, review and allow the storage hosts named by Rooks. Never paste sign-in tokens into the conversation.

Your AI client may also support a direct MCP connection to `https://app.rooks.ai/mcp`. Use that client's connection instructions; shell access and file transfers are still required.
