MCP-hitelesítés

A /mcp végpont Bearer-tokent vár az Authorization fejlécben. Az MCP-kliensek ezt automatikusan szerzik meg az OAuth 2.1 PKCE-folyamaton keresztül. Nincs API-kulcs, amit létrehoznál, beillesztenél vagy cserélnél. Tesztelés céljából kézzel is megadhatsz tokent.

OAuth 2.1 PKCE-folyamat

A Flowstep saját OAuth 2.1 engedélyezési szervert futtat a https://api.flowstep.ai címen. Az MCP-kliensek automatikusan felfedezik és végigviszik a folyamatot: megnyitnak egy böngészőablakot, hogy bejelentkezz és jóváhagyd a hozzáférést, majd a tokencserét a háttérben intézik. A kliensek dinamikusan regisztrálhatják magukat, így nem kell előbb kliensazonosítót beállítanod.

Támogatott bejelentkezési módok

Az /oauth/authorize engedélyezési oldal a következőket támogatja:

E-mail/jelszó — bármely Flowstep-fiók, amelynek van beállított jelszava
Google SSO — a Supabase közösségi hitelesítésén keresztül irányít át, majd a kliens automatikusan visszatér

Hozzáférés áttekintése és jóváhagyása

Bejelentkezés után a Flowstep hozzájárulási képernyőt jelenít meg, mielőtt tokent állítana ki. Egyetlen kliens sem tudja befejezni a csatlakozást a kifejezett jóváhagyásod nélkül. A képernyő címe Authorize access. Megnevezi a hozzáférést kérő klienst: a kliens neve félkövéren szerepel, utána az „is requesting access to your Flowstep account” szöveg (magyarul: „hozzáférést kér a Flowstep-fiókodhoz”). Ezt követően a You’ll be redirected to felirat alatt a célgazdagép látható. Az Allow gombbal fejezheted be a csatlakozást, a Deny gombbal pedig megszakíthatod. A megtagadás access_denied hibát ad vissza a kliensnek, és nem állít ki tokent.

A kliens nevét az állítja be, aki a klienst regisztrálta, ezért inkább címkének tekintsd, nem azonosítónak. Mielőtt rákattintanál az Allow gombra, ellenőrizd, hogy a You’ll be redirected to alatt látható gazdagép az, amelyet a csatlakozni kívánt klienstől várnál.

Fiók létrehozása a claude.ai-összekötő felhasználóinak

Az OAuth bejelentkezési oldal nem tartalmaz regisztrációs űrlapot. Ha a Flowstep-összekötőt a Claude összekötőkönyvtárából adod hozzá, és még nincs Flowstep-fiókod, először hozz létre egyet itt: app.flowstep.ai. Ezután térj vissza a Claude-hoz a csatlakozás befejezéséhez.

Sütialapú tartalék

Ha nincs Authorization fejléc, a köztes szoftver a sütialapú Supabase-munkamenetre tér vissza. Ez akkor működik, ha böngészőből közvetlenül éred el a /mcp végpontot, és aktív Flowstep-munkamenet van. Az MCP-kliensek mindig a Bearer-útvonalat használják.

Kézi token (tesztelés)

Ha a kliens OAuth-folyamata nélkül szeretnéd közvetlenül hívni a végpontot:

Jelentkezz be a app.flowstep.ai oldalon a böngésződben
Nyisd meg a DevTools → Console panelt, és futtasd a következőt:

const pairs = document.cookie.split("; ").map((c) => {
  const i = c.indexOf("=");
  return [c.slice(0, i), c.slice(i + 1)];
});
const authPairs = pairs
  .filter(([k]) => /^sb-.+-auth-token(\.\d+)?$/.test(k))
  .sort(([a], [b]) => a.localeCompare(b));
const raw = authPairs.map(([, v]) => decodeURIComponent(v)).join("");
const session = JSON.parse(
  raw.startsWith("base64-") ? atob(raw.slice(7)) : raw,
);
console.log(session.access_token);

Add meg a tokent fejlécként:

curl -X POST https://api.flowstep.ai/mcp \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Az MCP-munkamenetek 30 napig élnek. A szerver átlátszóan frissíti a mögöttes tokent, ezért az OAuth-folyamatot használó klienseknek normál használat közben nem kell újra hitelesíteniük. A fentiekhez hasonló, kézzel kinyert token körülbelül egy óra után lejár. Csak gyors teszteléshez való.

Első lépések

A Flowstep használata

Csapatok és szervezetek

Exportálás és integrációk

MCP-szerver

Számlázás és csomagok

Biztonság és adatvédelem

MCP-hitelesítés

OAuth 2.1 PKCE-folyamat

Támogatott bejelentkezési módok

Hozzáférés áttekintése és jóváhagyása

Fiók létrehozása a claude.ai-összekötő felhasználóinak

Sütialapú tartalék

Kézi token (tesztelés)

​OAuth 2.1 PKCE-folyamat

​Támogatott bejelentkezési módok

​Hozzáférés áttekintése és jóváhagyása

​Fiók létrehozása a claude.ai-összekötő felhasználóinak

​Sütialapú tartalék

​Kézi token (tesztelés)

OAuth 2.1 PKCE-folyamat

Támogatott bejelentkezési módok

Hozzáférés áttekintése és jóváhagyása

Fiók létrehozása a claude.ai-összekötő felhasználóinak

Sütialapú tartalék

Kézi token (tesztelés)