Integrations – ChatGPT: connect to Qargo over MCP – walkthrough
Connect a Qargo account to ChatGPT, then ask ChatGPT questions about live data. On Business, Enterprise and Education plans, a workspace owner publishes the Qargo app first. On Plus and Pro, users add it themselves.
Table of contents
Prerequisites
- Qargo Intelligence on the tenant. MCP is part of the Qargo Intelligence add-on. Without it, contact the Account Manager.
- MCP access set for the user. A Super admin in the organization sets it in Configuration > Organization settings > Users. No request to Qargo is needed. See Integrations – connect an AI assistant to Qargo over MCP – walkthrough for the steps.
- The usual Qargo sign-in details. There is no separate key or token.
- ChatGPT on the web. Custom MCP apps do not work in the ChatGPT mobile apps.
| Plan | Who adds the Qargo app | Available actions |
|---|---|---|
| Business, Enterprise or Education | An admin or owner, once for the workspace | Read and change data, subject to the user’s Qargo MCP access level |
| Plus or Pro | The user, for their own account | Read data only. OpenAI limits custom connectors on individual plans to reading and fetching |
| Free | Nobody. Custom connectors need a paid plan. | None |
Business, Enterprise and Education: publish the app
An admin or owner adds the Qargo app once. Members then authenticate individually.
Requirements
- Admin or owner rights. Only admins and owners can enable developer mode and publish an app. An admin cannot enable developer mode on a member’s behalf.
- MCP access set in Qargo for the users who need it. A Super admin sets it per user in Configuration > Organization settings > Users. Do this before publishing, so members can authenticate immediately.
Enable developer mode
Custom MCP apps sit behind developer mode, and each admin enables it for their own account.
- Business. Open Settings > Apps > Advanced settings and turn on developer mode. It can also be enabled while creating the app.
- Enterprise and Education. An admin first grants access in Workspace settings > Permissions & Roles > Connected data. Each authorized person then turns it on in Settings > Apps > Advanced settings.
Add and publish the Qargo app
- Navigate to Workspace settings > Apps, then click Create.
- Enter Qargo as the name and https://mcp.qargo.com/mcp as the endpoint.
- Select OAuth as the authentication method. Leave client ID and secret empty; Qargo issues neither.
- Click Scan Tools and complete the sign-in prompt when it appears, then wait for the scan to finish.
- Click Create. The app appears under Workspace settings > Apps > Drafts.
- Test the draft in a new chat before publishing.
- Publish it from Drafts, then set who can access it.
Control who can use it
Publishing makes the app available. It grants nobody access to Qargo data.
- Set user access so only intended people can use the app. On Enterprise and Education, the actions the app is allowed can also be chosen before publishing.
- Set action confirmation to decide when ChatGPT asks before calling a tool.
- Leave Qargo permissions to Qargo. Each member authenticates separately and receives only their own Qargo permissions.
Members should then follow the next section.
Connect a Qargo account
The Qargo app should already appear in the app list. If it does not, ask the workspace admin. Members cannot add it themselves.
- Open the Qargo app in ChatGPT.
- Sign in with the usual Qargo credentials when the browser opens.
- Approve the access request. The browser returns to ChatGPT.
- Select the Qargo app for the message, then ask ChatGPT to list the Qargo tenants. A reply naming the tenant confirms it works.
Plus and Pro: add the connector individually
On an individual paid plan there is no admin to wait for, but Qargo data can only be read, not changed. Custom connectors sit behind developer mode, on the web app.
- Open ChatGPT settings, then Apps > Advanced settings, and turn on developer mode.
- Click Create to add a custom connector.
- Enter Qargo as the name and https://mcp.qargo.com/mcp as the endpoint.
- Select OAuth as the authentication method. Leave client ID and secret empty.
- Scan the tools, then sign in with the usual Qargo credentials and approve the access request.
- Select the connector for the message, then ask ChatGPT to list the Qargo tenants.
Changing data
This applies to Business, Enterprise and Education workspaces. On Plus and Pro, ChatGPT can read Qargo data but not change it.
The first change to production data in a session is stopped, and ChatGPT returns an approval link. Open it, approve, and ask ChatGPT to retry. Full steps are in Integrations – connect an AI assistant to Qargo over MCP – walkthrough.
Troubleshooting
| Issue | Resolution |
|---|---|
| The Qargo app is not in the app list | It has not been published in the workspace. Ask the workspace admin. On Plus or Pro, add it individually using the steps above. |
| The developer mode toggle is missing | Either the plan does not include it, or it has not been granted at workspace level. On Enterprise and Education an admin grants access first, under Permissions & Roles > Connected data. This is policy, not a fault. |
| Custom connectors cannot be found on a phone | Custom MCP apps are web only. Use ChatGPT in a browser. |
| Scanning the tools returns nothing | Check the endpoint is exactly https://mcp.qargo.com/mcp. A trailing slash or a missing path breaks discovery. |
| The app is published but members see no Qargo tools | Members have not authenticated yet, or their MCP access is still Disabled in Configuration > Organization settings > Users. Check both. |
| Tool calls started failing after a Qargo update | ChatGPT uses the tool list it captured when the app was published. Ask the admin to refresh the app’s actions in Workspace settings > Apps. On Business plans the app has to be recreated and republished. |
| ChatGPT says MCP access is not enabled for the user | The user’s access is still set to Disabled. Ask a Super admin to set it in Configuration > Organization settings > Users. |
| The user is asked to sign in to Qargo again and again | Sessions expire, in practice around once a day, so occasional re-authentication is normal. If it happens far more often than that, contact Qargo support. |
| The browser shows an unknown client error while signing in | Ask the workspace admin to remove and republish the app. This can happen after a Qargo platform update. |
| ChatGPT ignores Qargo and answers from general knowledge | Select the Qargo app for that message, and name Qargo in the question. |
| A read works but a change is refused | Either the user is on Read-only in Qargo, which a Super admin can change in Configuration > Organization settings > Users, or the user is on ChatGPT Plus or Pro, where custom connectors are limited to reading. |
