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

# Set up for IT admins

> Add the FlowForma connector to your ChatGPT workspace, and turn the connector off.

This page is for ChatGPT workspace admins and Microsoft 365 admins setting up FlowForma for ChatGPT. Business users can start with [Get started for business users](https://docs.flowforma.com/flowforma-for-chatgpt/business-user-guide.md).

To set up FlowForma for ChatGPT, you add the FlowForma connector to ChatGPT. People then connect with their own work account.

There's nothing new to approve in Microsoft Entra. The connector signs in through an app your organisation already approved for FlowForma, and asks for no permission that app doesn't already have.

## Before you start

You need:

* FlowForma on the FlowForma cloud service. Dedicated instances and on-premises installs aren't supported.
* SharePoint Online in Microsoft's commercial cloud. Government and sovereign clouds aren't supported.
* ChatGPT Business, Enterprise, or Edu, used on ChatGPT on the web. Custom MCP servers aren't available in the ChatGPT mobile apps.

If your organisation can't use the connector, contact [support@flowforma.com](mailto:support@flowforma.com).

The connector address is:

```
https://flowforma-mcp.flowforma.net/mcp
```

## Set up the connector

**1. Add the connector to ChatGPT**

A workspace admin or owner adds the connector, then publishes it to the workspace:

1. In ChatGPT, open **Plugins**, select **+**, then **Add custom MCP server**.
2. Enter `FlowForma` as the name, and the connector address above under **Connection**.
3. Set up OAuth as the authentication, review the risk warning, then select **Create as a plugin**.
4. To publish it, open the **Admin console**, select your workspace, then **Plugins** > **Manage Legacy Apps** > **Drafts** > **Publish**.

On Business plans, only admins and owners can add the connector, and publishing makes it available to the whole workspace. On Enterprise and Edu plans, admins can also let selected members add it, and use **Configure Access** when publishing to choose which groups get it.

Publishing the connector doesn't give anyone access to FlowForma. Each person still signs in with their own Microsoft account, and can only do what they already can in FlowForma.

ChatGPT's menus change from time to time. For the latest steps, see OpenAI's guide to [connecting custom MCP servers](https://help.openai.com/en/articles/12584461-connecting-custom-mcp-servers-in-chatgpt).

**2. Connect to test it**

Connect to FlowForma yourself, to check the connector works before you tell your users:

1. In ChatGPT on the web, open **Settings** > **Plugins**, find **FlowForma**, and click **Connect**.
2. Review the FlowForma consent page, which shows what the connector will be allowed to do.
3. Pick your Microsoft work account.
4. In a new chat, type `@`, select **FlowForma**, and ask "What FlowForma apps do I have access to?"

**3. Let your users know**

Point your users to [Get started for business users](https://docs.flowforma.com/flowforma-for-chatgpt/business-user-guide.md).

## Microsoft Entra app and permissions

The connector signs in through **FlowForma Digital Process Automation**. FlowForma Copilot, the AI built into FlowForma, signs in through the same app.

The app has these delegated permissions:

| Permission | Why it's needed |
| - | - |
| Microsoft Graph `User.Read` | Signs the user in and finds your organisation's SharePoint address |
| SharePoint `AllSites.Manage` | Reads flows, publishes flows, and creates a list or adds a column when a flow needs one |

These are delegated permissions, so the connector always works as the signed-in user. It can never do more than that person can already do in SharePoint and FlowForma. The connector also holds no client secret for the app.

For more, see [What it can access](https://docs.flowforma.com/flowforma-for-chatgpt/what-it-can-access.md) and the [Security and data FAQ](https://docs.flowforma.com/flowforma-for-chatgpt/security-and-data.md).

## Control what it can do

ChatGPT may ask for confirmation before it runs a tool that changes something, such as `push_flow`, depending on the app's permissions and what the action does. For the full list of tools, see [Tools](https://docs.flowforma.com/flowforma-for-chatgpt/tools.md).

On Enterprise and Edu plans, admins can turn individual tools on or off. Use **Configure Actions** when publishing, or **Action control** on the app in **Workspace settings** > **Apps** afterwards. To stop anyone publishing flows to FlowForma from ChatGPT, turn off `push_flow`. To also stop people switching flows on or off, turn off `switch_flow`. People can still explore, explain, desk test, and draft flows.

## Keep it up to date

When an admin publishes the connector, ChatGPT saves a snapshot of its tools. When FlowForma adds or changes tools, ChatGPT doesn't pick them up until an admin refreshes the tool list from the app's settings in the workspace.

If a tool changes in a way the snapshot can't handle, calls to it can fail until an admin refreshes it. ChatGPT doesn't notify admins when this happens.

## Conditional Access

If a Conditional Access policy asks for an extra sign-in step for SharePoint, such as a compliant device, the connector can't ask for it yet. People the policy applies to can still connect, but the connector's tools can't reach SharePoint for them, and they see a message saying their organisation needs an extra sign-in step.

There's no workaround for this yet. People the policy applies to can still use FlowForma itself as normal.

## Monitor activity

Your admins can see connector activity in your own Microsoft 365 tenant:

* **Microsoft Entra sign-in logs** show each sign-in to FlowForma Digital Process Automation. FlowForma Copilot sign-ins show there too.
* **Version history on the Flows list** shows every flow published through the connector. A publish is a normal change to the flow, made as the signed-in user.

## Turn it off

* **For one person:** they disconnect the FlowForma connector in **Settings** > **Plugins**.
* **For your whole organisation:** a workspace admin unpublishes or removes the connector in ChatGPT's **Admin console**.
* **In Microsoft Entra:** in **Enterprise applications**, open **FlowForma Digital Process Automation**, then **Properties**. Set **Enabled for users to sign-in?** to **No** to stop everyone, or set **Assignment required?** to **Yes** and assign only the people you choose. This also covers people using personal ChatGPT accounts with their work account, but it stops FlowForma Copilot as well.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.