# Connect your assistant

Connect your AI assistant to MAX and ask about orders, stock or invoices. The assistant looks up the information for you.

<h2 id="adresa-servera">1. Get your server address</h2>

```text
https://max-api.chameleoon.sk/mcp/my-company
```

Replace `my-company` with the part after `/o/` in your MAX address, for example `https://max.chameleoon.sk/o/my-company/…`.

<h2 id="autentifikacia">2. Choose how to connect</h2>

- **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.

<h2 id="pridanie-servera">3. Add the server to your assistant</h2>

Choose your app below. For ChatGPT and the Claude App Connector, sign in with your MAX account.

<details id="chatgpt">
<summary>ChatGPT</summary>

1. Open [ChatGPT Plugins](https://chatgpt.com/plugins) on the web. Click **+ → Add custom MCP server**.
2. Name it **Chameleoon MAX** and paste the server address shown above.
3. Choose **OAuth** with **CIMD** for client identification. Leave the client ID and secret fields empty.
4. Create the plugin and install it. When prompted, sign in to MAX and approve access.
5. In a conversation, type **@** and select **Chameleoon MAX**.

Workspace settings may restrict adding custom servers. [Official ChatGPT guide](https://developers.openai.com/api/docs/guides/custom-mcp-server).

</details>

<details id="claude-app">
<summary>Claude App Connector</summary>

1. In Claude, open **Customize → Connectors → Add custom connector**.
2. Name it **Chameleoon MAX**, paste the server address shown above and continue.
3. For authentication, choose **Sign in now**. Under **OAuth client**, select **Use Claude’s published identity (Recommended)**.
4. Add the connector, then sign in to MAX and approve access when prompted.
5. 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](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

</details>

<details id="claude-code">
<summary>Claude Code</summary>

Run in your terminal:

```bash
claude mcp add --transport http chameleoon-max \
  https://max-api.chameleoon.sk/mcp/my-company \
  --scope user
```

In Claude Code, open `/mcp`, select the server and sign in to MAX.

To use an API key instead, add the server with:

```bash
claude mcp add --transport http chameleoon-max \
  https://max-api.chameleoon.sk/mcp/my-company \
  --scope user \
  --header "Authorization: Bearer cham_your_api_key"
```

Replace `cham_your_api_key` with your complete key. [Claude Code documentation](https://code.claude.com/docs/en/mcp).

</details>

<details id="cursor">
<summary>Cursor with an API key</summary>

Add this to your user file `~/.cursor/mcp.json`. Replace `my-company` and `cham_your_api_key`, then enable the server in MCP settings.

```json
{
  "mcpServers": {
    "chameleoon-max": {
      "url": "https://max-api.chameleoon.sk/mcp/my-company",
      "headers": {
        "Authorization": "Bearer cham_your_api_key"
      }
    }
  }
}
```

[Cursor documentation](https://cursor.com/docs/mcp).

</details>

<details id="vs-code">
<summary>VS Code with an API key</summary>

Add this to `.vscode/mcp.json` and replace `my-company`. VS Code asks for your key when you start the server.

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "chameleoon-max-api-key",
      "description": "Chameleoon MAX API key",
      "password": true
    }
  ],
  "servers": {
    "chameleoon-max": {
      "type": "http",
      "url": "https://max-api.chameleoon.sk/mcp/my-company",
      "headers": {
        "Authorization": "Bearer ${input:chameleoon-max-api-key}"
      }
    }
  }
}
```

Run **MCP: List Servers**, select the server and approve the connection. [VS Code documentation](https://code.visualstudio.com/docs/agents/reference/mcp-configuration).

</details>

<h2 id="overenie-pripojenia">Try it out</h2>

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](/chameleoon-max-mcp-tools) for more possibilities.

<h2 id="riesenie-problemov">If the connection fails</h2>

| 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](/mcp), add MAX as a separate connection with its own key.
