Documentation Index
Fetch the complete documentation index at: https://docs.colacloud.us/llms.txt
Use this file to discover all available pages before exploring further.
Current Support
ChatGPT can connect to COLA Cloud through ChatGPT developer mode as a custom remote MCP app using OAuth. COLA Cloud is not currently a public ChatGPT app in the app directory. This is a private beta path for testing the full ChatGPT integration, including write actions such ascreate_scheduled_search. It requires:
- ChatGPT developer mode for your account or workspace
- A COLA Cloud account that has been enabled for the OAuth beta
- A successful WorkOS Magic Auth sign-in during connector setup
Use the DCR/client-registration OAuth path in ChatGPT. Do not choose CIMD for
COLA Cloud right now; the known-good setup uses Dynamic Client Registration
with WorkOS Magic Auth.
Prerequisites
- A COLA Cloud account at app.colacloud.us
- ChatGPT developer mode enabled for your account or workspace
- Permission from your ChatGPT workspace owner/admin if your workspace restricts custom apps
- Access to the private COLA Cloud OAuth beta for your account
Configure ChatGPT
Enable developer mode
In ChatGPT, open settings and enable developer mode from the advanced Apps settings for your account or workspace.
Choose OAuth with DCR
Choose OAuth authentication and use ChatGPT’s client registration / DCR path.
ChatGPT should discover COLA Cloud’s protected-resource metadata from:If ChatGPT offers a CIMD option, skip it for now and use DCR/client
registration instead.
Sign in with Magic Auth
Complete the WorkOS Magic Auth sign-in using the email address enabled for
the COLA Cloud beta.
Refresh tools
Refresh the app’s tools after setup so ChatGPT pulls the current tool list. New tools may be disabled by default in some workspaces.
What to Select in Chats
Be explicit when you want ChatGPT to use COLA Cloud instead of built-in web search or another connector. Useful prompts:- “Use COLA Cloud, not web search, to find bourbon approvals from Kentucky in 2025.”
- “Search COLA Cloud for recent California wine approvals and fetch two record details.”
- “Create a weekly COLA Cloud saved search for new Oregon pinot noir approvals.”
- “Check my COLA Cloud API usage before running a broad search.”
Scheduling Caveat
Do not rely on ChatGPT Tasks as the durable automation layer for COLA monitoring. When you ask ChatGPT to create an alert, it should callcreate_scheduled_search. COLA Cloud stores the saved search, shows it in the
Saved Searches dashboard, and runs the recurring email dispatcher.
Deep research can use read-only tools such as search and fetch when the COLA
Cloud app is enabled for research. Do not use deep research as the flow for
creating saved searches.
Troubleshooting
| Symptom | What to check |
|---|---|
| Developer mode is missing | Your ChatGPT plan or workspace may not have developer-mode access enabled. Ask the workspace owner/admin. |
| The app cannot be created | Confirm the URL is https://mcp.colacloud.us/mcp and the transport is remote MCP over Streamable HTTP. |
| ChatGPT asks for CIMD or client metadata | Choose DCR/client registration instead. COLA Cloud’s known-good ChatGPT path does not use CIMD right now. |
| Magic Auth says the account is not authorized | The email address is not enabled for the private OAuth beta yet, or your workspace admin has not allowed the custom app. |
OAuth succeeds but tool calls fail with oauth_connection_required | The WorkOS subject is not linked to your COLA Cloud account yet. Contact help@colacloud.us or use API-key MCP in a self-serve client. |
| ChatGPT does not see new tools | Refresh the custom app’s tools in ChatGPT settings and enable the desired actions. |
| Write action needs confirmation | This is expected. Review the action, especially for create_scheduled_search, before approving. |