ChatGPT
ChatGPT installs plugins: one package holding the Atlas skills and the Atlas connector, the same as our Claude plugin. There are three routes:
| Route | You get | Who does it |
|---|---|---|
| 1. ChatGPT on the web | Connector, then skills, in two parts | You, if you may add custom MCP servers |
| 2. ChatGPT desktop app | Skills and connector in one install (sign-in being fixed) | You, no admin needed |
| 3. An admin imports the plugin | Skills and connector, for everyone, updated daily | A workspace admin, once |
New to this? Start with a step-by-step walkthrough with screenshots: ChatGPT on the web, ChatGPT desktop app, or admin console import.
The skills teach ChatGPT to model the way an experienced Atlas user would: see Atlas skills and plugin.
Steps follow OpenAI's help center as of 28 October 2026. OpenAI renames menus often: if a label differs, look for the closest match.
Before you start
- Plan: custom MCP servers need ChatGPT Business, Enterprise or Edu, on the web. They do not work on mobile. Pro can connect servers with read-only tools.
- Who can add one: on Business, only a workspace admin or owner. On Enterprise or Edu, an admin, or a member whose role has the Create plugins with MCPs permission (off by default).
- If you are not allowed, see If it is blocked.
Route 1: ChatGPT on the web
Two parts, because on the web the connector and the skills are set up separately.
- Connector. Settings, Plugins, Browse directory, Add, Add custom MCP server. Name it "Graphite Atlas", set Server URL to
https://graphiteatlas.com/api/mcp, leave authentication on OAuth, tick the risk box, and select Create as a plugin. Install it, then select Approve on the Atlas sign-in page. Only an admin or owner can publish the connector to the rest of the workspace; until then it is private to whoever created it. - Skills. The skills are not in Plugins: open Customize, Skills, Add, Upload from your computer, and upload atlas-skills.zip. ChatGPT unpacks all five skills at once. This needs the Enable skill uploading permission.
Full steps with screenshots: ChatGPT on the web: step by step.
Route 2: ChatGPT desktop app
In the ChatGPT desktop app, go to Settings, Plugins, Add, Add a marketplace, and enter graphiteatlas/atlas-skills. Then install Graphite Atlas and select Authenticate next to its connector under Settings, Plugins, MCPs. One install brings the connector and all five skills. Full steps with screenshots: ChatGPT desktop app: step by step.
On 28 October the Authenticate step fails in the desktop app with "redirect_uri does not match a registered value". Until that is fixed, use Route 1.
Route 3: An admin imports the plugin (everyone)
An admin does this once. Full steps with screenshots: ChatGPT admin console: import the plugin for everyone.
- Go to the ChatGPT Admin console, pick your workspace, and open Plugins.
- Select Add, then Import marketplace.
- Enter the repository
https://github.com/graphiteatlas/atlas-skills. Leave the path and branch empty. Authorize GitHub. - Select Import marketplace, then open Import results.
- For each role, set the plugin to Available (members choose to install it) or Installed (installed for them).
Members then open Plugins, find Graphite Atlas under their workspace tab, install it, and sign in to Atlas when asked. Start a new chat and type @ to pick it. Ask: "List my atlases."
Because the plugin includes the connector, OpenAI marks it Desktop only: members use it in the ChatGPT desktop app, not on the web or mobile, so the sign-in fix above applies.
If it is blocked
You may see no Add custom MCP server button, a plugin marked Disabled by admin, or a plugin that will not install. Your workspace admin controls all of these. Send them this:
Please let me use Graphite Atlas in ChatGPT. In the ChatGPT admin settings, under Workspace settings, Permissions & roles, open my role and turn on:
- Use plugins
- Create plugins with MCPs (to add the Atlas server), or add and publish the server yourself under Plugins
- Enable skills and Enable skill uploading (for the Atlas skills)
Or import our plugin once for everyone: Admin console, Plugins, Add, Import marketplace,
https://github.com/graphiteatlas/atlas-skills.
On Business, a member cannot grant themselves any of this. Only an admin or owner can create and publish a custom MCP server.
For admins
- Publish. After you test the connection, publish it: Admin console, Plugins, Manage Legacy Apps, Drafts, Publish. Review the write-action warnings. On Enterprise and Edu you can choose which actions are allowed and which roles get access.
- Roles. Enterprise and Edu: Workspace settings, Permissions & roles. The relevant switches are Use plugins, Upload plugins, Create plugins with MCPs, Share plugins and Publish plugins to workspace.
- Installation policy. For each imported plugin choose Available (members install it) or Installed (installed for them).
- Atlas sign-in. Importing or installing does not connect anyone's Atlas account. Each member signs in to Atlas the first time they use it.
- Updates. ChatGPT keeps a frozen copy of the server's tools. When Atlas adds or changes a tool, an admin must refresh the tool list in the workspace app settings. Until then a changed tool can error. The marketplace re-checks GitHub daily: Admin, Plugins, Marketplaces, Sync now updates it at once. Do not delete the marketplace to fix a problem: that removes its plugins for everyone.
Troubleshooting
| What you see | What to do |
|---|---|
| No Add custom MCP server | Your plan or role does not allow it. Ask your admin. |
| Plugin is Desktop only | Open the ChatGPT desktop app. It cannot be installed on the web or mobile. |
| Plugin says an app needs setup | An admin has to publish the connection and enable it for your role. |
| Tools stop working after a while | Disconnect and reconnect Atlas under Settings, Plugins, and sign in again. |
| A tool errors after Atlas changed | An admin refreshes the tool list. |
| Cannot find the plugin | Check the Your workspace tab, then ask an admin to check the installation policy. |
Codex
Codex, OpenAI's coding agent, uses the same plugins. In the Codex CLI, open the plugin browser with /plugins, install graphite-atlas, and start a new session.