> ## Documentation Index
> Fetch the complete documentation index at: https://flow9.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect ChatGPT

> Add Flow9 to ChatGPT as a custom plugin.

Flow9 connects to ChatGPT as a **custom plugin**, on every plan including the
free one.

<Note>
  Flow9 is not yet published in ChatGPT's plugin directory, so you add it
  yourself. That is a normal, supported flow — not a workaround.
</Note>

## Before you start

* An admin must have enabled AI access for your workspace — see
  [Enabling AI connections](/admin/ai-connections)
* Your normal Flow9 login

<Warning>
  **Turn on Developer mode first.** Without it the **+** button for adding your
  own plugin does not appear, and you will only be able to install from the
  public catalogue.
</Warning>

## Turn on Developer mode

<Steps>
  <Step title="Open Plugins in Settings">
    Click your name at the bottom left, then **Settings**, then **Plugins**.

    <Frame>
      <img src="https://mintcdn.com/flow9/nKfA6qJ3O3HRrwzV/images/connect-ai/chatgpt-settings-plugins.png?fit=max&auto=format&n=nKfA6qJ3O3HRrwzV&q=85&s=3eee1564282887147f3251984cc2cc0f" alt="Plugins in the ChatGPT settings menu" width="872" height="766" data-path="images/connect-ai/chatgpt-settings-plugins.png" />
    </Frame>
  </Step>

  <Step title="Switch on Developer mode">
    Open **Developer mode** and enable it. Then go back and choose
    **Browse plugins**.

    <Frame>
      <img src="https://mintcdn.com/flow9/nKfA6qJ3O3HRrwzV/images/connect-ai/chatgpt-plugins-developer-mode.png?fit=max&auto=format&n=nKfA6qJ3O3HRrwzV&q=85&s=1735c00d39dce6de486cc4ff589780ec" alt="Browse plugins and Developer mode in ChatGPT settings" width="1017" height="818" data-path="images/connect-ai/chatgpt-plugins-developer-mode.png" />
    </Frame>
  </Step>
</Steps>

## Add Flow9

<Steps>
  <Step title="Start a new plugin">
    On the Plugins page, click the **+** button at the top right, next to the
    search box. If it is not there, Developer mode is still off.

    <Frame>
      <img src="https://mintcdn.com/flow9/nKfA6qJ3O3HRrwzV/images/connect-ai/chatgpt-plugins-page.png?fit=max&auto=format&n=nKfA6qJ3O3HRrwzV&q=85&s=79a02850f95363695d6526fd674478ab" alt="The ChatGPT Plugins page with the + button" width="1214" height="808" data-path="images/connect-ai/chatgpt-plugins-page.png" />
    </Frame>
  </Step>

  <Step title="Fill in the details">
    **Name** — `Flow9`

    **Connection** — leave it on **Server URL** and paste:

    ```
    https://mcp.flow9.online
    ```

    **Authentication** — choose **OAuth**. Leave *Advanced OAuth settings*
    alone; ChatGPT discovers those from Flow9 once the URL is in.

    Icon and description are optional.

    <Frame>
      <img src="https://mintcdn.com/flow9/nKfA6qJ3O3HRrwzV/images/connect-ai/chatgpt-new-plugin-dialog.png?fit=max&auto=format&n=nKfA6qJ3O3HRrwzV&q=85&s=7a9fdb051c457abcf231e52b6c876a6d" alt="The New Plugin dialog" width="729" height="884" data-path="images/connect-ai/chatgpt-new-plugin-dialog.png" />
    </Frame>
  </Step>

  <Step title="Acknowledge the warning">
    ChatGPT warns that it has not reviewed this server, because Flow9 is not in
    its directory yet. Tick **I understand and want to continue**.

    This warning appears for every custom server. What Flow9 can actually do is
    decided by you on the next screen and by your workspace admin — see
    [Security](/guide/connect-ai/security).
  </Step>

  <Step title="Sign in to Flow9">
    Click **Sign in with Flow9** and sign in with your normal account.

    <Frame>
      <img src="https://mintcdn.com/flow9/nKfA6qJ3O3HRrwzV/images/connect-ai/chatgpt-sign-in-with-flow9.png?fit=max&auto=format&n=nKfA6qJ3O3HRrwzV&q=85&s=1a5172a8a8e3b32acce8dd4d72b8dea5" alt="Add Flow9 to ChatGPT" width="809" height="575" data-path="images/connect-ai/chatgpt-sign-in-with-flow9.png" />
    </Frame>
  </Step>

  <Step title="Choose what to allow">
    The Flow9 consent screen lists what ChatGPT is asking for, grouped by area.
    Tick a whole group, or open one and tick individual tools.

    <Frame>
      <img src="https://mintcdn.com/flow9/nKfA6qJ3O3HRrwzV/images/connect-ai/chatgpt-consent-screen.png?fit=max&auto=format&n=nKfA6qJ3O3HRrwzV&q=85&s=f0790eb890f692f73be77dcd0243e343" alt="The Flow9 consent screen for ChatGPT" width="1205" height="780" data-path="images/connect-ai/chatgpt-consent-screen.png" />
    </Frame>
  </Step>
</Steps>

## Set the plugin's permissions

<Warning>
  **Do this straight after connecting, or writes will be refused.** ChatGPT
  defaults every plugin to *Allow low-risk actions*, which silently blocks
  anything it judges sensitive — including creating and updating records.
</Warning>

Go to **Settings → Plugins → Flow9 → Permissions** and choose the level you
want:

| Setting                                | What happens                                              |
| -------------------------------------- | --------------------------------------------------------- |
| **Always ask**                         | ChatGPT asks before reading anything or making any change |
| **Allow read actions**                 | Reads freely, asks before changing anything               |
| **Allow low-risk actions** *(default)* | May refuse writes without asking you                      |
| **Allow all actions**                  | Never asks — reads and writes go straight through         |

<Frame>
  <img src="https://mintcdn.com/flow9/nKfA6qJ3O3HRrwzV/images/connect-ai/chatgpt-plugin-permissions.png?fit=max&auto=format&n=nKfA6qJ3O3HRrwzV&q=85&s=e3ccf7a0d9b4a23c3ef7237cc1d4e946" alt="Plugin permission levels for Flow9 in ChatGPT" width="867" height="782" data-path="images/connect-ai/chatgpt-plugin-permissions.png" />
</Frame>

**Allow all actions** is the setting that makes Flow9 behave the way the
examples in these guides describe. ChatGPT marks it *elevated risk* because it
stops asking for confirmation.

Worth knowing what that does and does not change: it governs whether **ChatGPT**
pauses to ask you. It cannot widen what Flow9 permits. The tools you ticked on
the consent screen, your own Flow9 permissions, and your workspace's settings
still apply, and the assistant still cannot contact your customers or delete
anything outright.

If you would rather be asked before changes, **Allow read actions** is the
cautious choice — reporting and lookups work freely, and every write waits for
your approval.

## If ChatGPT says the action was blocked

You may see a reply like *"I couldn't do that because the connector blocked the
action."*

**First check the permission setting above.** *Allow low-risk actions* is the
usual cause, and it is the default.

<Note>
  If permissions are already set to allow the action, this is usually not Flow9.
  ChatGPT runs its own safety check *before* it sends anything to a plugin. When
  that check stops a request, the request never reaches us — nothing appears in
  our logs — but the wording can make it sound as though we refused.
</Note>

It affects reads as well as writes and is not specific to Flow9. What usually
helps:

* **Try again.** The behaviour is intermittent.
* **Switch to a thinking model** and repeat the request.
* **Re-check the plugin's permission level.**

## Removing the connection

* **In ChatGPT** — Settings → Plugins → Flow9, then remove it
* **In Flow9** — **Settings → Connected Apps**, then revoke

Revoking in Flow9 takes effect immediately, even if the plugin is still listed
in ChatGPT.
