Autentificare MCP

Endpoint-ul /mcp necesită un access_token Supabase transmis ca token Bearer. Majoritatea clienților MCP obțin aceasta automat prin fluxul OAuth 2.1 PKCE. De asemenea, poți furniza un token manual pentru testare.

Fluxul OAuth 2.1 PKCE

Flowstep implementează un server complet de autorizare OAuth 2.1 la https://api.flowstep.ai. Clienții MCP îl descoperă și completează fluxul automat: deschid o fereastră de browser pentru a te conecta, apoi gestionează schimbul de token în spatele scenei.

Metode de autentificare acceptate

Pagina de autorizare la /oauth/authorize acceptă:

Email/password (email/parolă) — orice cont Flowstep cu o parolă setată
Google SSO — redirecționează prin autentificare socială Supabase, se întoarce la client automat

Revizuiți și aprobați accesul

După ce te conectezi, Flowstep afișează un ecran de consimțământ înainte să emită un token — niciun client nu poate termina conectarea fără aprobarea explicită. Ecranul are titlul Authorize access și denumește clientul care solicită acces — numele clientului în bold, urmat de “is requesting access to your Flowstep account” — apoi afișează You’ll be redirected to și gazda de destinație. Alege Allow pentru a termina conectarea, sau Deny pentru a anula. Negarea returnează clientului o eroare access_denied și nu emite niciun token.

Numele clientului este stabilit de cel care a înregistrat clientul, deci tratează-l ca o etichetă mai degrabă decât dovadă de identitate. Înainte de a apăsa Allow, verifică că gazda de sub You’ll be redirected to este cea pe care o aștepți pentru clientul pe care-l conectezi.

Crearea de conturi pentru utilizatorii conectării claude.ai

Pagina de autentificare OAuth nu include un formular de înregistrare. Dacă te conectezi prin conectorul personalizat claude.ai și nu ai încă un cont Flowstep, creează-l mai întâi la app.flowstep.ai, apoi revino la configurarea conectării pentru autentificare. Dacă nu este prezent niciun antet Authorization, middleware-ul revine la o sesiune Supabase bazată pe cookie. Aceasta funcționează atunci când accesezi /mcp direct dintr-un browser cu o sesiune Flowstep activă. Clienții MCP folosesc întotdeauna calea Bearer.

Token manual (testare)

Pentru a apela endpoint-ul direct fără un flux OAuth client:

Conectează-te la app.flowstep.ai în browserul tău
Deschide DevTools → Console, rulează:

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

Transmite tokenul ca antet:

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"}'

Sesiunile MCP durează 30 de zile — serverul reîmprospătează tokenul subiacent transparent, deci clienții care utilizează fluxul OAuth nu trebuie să se re-autentifice în timpul utilizării normale. Un token extras manual ca cel de mai sus încă expiră după aproximativ o oră; este numai pentru testare rapidă.

Primii pași

Utilizarea Flowstep

Echipe și organizații

Export și integrări

Server MCP

Facturare și planuri

Securitate și confidențialitate

Autentificare MCP

Fluxul OAuth 2.1 PKCE

Metode de autentificare acceptate

Revizuiți și aprobați accesul

Crearea de conturi pentru utilizatorii conectării claude.ai

Token manual (testare)

​Fluxul OAuth 2.1 PKCE

​Metode de autentificare acceptate

​Revizuiți și aprobați accesul

​Crearea de conturi pentru utilizatorii conectării claude.ai

​Fallback-ul cookie-ului

​Token manual (testare)

Fluxul OAuth 2.1 PKCE

Metode de autentificare acceptate

Revizuiți și aprobați accesul

Crearea de conturi pentru utilizatorii conectării claude.ai

Fallback-ul cookie-ului

Token manual (testare)