Csatlakoztass egy ügynököt OAuth-tal, vagy hitelesíts egy szkriptet API-kulccsal.

MCP-kliens csatlakoztatása

Kövesd a beállítási útmutatót Claude, Cursor, vagy ChatGPT esetén. A callback-korlátozásokért és az API-kulcsos alternatíváért lásd: Egyéb MCP-kliensek.

Amit a hozzájárulási képernyő megjelenít: az app neve, hogy melyik fiók nevében fog eljárni, és egy jelölőnégyzet minden egyes engedélyhez. Az általunk nem ismert appokat ekként jelöljük — az önregisztrált appok által megadott nevet és logót az választja ki, aki regisztrálta az appot, így ezeket sosem tüntetjük fel hitelesítettként.

Kapcsolatok kezelése

A Beállítások → API-kulcsok oldalon a Bekötött alkalmazások lista mutatja az összes csatlakoztatott appot: milyen engedélyekkel rendelkezik, ki hagyta jóvá, és mikor tett utoljára valamit. Bármelyiket leválaszthatod. A leválasztás az app következő hívásakor lép hatályba.

API-kulcsok, szkriptekhez

Egy kulcs mindenhez megfelel, ami nem tud böngészőt megnyitni: CI, cron job, backend.

Kulcs létrehozása

  1. Lépj a Beállítások → API-kulcsok oldalra.

  2. Írj be egy nevet a Kulcs neve mezőbe, például „Claude összekötés”. A név megadása kötelező.

  3. A Jogosultságok alatt hagyd bejelölve mind a négyet a teljes hozzáféréshez, vagy vedd ki a pipát abból, amit a kulcs ne tehessen.

  4. Kattints az Új kulcs gombra.

  5. A Kulcs létrehozva panelen kattints a Másol gombra, és tárold a kulcsot biztonságos helyen. A teljes kulcsot csak most látod.

Authorization: Bearer omk_live_xxxxxxxxxxxxxxxxxxxx

Ezután a lista már csak a kulcs előtagját, az utolsó használat dátumát és a létrehozás dátumát mutatja. A kulcsokat SHA-256 hashként tároljuk, így egy elveszett kulcsot nem lehet visszaállítani — helyette hozz létre egy újat.

A kulcsok nem járnak le. A Visszavon gomb a kulcs következő hívásakor szünteti meg a hozzáférést, és a lépés végleges, így a kulcslista és benne az utolsó használat dátuma („utoljára”) jelenti a biztonsági hálót, ha egy kulcs kiszivárogna.

Engedélyek

Mindkét hitelesítő adat ugyanazt a négy jogosultsági kört hordozza: build:read, build:write, campaign:read, campaign:write. Egy kulcs csak a létrehozáskor bejelölt jogosultságokat kapja (alapból mind a négyet); a kulcslista az ilyen kulcsot Teljes hozzáférés címkével jelöli. A hatókörein (scope-jain) kívüli hívás egy 403 választ kap REST esetén. Az MCP egy olyan tool-eredményt ad vissza, amely isError: true és egy szöveges leírást a hiányzó scope nevéről, egy JSON-RPC HTTP 200 válaszon belül.

Nem vagy biztos benne, melyik fiók nevében jár el egy hitelesítő adat? Hívd meg a whoami eszközt, vagy GET /app/api/me. Ezt éri meg először kipróbálni, ha a REST 404-et ad vissza, vagy az MCP hiányzó objektumot jelez: egy rossz fiókra mutató hitelesítő adat pontosan úgy hibázik, mint egy hiányzó objektum.

Hogy néz ki egy elutasítás

Egy érvényes hitelesítő adat nélküli kérés egy 401 választ kap, egy WWW-Authenticate kihívással. A /mcp esetén ez a challenge egyben az engedélyezési szerver is rámutat, ami lehetővé teszi, hogy egy kliens önállóan elindítsa a Connect folyamatot, anélkül hogy kulcsot kérne tőled.