Plugin controls
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending
.mdto the page URL.
Plugins help your team reuse instructions and work with information from connected apps. For example, a plugin can help prepare a weekly update using your team's template and project documents. Members can use it again without adding the same instructions to every conversation.
As an admin, you decide who can use each plugin and what its apps can do. This guide explains how to choose settings, test access, and help members when something doesn't work.
{"For setup, availability, and data handling, see the "}
[{"Help Center's plugin administration guide"}](https://help.openai.com/articles/11509118)
{"."}
See how plugin availability, roles, and groups work together.
Choose plugins for your team's tasks
A plugin can include skills, apps, or both:
- Skills give ChatGPT instructions, templates, and reference material for a task, such as preparing a brief or presentation.
- Apps let ChatGPT work with tools and information in services such as Google Drive or Slack. An app can only use the information and actions allowed by its settings and the connected account's permissions.
In the weekly update example, the skill supplies the reporting instructions and template. The app retrieves project documents the connected account can access.
You can read a plugin's skills in its preview to check whether they suit the task. The preview doesn't let you edit the instructions or select individual skills from the plugin. See Skill controls for more guidance.
Before choosing settings, decide who needs the plugin and whether their task involves reading information, changing it, or both. A plugin that one department uses every week may be optional for another.
Give members a short description of when to use each approved plugin and one example request.
Understand what each control does
Member permissions control what people can do with plugins. Installation settings control which plugins they can install or receive by default. App and account settings control access to connected information and actions.
| What you want to control | Where to look |
|---|---|
| Who can use, upload, share, or publish plugins. | Member permissions. |
| Who can install a plugin and who gets it by default. | Installation settings. |
| Who can use an app and which actions it allows. | App access and actions. |
| When ChatGPT asks before using an app. | The app's Permissions settings. |
| Which files and records an account can access and which actions it can take. | Permissions in the connected service, such as Google Drive or Slack. |
| Additional limits on content ChatGPT can access. | Content restrictions, where supported. |
| What an agent can do on a computer or in a cloud environment. | Environment permissions. |
{"For background on plugin security, read the "}
[{"App Security Whitepaper (PDF, June 2026)"}](https://cdn.openai.com/business-guides-and-resources/app-security-whitepaper.pdf)
{"."}
Choose what members can do with plugins
Before choosing individual plugins, review member permissions. Open your workspace's Permissions & roles settings and search for plugins. Depending on your workspace, the controls include:
| Member permission | What it allows |
|---|---|
| Use plugins | Use plugins and apps available to the workspace. |
| Upload plugins | Create plugins by uploading plugin ZIP files. |
| Upload plugins with custom MCP servers | Upload or update plugins that include custom connections to tools. Members still need permission to create or edit the plugin. |
| Share plugins | Share plugins they own with people or groups, or anyone in the workspace with a link. |
| Publish plugins to workspace | Add plugins they own to the workspace's plugin directory. |
| Create plugins with MCPs | Use developer mode to create custom app connections. |
Where role-based access control (RBAC) is supported, a role holds a set of permissions. Workspace owners can assign a role to a group so its members receive those permissions. For example, a team can use approved plugins while only the people maintaining them have permission to upload or publish them.
These permissions are separate from each plugin's installation settings. Next, choose which plugins members can install or receive by default. For more on assigning roles and groups, see Roles and workspace permissions.
Choose installation settings
Open Admin console, select your workspace, and open Plugins. The bulk edit menu offers these installation settings:
| Setting | What it changes | When to consider it |
|---|---|---|
| Available for installation | Members can install the plugin. | Plugins that members choose based on their work. |
| Installed for workspace | Installs the plugin by default and keeps any role-specific settings. | A plugin the team uses regularly. |
| Customize by role | Sets availability for a custom role where supported. | A plugin for a particular team or responsibility. |
| Disable | Changes the workspace default to disabled. | A plugin you no longer want available by default. Review role overrides too. |
Where per-plugin role settings are supported, Workspace default uses the workspace setting. For ordinary custom roles, Off means that role doesn't give access. A member may still get access through another role, so check all roles assigned to them, including those assigned through groups.
For example, make a research plugin available for members to install when they need it. If role controls are available, install the weekly update plugin for the role assigned to the people who prepare those updates. Check their app access before asking them to use it.
Manage multiple plugins together
To change several plugins at once, select them and choose Edit. Use this only when the plugins need the same installation setting. Review who the change affects and which apps each plugin needs before confirming. If a change fails or you're unsure whether it saved, check that plugin's setting before trying again.
For current limits and instructions, see the Help Center's plugin administration guide.
To manage workspace plugins from a repository, see Import and sync plugins from GitHub. For installation on other versions of ChatGPT and Codex, see Plugins.
Manage app access and actions
Installing a plugin doesn't give members access to its apps or external data. You also need to allow the required apps. If an app requires an account, that account must have permission to access the information or take the action in the connected service.
Review each included app in Plugins in Admin console. Where available, use Manage Legacy Apps to open the older app settings page.
- Use App access to choose who can use the app.
- Where supported, use Tools (or Actions) to allow actions that read or change information in the connected service.
- Use New tools (or New actions), where supported, to decide whether to allow actions added later. This doesn't turn off actions you've already enabled.
- Use Permissions to choose when ChatGPT asks before using the app.
For example, summarizing documents may need only read actions. Updating project records needs write actions. Before allowing write actions, check what they can change and how members can review or correct the result. Asking for confirmation doesn't replace restrictions on what the app or connected account can access.
If you use a workspace connection, members need permission to use that shared account. Installing a plugin for everyone doesn't create a shared account. Choose an account with the permissions the task needs, and tell members which account they're using.
Plugins in Sites use each visitor's connected accounts and have a separate Sites permission. See Plugin access in Sites for defaults and setup.
Review content access
Some apps offer Safety & Security Controls to limit which content ChatGPT can access. These settings apply in addition to the connected service's permissions.
For example, a member may be able to open a file in Google Drive while workspace content restrictions prevent ChatGPT from accessing it. After choosing restrictions, send new requests for an allowed item and a restricted item to check that ChatGPT can access the allowed item but not the restricted item.
For supported apps and setup, see the Help Center's plugin administration guide.
Check the member experience
Ask a member to try the plugin in their workspace on a version of ChatGPT or Codex that supports it. Test with their account because an owner's account may have different permissions.
| Check | What to verify |
|---|---|
| Find the plugin | The member can install it, or it is already installed, as intended. |
| Use an included app | The app is enabled, and the correct account is connected with the required permissions. |
| Try the team's task | The member can use the actions and information the task needs. |
| Test content restrictions | A new request can access an allowed item and cannot access a restricted item. |
| Test a write action | If enabled, use a disposable test record. Check the result in the connected service. |
If the plugin is installed but a task fails, check the app connection, allowed actions, content restrictions, and the connected account's permissions before reinstalling it. For more checks, see Troubleshooting plugins and apps in ChatGPT.
Troubleshoot "Disabled by admin"
If you're a workspace owner, check these settings when a plugin shows "Disabled by admin" on the web or desktop:
- Open Admin console, select the workspace, and open Plugins (Apps in FedRAMP workspaces). Review the plugin's workspace availability and any supported role settings. ChatGPT Business uses workspace-wide availability.
- If your workspace supports RBAC, open Permissions & roles. Check the workspace default and every role assigned to the member, directly or through a group. The general plugin permission must be on. Look for Allow members to use plugins or Use plugins. FedRAMP workspaces may show Use apps.
- Confirm the member can access each app required by the plugin and that the task's required actions are enabled.
- If Lockdown Mode roles are available, check whether they restrict what the member is trying to do. Review roles assigned directly and through groups. Lockdown Mode restrictions can apply even when an ordinary role gives access. They don't automatically disable every app in managed workspaces.
For self-serve ChatGPT Business accounts, ask the member to review Lockdown Mode in Settings > Security, where available. Lockdown Mode doesn't affect Codex network access.
Correct unintended settings or role assignments according to your organization's security policy. Allow up to five minutes for role changes to apply, then ask the member to try again. See Role-based access control (RBAC) for details.
Keep approved workflows useful
For each shared plugin, give members a contact who can answer questions and review changes to its skills and apps. Review access when the team, task, or connected account changes.
When you stop using a plugin, review its installation settings and app access separately. Disabling an app doesn't necessarily uninstall the plugin or remove skills that work without it. Tell members what's changing and suggest a replacement, if one exists.
Export the public catalog for review
Eligible ChatGPT Enterprise workspace owners and admins can download a CSV of the public plugins available to their workspace. Use the export to review plugin descriptions, apps, and skills before changing availability. Apps use Model Context Protocol (MCP) to connect to services, so the export describes them as MCP servers. The export doesn't show what each member can access. Use the member checks above for that.
- Open Admin console and select the intended workspace.
- Open Plugins and select Public.
- Select Export CSV in the page header.
The download uses the filename public-plugins-security-review.csv and includes:
- Plugin metadata:
Plugin Name,Plugin Description,Date Added (UTC),OpenAI Verified,Developer Name, andVersion. - MCP server metadata:
App Name(s)andApp Description(s). - Chat skill metadata:
Skill Name(s)andSkill Description(s).
Semicolons separate multiple MCP servers or skills in the same cell. The catalog data can be up to 48 hours old. It includes public plugins visible to your workspace, but not plugins created for that workspace. The export isn't available in FedRAMP workspaces.
Restrict company app accounts to authorized workspaces
Verified-domain restrictions let you require employees to connect company accounts only in authorized ChatGPT workspaces. When activated, this blocks new connections to supported apps in personal or other unauthorized workspaces. It applies to accounts that use your company's verified domain.
Verifying a domain does not activate this restriction. Existing app connections are not automatically disconnected.
For supported apps, availability, and setup guidance, see Admin controls, security, and compliance for plugins and apps.
Review permissions for the computer or cloud environment
If an agent uses plugins on a computer or in a cloud environment, review that environment's permissions too. These work alongside workspace and account permissions.
Hooks can run scripts or tools at specific points during an agent's work. If you use them, check that the environment supports them and test what happens when they fail. A hook failure doesn't necessarily stop the action. Keep access restrictions in place even when you use hooks.
See Agent Security for environment-specific controls and Hooks for supported events and configuration.
Understand data flow and security
When ChatGPT uses an app in a plugin, it sends a request to the connected service. The account's permissions and workspace controls limit the data ChatGPT can access and the actions it can take.
Before allowing access to sensitive information, review what the task needs, which account it uses, and whether the connected service meets your organization's requirements.
For current data handling, retention, and compliance guidance, see Admin controls, security, and compliance for plugins and apps. For locally configured MCP servers, see Codex MCP configuration.
Go deeper
- Install and use plugins
- Understand skills and plugins
- Import and sync plugins from GitHub
- Read the App Security Whitepaper (PDF, June 2026)
enterprise/apps-and-connectors.md +261 −164
2 2
3> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.3> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.
4 4
55Plugins package reusable workflows and can include skills and MCP servers that connectPlugins help your team reuse instructions and work with information from connected
66to other tools. ChatGPT and Codex use the same public plugin directory onapps. For example, a plugin can help prepare a weekly update using your team's
77supported surfaces, while admins decide which plugins are available in their workspace.template and project documents. Members can use it again without adding the same
88Learn more about [plugins](https://learn.chatgpt.com/docs/plugins),instructions to every conversation.
9[skills](https://learn.chatgpt.com/docs/skills-and-plugins), and
10[connected services](https://help.openai.com/en/articles/11487775).
11 9
10As an admin, you decide who can use each plugin and what its apps can do. This
11guide explains how to choose settings, test access, and help members when
12something doesn't work.
12 13
13 14
14 {"For workspace controls and data-handling guidance, see "}
15 [{"Admin controls, security, and compliance for plugins and apps"}](https://help.openai.com/articles/11509118)
16 {" in the Help Center."}
17 15
16 {"For setup, availability, and data handling, see the "}
17 [{"Help Center's plugin administration guide"}](https://help.openai.com/articles/11509118)
18 {"."}
18 19
19 20
20In this guide, **app** and **MCP server** refer to the same connected
21integration and are interchangeable terms. We use **MCP server** in the prose,
22but preserve **app** in UI labels such as **Workspace apps** and
23**App permissions**, and in CSV column names.
24 21
2522A member can use an MCP server's capabilities only when the plugin and MCP serverSee how plugin availability, roles, and groups work together.
26are available to their role and the authenticated account has access to the
27connected service. For a shared credential, the member also needs permission
28to use that credential; the external account can differ from their personal account.
29 23
3024Plugins work in Chat and Work across ChatGPT on the web, desktop, and mobile,<div
3125in Codex in the ChatGPT desktop app, and through the Codex CLI plugin browser. class="not-prose my-4 overflow-hidden rounded-md bg-gray-900"
3226They aren't available in the IDE extension. style="padding:56.25% 0 0 0;position:relative;"
27>
28 <iframe
29 src="https://player.vimeo.com/video/1238920850?badge=0&autopause=0&player_id=0&app_id=58479"
30 frameborder="0"
31 allow="autoplay; fullscreen; picture-in-picture; clipboard-write; encrypted-media; web-share"
32 referrerpolicy="strict-origin-when-cross-origin"
33 style="position:absolute;top:0;left:0;width:100%;height:100%;"
34 title="Managing plugins as a workspace administrator"
35 ></iframe>
33 36
3437To see how these controls fit with workspace roles and permissions, see
38<script src="https://player.vimeo.com/api/player.js"></script>
39
40<a id="choose-plugins-around-the-work-your-team-does"></a>
41
42## Choose plugins for your team's tasks
43
44A plugin can include skills, apps, or both:
45
46- **Skills** give ChatGPT instructions, templates, and reference material for a
47 task, such as preparing a brief or presentation.
48- **Apps** let ChatGPT work with tools and information in services such as
49 Google Drive or Slack. An app can only use the information and actions allowed
50 by its settings and the connected account's permissions.
51
52In the weekly update example, the skill supplies the reporting instructions and
53template. The app retrieves project documents the connected account can access.
54
55You can read a plugin's skills in its preview to check whether they suit the task.
56The preview doesn't let you edit the instructions or select individual skills
57from the plugin. See [Skill controls](https://learn.chatgpt.com/docs/enterprise/skills) for more guidance.
58
59<a id="choose-a-starting-set-of-apps"></a>
60<a id="choose-a-focused-initial-set"></a>
61
62Before choosing settings, decide who needs the plugin and whether their task
63involves reading information, changing it, or both. A plugin that one department
64uses every week may be optional for another.
65
66Give members a short description of when to use each approved plugin and one
67example request.
68
69<a id="understand-the-capability-chain"></a>
70
71## Understand what each control does
72
73Member permissions control what people can do with plugins. Installation
74settings control which plugins they can install or receive by default. App and
75account settings control access to connected information and actions.
76
77| What you want to control | Where to look |
78| ---------------------------------------------------------------------------- | -------------------------------------------------------------------- |
79| Who can use, upload, share, or publish plugins. | [Member permissions](#choose-what-members-can-do-with-plugins). |
80| Who can install a plugin and who gets it by default. | [Installation settings](#choose-installation-settings). |
81| Who can use an app and which actions it allows. | [App access and actions](#manage-app-access-and-actions). |
82| When ChatGPT asks before using an app. | The app's **Permissions** settings. |
83| Which files and records an account can access and which actions it can take. | Permissions in the connected service, such as Google Drive or Slack. |
84| Additional limits on content ChatGPT can access. | [Content restrictions](#review-content-access), where supported. |
85| What an agent can do on a computer or in a cloud environment. | [Environment permissions](#review-runtime-controls-and-hooks). |
86
87
88
89 {"For background on plugin security, read the "}
90 [{"App Security Whitepaper (PDF, June 2026)"}](https://cdn.openai.com/business-guides-and-resources/app-security-whitepaper.pdf)
91 {"."}
92
93
94
95## Choose what members can do with plugins
96
97Before choosing individual plugins, review member permissions. Open your
98workspace's **Permissions & roles** settings and search for **plugins**.
99Depending on your workspace, the controls include:
100
101| Member permission | What it allows |
102| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
103| Use plugins | Use plugins and apps available to the workspace. |
104| Upload plugins | Create plugins by uploading plugin ZIP files. |
105| Upload plugins with custom MCP servers | Upload or update plugins that include custom connections to tools. Members still need permission to create or edit the plugin. |
106| Share plugins | Share plugins they own with people or groups, or anyone in the workspace with a link. |
107| Publish plugins to workspace | Add plugins they own to the workspace's plugin directory. |
108| Create plugins with MCPs | Use developer mode to create custom app connections. |
109
110Where role-based access control (RBAC) is supported, a role holds a set of
111permissions. Workspace owners can assign a role to a group so its members receive
112those permissions. For example, a team can use approved plugins while only the
113people maintaining them have permission to upload or publish them.
114
115These permissions are separate from each plugin's installation settings. Next,
116choose which plugins members can install or receive by default. For more on
117assigning roles and groups, see
35[Roles and workspace permissions](https://learn.chatgpt.com/docs/enterprise/roles-and-workspace-permissions).118[Roles and workspace permissions](https://learn.chatgpt.com/docs/enterprise/roles-and-workspace-permissions).
36 119
37120To configure plugin authentication for supported workspace<a id="step-1-enable-plugin-availability"></a>
38121experiences, see [Workspace connections](https://learn.chatgpt.com/docs/enterprise/shared-connections).
39122Installing a plugin for everyone doesn't, by itself, provide a shared account.## Choose installation settings
123
124Open [Admin console](https://admin.openai.com),
125select your workspace, and open **Plugins**. The bulk edit menu offers these
126installation settings:
127
128| Setting | What it changes | When to consider it |
129| -------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
130| Available for installation | Members can install the plugin. | Plugins that members choose based on their work. |
131| Installed for workspace | Installs the plugin by default and keeps any role-specific settings. | A plugin the team uses regularly. |
132| Customize by role | Sets availability for a custom role where supported. | A plugin for a particular team or responsibility. |
133| Disable | Changes the workspace default to disabled. | A plugin you no longer want available by default. Review role overrides too. |
134
135Where per-plugin role settings are supported, **Workspace default** uses the
136workspace setting. For ordinary custom roles, **Off** means that role
137doesn't give access. A member may still get access through another role, so
138check all roles assigned to them, including those assigned through groups.
139
140For example, make a research plugin available for members to install when they
141need it. If role controls are available, install the weekly update plugin for the
142role assigned to the people who prepare those updates. Check their app access
143before asking them to use it.
144
145### Manage multiple plugins together
40 146
41147Plugins in Sites let each visitor use their own connected accounts. EachTo change several plugins at once, select them and choose **Edit**. Use this only
42148 plugin has a separate Sites permission, with defaults that depend on thewhen the plugins need the same installation setting. Review who the change
43149 workspace plan. See [Enable plugin use inaffects and which apps each plugin needs before confirming. If a change fails
44150 Sites](https://learn.chatgpt.com/docs/enterprise/sites#enable-plugin-use-in-sites) to review pluginor you're unsure whether it saved, check that plugin's setting before trying again.
45 defaults, change access, and troubleshoot tenant restrictions.
46 151
47152## Understand the capability chainFor current limits and instructions, see the [Help Center's plugin administration guide](https://help.openai.com/en/articles/11509118-admin-controls-security-and-compliance-for-plugins-and-apps).
48 153
49154A plugin can span these control layers:To manage workspace plugins from a repository, see
155[Import and sync plugins from GitHub](https://learn.chatgpt.com/docs/enterprise/plugin-management). For installation on
156other versions of ChatGPT and Codex, see [Plugins](https://learn.chatgpt.com/docs/plugins).
50 157
51158| Layer | What it determines | Where to manage it |<a id="step-2-manage-capabilities"></a>
52| ----------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
53| Availability | Whether the plugin bundle is available to the user | [Workspace settings](https://chatgpt.com/admin/settings) for supported web and desktop surfaces; the CLI plugin browser for CLI |
54| Included skills | Which reusable instructions the installed plugin contributes | The plugin package and [Skill controls](https://learn.chatgpt.com/docs/enterprise/skills) |
55| MCP server access | Whether users can use an MCP server's capabilities | [Workspace apps](https://chatgpt.com/admin/ca) and [Permissions & roles](https://chatgpt.com/admin/settings) |
56| Actions and permissions | Which actions users can run and when ChatGPT asks before using its tools | The connection's **Action control** and **App permissions** in [Workspace apps](https://chatgpt.com/admin/ca) |
57| Service authorization | Which external data and actions the authenticated identity can access | The connected service and its identity provider |
58| Runtime permissions | What an agent can do after it receives data or a tool | The runtime, sandbox, and approval controls for the active surface |
59 159
60160Use these layers as a two-step rollout: first make the right plugins available,## Manage app access and actions
61then configure the capabilities and permissions each workflow needs.
62 161
63162## Step 1: Enable plugin availabilityInstalling a plugin doesn't give members access to its apps or external data.
163You also need to allow the required apps. If an app requires an account, that
164account must have permission to access the information or take the action in the
165connected service.
64 166
65167For supported web and desktop surfaces, workspace plugin controls determineReview each included app in **Plugins** in Admin console. Where available, use
66168which roles can use or install a plugin. The Codex CLI uses its own plugin**Manage Legacy Apps** to open the older app settings page.
67browser for installation. See
68[Build plugins](https://developers.openai.com/plugins/build/plugins) for
69packaging and distribution.
70 169
71170To import workspace plugins from GitHub and keep them up to date, see- Use **App access** to choose who can use the app.
72171[Plugin management](https://learn.chatgpt.com/docs/enterprise/plugin-management).- Where supported, use **Tools** (or **Actions**) to allow actions that read or
172 change information in the connected service.
173- Use **New tools** (or **New actions**), where supported, to decide whether to
174 allow actions added later. This doesn't turn off actions you've already enabled.
175- Use **Permissions** to choose when ChatGPT asks before using the app.
176
177For example, summarizing documents may need only read actions. Updating project
178records needs write actions. Before allowing write actions, check what they can
179change and how members can review or correct the result. Asking for confirmation
180doesn't replace restrictions on what the app or connected account can access.
181
182If you use a [workspace connection](https://learn.chatgpt.com/docs/enterprise/shared-connections), members
183need permission to use that shared account. Installing a plugin for everyone
184doesn't create a shared account. Choose an account with the permissions the task
185needs, and tell members which account they're using.
186
187Plugins in Sites use each visitor's connected accounts and have a separate
188 Sites permission. See [Plugin access in
189 Sites](https://learn.chatgpt.com/docs/enterprise/sites#enable-plugin-use-in-sites) for defaults and
190 setup.
191
192### Review content access
193
194Some apps offer **Safety & Security Controls** to limit which content ChatGPT can
195access. These settings apply in addition to the connected service's permissions.
196
197For example, a member may be able to open a file in Google Drive while workspace
198content restrictions prevent ChatGPT from accessing it. After choosing
199restrictions, send new requests for an allowed item and a restricted item to
200check that ChatGPT can access the allowed item but not the restricted item.
201
202For supported apps and setup, see the [Help Center's plugin administration guide](https://help.openai.com/en/articles/11509118-admin-controls-security-and-compliance-for-plugins-and-apps).
203
204## Check the member experience
205
206Ask a member to try the plugin in their workspace on a version of ChatGPT or
207Codex that supports it. Test with their account because an owner's account may
208have different permissions.
209
210| Check | What to verify |
211| ------------------------- | --------------------------------------------------------------------------------------- |
212| Find the plugin | The member can install it, or it is already installed, as intended. |
213| Use an included app | The app is enabled, and the correct account is connected with the required permissions. |
214| Try the team's task | The member can use the actions and information the task needs. |
215| Test content restrictions | A new request can access an allowed item and cannot access a restricted item. |
216| Test a write action | If enabled, use a disposable test record. Check the result in the connected service. |
217
218If the plugin is installed but a task fails, check the app connection, allowed
219actions, content restrictions, and the connected account's permissions before
220reinstalling it. For more checks, see [Troubleshooting plugins and apps in ChatGPT](https://help.openai.com/en/articles/20001497-troubleshooting-plugins-and-apps-in-chatgpt).
73 221
74### Troubleshoot "Disabled by admin"222### Troubleshoot "Disabled by admin"
75 223
791. Open [Admin console](https://admin.openai.com), select the workspace, and open **Plugins** (**Apps** in2271. Open [Admin console](https://admin.openai.com), select the workspace, and open **Plugins** (**Apps** in
80 FedRAMP workspaces). Review the plugin's workspace availability and any228 FedRAMP workspaces). Review the plugin's workspace availability and any
81 supported role settings. ChatGPT Business uses workspace-wide availability.229 supported role settings. ChatGPT Business uses workspace-wide availability.
822302. If your workspace supports RBAC, review the workspace default and all direct2. If your workspace supports RBAC, open **Permissions & roles**. Check the
83231 and group role assignments in **Permissions & roles**. Confirm the member's workspace default and every role assigned to the member, directly or through
84232 general plugin permission is enabled: **Allow members to use plugins** or a group. The general plugin permission must be on. Look for **Allow members
85233 **Use plugins**, depending on the label shown. FedRAMP workspaces may show to use plugins** or **Use plugins**. FedRAMP workspaces may show **Use apps**.
86 **Use apps**.
873. Confirm the member can access each app required by the plugin and that the2343. Confirm the member can access each app required by the plugin and that the
88 task's required actions are enabled.235 task's required actions are enabled.
892364. Where Lockdown Mode roles are available, check all direct and group role4. If Lockdown Mode roles are available, check whether they restrict what the
90237 assignments for restrictions on the capability the member needs. Lockdown Mode member is trying to do. Review roles assigned directly and through groups.
91238 doesn't automatically disable every app in managed workspaces, but its Lockdown Mode restrictions can apply even when an ordinary role gives access.
92239 restrictions can apply even when an ordinary role grants access. They don't automatically disable every app in managed workspaces.
93 240
94For self-serve ChatGPT Business accounts, ask the member to review [Lockdown Mode](https://help.openai.com/en/articles/20001061-lockdown-mode) in241For self-serve ChatGPT Business accounts, ask the member to review [Lockdown Mode](https://help.openai.com/en/articles/20001061-lockdown-mode) in
95**Settings > Security**, where available. Lockdown Mode doesn't affect Codex242**Settings > Security**, where available. Lockdown Mode doesn't affect Codex
99security policy. Allow up to five minutes for role changes to apply, then ask the246security policy. Allow up to five minutes for role changes to apply, then ask the
100member to try again. See [Role-based access control (RBAC)](https://help.openai.com/en/articles/11750701-rbac) for details.247member to try again. See [Role-based access control (RBAC)](https://help.openai.com/en/articles/11750701-rbac) for details.
101 248
102249### Export the public catalog for review## Keep approved workflows useful
250
251For each shared plugin, give members a contact who can answer questions and review
252changes to its skills and apps. Review access when the team, task, or connected
253account changes.
254
255When you stop using a plugin, review its installation settings and app access
256separately. Disabling an app doesn't necessarily uninstall the plugin or remove
257skills that work without it. Tell members what's changing and suggest a
258replacement, if one exists.
259
260## Export the public catalog for review
103 261
104Eligible ChatGPT Enterprise workspace owners and admins can download a CSV of262Eligible ChatGPT Enterprise workspace owners and admins can download a CSV of
105the public plugins available to their workspace. Use the export to review263the public plugins available to their workspace. Use the export to review
106264plugin, MCP server, and skill metadata before changing plugin availability.plugin descriptions, apps, and skills before changing availability. Apps use Model
265Context Protocol (MCP) to connect to services, so the export describes them as MCP
266servers. The export doesn't show what each member can access. Use the member
267checks above for that.
107 268
1082691. Open [Admin > Plugins](https://chatgpt.com/admin/plugins).1. Open [Admin console](https://admin.openai.com) and select the intended workspace.
1092702. Select **Public**.2. Open **Plugins** and select **Public**.
1102713. Select the download icon (**Export CSV**) in the page header.3. Select **Export CSV** in the page header.
111 272
112The download uses the filename `public-plugins-security-review.csv` and includes:273The download uses the filename `public-plugins-security-review.csv` and includes:
113 274
116- MCP server metadata: `App Name(s)` and `App Description(s)`.277- MCP server metadata: `App Name(s)` and `App Description(s)`.
117- Chat skill metadata: `Skill Name(s)` and `Skill Description(s)`.278- Chat skill metadata: `Skill Name(s)` and `Skill Description(s)`.
118 279
119280When a plugin includes more than one MCP server or skill, semicolons separate theSemicolons separate multiple MCP servers or skills in the same cell. The catalog
120281corresponding values. The export uses a public-catalog snapshot that can be updata can be up to 48 hours old. It includes public plugins visible to your
121282to 48 hours old,workspace, but not plugins created for that workspace. The export isn't
122283includes only public plugins visible to the current workspace, and does notavailable in FedRAMP workspaces.
123include plugins created for that workspace. It isn't available in FedRAMP
124workspaces.
125
126## Step 2: Manage capabilities
127
128Conversation sync does not grant additional plugin, MCP server, or connected-service access. For Local computer access with Work Cloud, Agent Security's enterprise `apps` and `plugins` requirements apply to local executors. Work cloud containers retain existing Work Cloud policies. Configure these requirements through TOML and review them alongside workspace permissions and the connected account's permissions.
129
130Review hook support separately from plugin availability:
131
132- **Enterprise hooks.** Where enabled for your workspace, Local computer access with Work Cloud supports admin-defined MCP hooks that run on the cloud coordinator (orchestrator) for supported lifecycle and tool events. Command hooks and hooks from local configuration or plugins are not supported with cloud orchestration, even when tools execute locally.
133- **Cloud orchestration:** Command hooks and hooks from local configuration or plugins do not run, even when tools execute locally and the plugin itself is allowed. Consumers do not have hooks support in this feature. When both orchestration and execution are local, existing supported hooks continue to work in local-only Work and Codex threads. Admins can still configure supported managed hooks in Agent Security for those workflows.
134- **Auditing.** Before relying on these hooks, test the callback connection, confirm the events it receives, and check how failures affect the task. MCP hooks do not provide a complete Compliance API audit trail.
135
136See [Hooks](https://learn.chatgpt.com/docs/hooks) and the [Configuration Reference](https://learn.chatgpt.com/docs/config-file/config-reference) for supported requirements.
137
138<WarningTip>
139 Making an MCP server or plugin available in ChatGPT doesn't grant access to
140 files, records, or actions in the connected service. When troubleshooting
141 access, check the member's workspace role and approved action settings. Then
142 confirm the authenticated account or shared connection has the expected
143 permissions in the connected service.
144</WarningTip>
145
146Plugins in ChatGPT and Codex can include MCP server connections that search, retrieve, sync,
147or act on external systems. Plugin availability and the access and actions
148granted to each connection are separate controls.
149
150Manage MCP server capabilities from
151[Workspace apps](https://chatgpt.com/admin/ca) and
152[Permissions & roles](https://chatgpt.com/admin/settings). Available controls
153let admins:
154
155- Enable MCP server connections and assign access by workspace role.
156- For connections that support **Action control**, allow read-only actions or an
157 approved custom set, including how the workspace handles newly added actions.
158- Set **App permissions** that determine when ChatGPT asks before using a connection.
159- Keep access within the scopes and permissions granted by each connected
160 service and authenticated account.
161
162For current availability and procedures, see
163[Admin controls, security, and compliance in apps](https://help.openai.com/en/articles/11509118).
164 284
165## Restrict company app accounts to authorized workspaces285## Restrict company app accounts to authorized workspaces
166 286
167287When activated, verified-domain restrictions prevent users from creating new connections to supported apps with company-domain accounts in personal ChatGPT workspaces or other unauthorized workspaces. Employees must use an authorized workspace to connect those company accounts.Verified-domain restrictions let you require employees to connect company
288accounts only in authorized ChatGPT workspaces. When activated, this blocks new
289connections to supported apps in personal or other unauthorized workspaces. It
290applies to accounts that use your company's verified domain.
168 291
169Verifying a domain does not activate this restriction. Existing app connections are not automatically disconnected.292Verifying a domain does not activate this restriction. Existing app connections are not automatically disconnected.
170 293
171For supported apps, availability, and setup guidance, see [Admin controls, security, and compliance for plugins and apps](https://help.openai.com/en/articles/11509118).294For supported apps, availability, and setup guidance, see [Admin controls, security, and compliance for plugins and apps](https://help.openai.com/en/articles/11509118).
172 295
173296<a id="choose-a-starting-set-of-apps"></a><a id="review-runtime-controls-and-hooks"></a>
174 297
175298## Choose a focused initial set## Review permissions for the computer or cloud environment
176 299
177300Enable plugins that support an approved business need. Set each plugin’s audience to the users or roles that need it, and complete any required review before enabling it.If an agent uses plugins on a computer or in a cloud environment, review that
301environment's permissions too. These work alongside workspace and account
302permissions.
178 303
179304For each connected service, record the business owner, permitted data, approvedHooks can run scripts or tools at specific points during an agent's work. If you
180305read or write actions, authentication method, and a support or removal contact.use them, check that the environment supports them and test what happens when
306they fail. A hook failure doesn't necessarily stop the action. Keep access
307restrictions in place even when you use hooks.
181 308
182309Before enabling write actions or publishing a new connected capability, verifySee [Agent Security](https://learn.chatgpt.com/docs/enterprise/agent-security) for environment-specific
183310its role scope and test with an account that has only the intended permissionscontrols and [Hooks](https://learn.chatgpt.com/docs/hooks) for supported events and configuration.
184in the connected service.
185 311
186312For a broad rollout, begin with categories teams use every day, such as email,## Understand data flow and security
187calendar, and file or document systems. Use the
188[Plugins Directory](https://chatgpt.com/apps) to confirm current availability
189and capabilities across supported ChatGPT and Codex surfaces.
190 313
191314Whatever the initial set, start with read actions. Before enabling writeWhen ChatGPT uses an app in a plugin, it sends a request to the connected service.
192315actions, identify the plugin owner, review MCP server scopes and serviceThe account's permissions and workspace controls limit the data ChatGPT can
193316permissions, confirm data access, and document external effects and a recoveryaccess and the actions it can take.
194path.
195 317
196318## Understand data flow and securityBefore allowing access to sensitive information, review what the task needs,
319which account it uses, and whether the connected service meets your
320organization's requirements.
321
322For current data handling, retention, and compliance guidance, see [Admin controls, security, and compliance for plugins and apps](https://help.openai.com/en/articles/11509118).
323For locally configured MCP servers, see [Codex MCP configuration](https://learn.chatgpt.com/docs/extend/mcp).
324
325<a id="use-current-procedures-and-references"></a>
326
327## Go deeper
197 328
198329When ChatGPT uses an MCP server included with a plugin, it sends a request- [Install and use plugins](https://learn.chatgpt.com/docs/plugins)
199330to the connected service and returns data or action results allowed by the- [Understand skills and plugins](https://learn.chatgpt.com/docs/skills-and-plugins)
200331authenticated account's permissions in that service.- [Import and sync plugins from GitHub](https://learn.chatgpt.com/docs/enterprise/plugin-management)
201332 - Read the [App Security Whitepaper (PDF, June 2026)](https://cdn.openai.com/business-guides-and-resources/app-security-whitepaper.pdf)
202ChatGPT handles data from connected services in two ways:
203
204- **Non-synced:** ChatGPT processes data from Chat and deep research transiently
205 and doesn't index it.
206- **Synced:** ChatGPT indexes selected connected content in advance. You can see
207 whether a connection supports sync on its plugin page.
208
209The mode changes how ChatGPT indexes connected content; it doesn't replace
210normal chat-retention controls. ChatGPT conversations that use these connections remain
211available through the Compliance API.
212
213OpenAI's connected-service guidance documents encryption in transit and at rest, per-user
214authorization, role and action controls, restricted network access for
215conversations that use these connections, and no model training on information accessed
216through these connections for Business, Enterprise, and Edu customers. When a request reaches
217a connected service, that service's scopes, retention, data residency, and other
218policies also apply.
219
220See [security and compliance for connected services](https://help.openai.com/en/articles/11509118)
221and [connections with sync](https://help.openai.com/en/articles/10847137) for current
222data-handling details. For locally configured MCP servers in the ChatGPT desktop
223app, Codex CLI, or IDE extension, see
224[Codex MCP configuration](https://learn.chatgpt.com/docs/extend/mcp).
225
226## Use current procedures and references
227
228- [Admin controls, security, and compliance in apps](https://help.openai.com/en/articles/11509118)
229- [Apps in ChatGPT](https://help.openai.com/en/articles/11487775)
230- [Apps with sync](https://help.openai.com/en/articles/10847137)
231- [Manage workspace settings](https://help.openai.com/en/articles/8411955)
232- [Plugins](https://learn.chatgpt.com/docs/plugins)
233- [Skills and plugins](https://learn.chatgpt.com/docs/skills-and-plugins)
234- [Build plugins](https://developers.openai.com/plugins/build/plugins)
235- [Admin rollout guide](https://learn.chatgpt.com/docs/enterprise/admin-setup)