# Pripojenie AI asistenta cez MCP

Chameleoon MCP server umožňuje AI asistentovi odpovedať na otázky o vašich zásielkach: koľko ste ich minulý týždeň poslali, kde je konkrétna objednávka alebo ktorého kuriéra využívate najčastejšie.

Táto stránka popisuje postup pripojenia. Zoznam nástrojov, limity a prehľad údajov, ktoré server nikdy nevracia, nájdete v [MCP dokumentácii](/mcp).

<h2 id="co-budete-potrebovat">Čo budete potrebovať</h2>

- **API kľúč** z aplikácie Chameleoon, zo stránky nastavení API. Je to ten istý kľúč, aký sa používa pre verejné API (Public API).
- **Nainštalovaného AI asistenta**: Claude Code, Cursor, VS Code s rozšírením GitHub Copilot alebo Claude Desktop.
- **Node.js verzie 18 alebo novšej**, ak budete používať Claude Desktop. Overíte ho príkazom `node -v`.

Adresa servera je:

```
https://api.chameleoon.sk/mcp
```

Kľúč sa posiela v hlavičke `X-Chameleoon-ApiKey`.

<h2 id="claude-code">Claude Code</h2>

V termináli spustite:

```bash
claude mcp add --transport http chameleoon https://api.chameleoon.sk/mcp \
  --scope user \
  --header "X-Chameleoon-ApiKey: vas-api-kluc"
```

Parameter `--scope user` sprístupní server vo všetkých vašich projektoch. Pripojenie overíte príkazom `claude mcp list`.

<h2 id="cursor">Cursor</h2>

Vytvorte alebo upravte `~/.cursor/mcp.json` (globálne) alebo `.cursor/mcp.json` (pre jeden projekt):

```json
{
  "mcpServers": {
    "chameleoon": {
      "url": "https://api.chameleoon.sk/mcp",
      "headers": {
        "X-Chameleoon-ApiKey": "vas-api-kluc"
      }
    }
  }
}
```

Cursor následne reštartujte. Ak súbor vytvárate v projekte, nezabudnite, že sa dostane aj do verzovacieho systému — kľúč v takom prípade radšej vložte do globálneho súboru.

<h2 id="vs-code-github-copilot">VS Code (GitHub Copilot)</h2>

Vo svojom projekte vytvorte `.vscode/mcp.json`. Kľúč nevpisujte priamo do súboru, ale nechajte si oň pýtať cez `inputs`:

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "chameleoon-api-key",
      "description": "Chameleoon API kľúč",
      "password": true
    }
  ],
  "servers": {
    "chameleoon": {
      "type": "http",
      "url": "https://api.chameleoon.sk/mcp",
      "headers": {
        "X-Chameleoon-ApiKey": "${input:chameleoon-api-key}"
      }
    }
  }
}
```

VS Code je zvyknutý mať tento súbor vo verzovacom systéme, preto sa kľúč do neho nikdy nepíše priamo. Po reštarte prepnite Copilot Chat do režimu **Agent**.

<h2 id="claude-desktop">Claude Desktop</h2>

Claude Desktop nemá pole na vlastnú hlavičku, preto sa pripája cez pomocníka `mcp-remote`, ktorý vyžaduje Node.js.

Otvorte **Settings → Developer → Edit Config**. Súbor nájdete tu:

- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Linux:** `~/.config/Claude/claude_desktop_config.json`

Vložte doň:

```json
{
  "mcpServers": {
    "chameleoon": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.chameleoon.sk/mcp",
        "--header",
        "X-Chameleoon-ApiKey:${CHAMELEOON_API_KEY}"
      ],
      "env": {
        "CHAMELEOON_API_KEY": "vas-api-kluc"
      }
    }
  }
}
```

Kľúč je uvedený v `env` zámerne. Keby bol priamo v `args`, zobrazoval by sa v zozname bežiacich procesov. Za dvojbodkou v hlavičke nesmie byť medzera.

Súbor uložte a Claude Desktop reštartujte. V ponuke nástrojov by sa mal objaviť `chameleoon`.

<h2 id="chatgpt">ChatGPT</h2>

Konektory ChatGPT **nie sú podporované**. Podporujú prihlásenie cez OAuth alebo pripojenie bez autentifikácie, ale neumožňujú posielať vlastné hlavičky, ktorými sa k tomuto serveru posiela API kľúč.

<h2 id="overenie-pripojenia">Overenie pripojenia</h2>

Spýtajte sa asistenta:

> Koľko zásielok sme poslali za posledných 7 dní?

Ak odpovie číslami z vášho účtu, pripojenie funguje. Ďalšie otázky, na ktoré vie odpovedať, nájdete v [MCP dokumentácii](/mcp).

<h2 id="riesenie-problemov">Riešenie problémov</h2>

- **Chyba autentifikácie (401).** Skontrolujte, či je kľúč v hlavičke správne zapísaný a či je v aplikácii Chameleoon aktívny.
- **Chyba oprávnenia (403).** Účet nemá aktívne predplatné potrebné na prístup k API.
- **Príliš veľa požiadaviek (429).** Prekročili ste limit volaní. Chvíľu počkajte, v odpovedi je uvedené ako dlho.
- **Asistent nevidí žiadne nástroje.** Skontrolujte, či ste aplikáciu po úprave konfigurácie reštartovali a či je súbor na správnom mieste.
- **Claude Desktop hlási, že príkaz `npx` sa nenašiel.** Nemáte nainštalovaný Node.js, prípadne nie je v systémovej ceste `PATH`.
- **Asistent odpovedá bez údajov o príjemcovi.** Nejde o chybu, server osobné údaje zámerne nevracia. Viac v časti [Bezpečnosť](#bezpecnost).

<h2 id="bezpecnost">Bezpečnosť</h2>

API kľúč má rovnaké oprávnenia ako pri verejnom API, asistent teda vidí len váš vlastný účet. Súhrny a štatistiky vyžadujú oprávnenie na čítanie štatistík, vyhľadanie konkrétnej zásielky oprávnenie na čítanie zásielok. Všetky nástroje sú určené len na čítanie, žiadny z nich nevie zásielku vytvoriť, zmeniť ani zmazať.

Kľúč nezdieľajte a nevkladajte ho do verejných repozitárov. V konfiguračných súboroch, ktoré sa verzujú, použite premennú prostredia alebo `inputs`, ako je uvedené v návode pre VS Code.

Odpovede MCP servera sa kopírujú do kontextu poskytovateľa AI modelu a môžu zostať v histórii konverzácie. Preto server zámerne nevracia žiadne osobné údaje: ani mená, adresy či kontakty príjemcov, ani poznámky operátorov, ani surový text kuriérskeho sledovania. Zásielky sa identifikujú vaším referenčným číslom a číslom zásielky, ktoré pridelil kuriér. Ak potrebujete údaje o príjemcovi, použite [verejné API (Public API)](/api-v2).

<h2 id="uzitocne-informacie">Užitočné informácie</h2>

- [MCP dokumentácia — nástroje, limity a ochrana údajov](/mcp)
- [Úvod k API](/uvod-k-api)
- <a href="https://modelcontextprotocol.io/" target="_blank">Model Context Protocol (oficiálna stránka)</a>

Nenašli ste potrebné informácie? Radi Vám pomôžeme, kontaktujte nás na e-mail: **podpora@chameleoon.sk**