Prerequisites
MCP access set for your user. An administrator in your organisation sets it in Configuration > Organisation settings > Users. See INTEGRATIONS - Connect an AI assistant to Qargo over MCP for the prerequisites.
Your usual Qargo sign-in details. There is no separate key or token.
Your plan | Who adds the Qargo app | Sections to follow |
Business, Enterprise or Education | A workspace owner, once for the workspace | Business, Enterprise and Education: publish the app, then Connect your Qargo account |
Plus or Pro | You, for yourself | Plus and Pro: add the connector yourself |
Free | Nobody. Custom connectors need a paid plan. | None |
🧰 Use https://mcp.qargo.com/mcp - The Qargo API documentation site offers Connect to Cursor and Connect to VS Code buttons pointing at a different server. That one reads the API reference only and cannot see your data.
Business, Enterprise and Education: publish the app
A workspace owner adds the Qargo connector once. Members then authenticate individually.
Requirements
Workspace owner rights. In Business, Enterprise and Education workspaces, only owners can publish custom apps.
A plan that includes custom connectors. Business, Enterprise and Education all do.
MCP access set in Qargo for the users who need it. A Qargo administrator sets it per user in Configuration > Organisation settings > Users. Do this before publishing, so members can authenticate immediately.
📚 OpenAI labels custom connectors as unverified and intended for developer use. The Qargo server is a first-party Qargo service, but OpenAI does not review it. Expect to see that notice while publishing.
Add and publish the Qargo app
OPEN workspace settings and turn on developer mode.
CREATE a custom app or 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 so ChatGPT reads what the server offers.
TEST the app as a draft.
PUBLISH it to the workspace.
📚 OpenAI moves these settings. The developer mode toggle has appeared under several menus. If the path above does not match your workspace, search the settings for developer mode.
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.
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.
📚 Workspace settings cannot widen Qargo access. A member on Read-only cannot change data through ChatGPT, whatever the app allows. Levels are set per user in Qargo, under Configuration > Organisation settings > Users.
Tell your members to follow the next section.
Connect your Qargo account
The Qargo app should already appear in your app list. If it does not, ask your workspace owner. Members cannot add it themselves.
OPEN the Qargo app in ChatGPT.
SIGN IN with your normal Qargo credentials when the browser opens.
APPROVE the access request. The browser returns to ChatGPT.
ASK ChatGPT to list your Qargo tenants. A reply naming your tenant confirms it works.
📚You get your own permissions, not the workspace's. ChatGPT sees exactly what you can see in Qargo. A colleague with wider access sees more through the same app.
Plus and Pro: add the connector yourself
On an individual paid plan there is no admin to wait for. Custom connectors sit behind developer mode, on the web app.
OPEN ChatGPT settings and turn on developer mode.
ADD a custom connector.
ENTER Qargo as the name and https://mcp.qargo.com/mcp as the URL.
SELECT OAuth as the authentication method. Leave client ID and secret empty.
SIGN IN with your normal Qargo credentials and approve the access request.
ENABLE the connector for your conversation, then ask ChatGPT to list your Qargo tenants.
📚 OpenAI moves these settings. The developer mode toggle has appeared under several menus. If you cannot find it, search the settings for developer mode.
Free accounts cannot add custom connectors. Developer mode needs a paid plan.
Changing data
Your 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.
Troubleshooting
Issue | Resolution |
The Qargo app is not in your app list | It has not been published in your workspace. Ask your workspace owner. On Plus or Pro, add it yourself using the steps above. |
The developer mode toggle is missing | Either your plan does not include it, or it is switched off at organisation level. This is policy, not a fault. |
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 > Organisation settings > Users. Check both. |
ChatGPT says MCP access is not enabled for you | Your access is still set to Disabled. Ask an administrator to set it in Configuration > Organisation settings > Users. |
The browser shows an unknown client error while signing in | Ask your workspace owner to remove and republish the app. This can happen after a Qargo platform update. |
ChatGPT ignores Qargo and answers from general knowledge | Name Qargo in your question. |
A read works but a change is refused | You are on Read-only. An administrator can change your level in Configuration > Organisation settings > Users. |