Connect your assistant
Connect your AI assistant to MAX and ask about orders, stock or invoices. The assistant looks up the information for you.
1. Get your server address
Code
Replace my-company with the part after /o/ in your MAX address, for example https://max.chameleoon.sk/o/my-company/….
2. Choose how to connect
- Sign in with MAX (OAuth) — sign in through your browser and choose what the assistant can read or change. Editing and access to detailed change history need your separate approval.
- API key — for reading only. In MAX, open API access, create a key and allow it to read integrations (
integration.read) and the data you need.
Available tools and permissions depend on your MAX version.
The assistant can only access what your account or API key permits. Revoke a personal connection in Settings → Connected apps. Keep API keys out of shared files.
3. Add the server to your assistant
Choose your app below. For ChatGPT and the Claude App Connector, sign in with your MAX account.
ChatGPT
- Open ChatGPT Plugins on the web. Click + → Add custom MCP server.
- Name it Chameleoon MAX and paste the server address shown above.
- Choose OAuth with CIMD for client identification. Leave the client ID and secret fields empty.
- Create the plugin and install it. When prompted, sign in to MAX and approve access.
- In a conversation, type @ and select Chameleoon MAX.
Workspace settings may restrict adding custom servers. Official ChatGPT guide.
Claude App Connector
- In Claude, open Customize → Connectors → Add custom connector.
- Name it Chameleoon MAX, paste the server address shown above and continue.
- For authentication, choose Sign in now. Under OAuth client, select Use Claude’s published identity (Recommended).
- Add the connector, then sign in to MAX and approve access when prompted.
- In your conversation, open + → Connectors and enable Chameleoon MAX.
In a team workspace, an administrator may need to add the connector first. Official Claude guide.
Claude Code
Run in your terminal:
Code
In Claude Code, open /mcp, select the server and sign in to MAX.
To use an API key instead, add the server with:
Code
Replace cham_your_api_key with your complete key. Claude Code documentation.
Cursor with an API key
Add this to your user file ~/.cursor/mcp.json. Replace my-company and cham_your_api_key, then enable the server in MCP settings.
Code
VS Code with an API key
Add this to .vscode/mcp.json and replace my-company. VS Code asks for your key when you start the server.
Code
Run MCP: List Servers, select the server and approve the connection. VS Code documentation.
Try it out
Ask your assistant:
- “How many units of product ABC-123 do we have in stock?”
- “Which orders are still waiting to be shipped?”
See the tools overview for more possibilities.
If the connection fails
| Problem | What to try |
|---|---|
| Server not found (404) | Check the address and whether the service is available. |
| Sign-in failed (401) | Sign in again, or check your API key and the organisation in the address. |
| Permission missing | Check access in MAX. For a personal connection, approve the required permissions again; API keys remain read-only. |
| Too many requests (429) | Wait a little, then try your question again. |
MAX uses the header Authorization: Bearer …. If you already use Chameleoon MCP for shipments, add MAX as a separate connection with its own key.