Copy page

Úvod

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.

Čo budete potrebovať

• 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:

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

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

Claude Code

V termináli spustite:

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

Cursor

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

Code
{
  "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.

VS Code (GitHub Copilot)

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

Code
{
  "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.

Claude Desktop

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ň:

Code
{
  "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.

ChatGPT

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ľúč.

Overenie pripojenia

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.

Riešenie problémov

• 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ť.

Bezpečnosť

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

Užitočné informácie

• MCP dokumentácia — nástroje, limity a ochrana údajov
• Úvod k API
• Model Context Protocol (oficiálna stránka)

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