Autentificare MCP

Endpoint-ul /mcp necesită un token Bearer în antetul Authorization. Clienții MCP obțin unul automat prin fluxul OAuth 2.1 PKCE. Nu există nicio cheie API de creat, de lipit sau de rotit. Poți furniza și manual un token, pentru testare.

Fluxul OAuth 2.1 PKCE

Flowstep rulează propriul server de autorizare OAuth 2.1 la https://api.flowstep.ai. Clienții MCP descoperă și finalizează fluxul automat: deschid o fereastră de browser ca tu să te autentifici și să aprobi accesul, apoi gestionează schimbul de token în fundal. Clienții se pot înregistra dinamic, deci nu trebuie să configurezi mai întâi un ID de client.

Metode de autentificare acceptate

Pagina de autorizare de la /oauth/authorize acceptă:

Email/password: orice cont Flowstep cu o parolă setată
Google SSO: redirecționează prin autentificarea socială Supabase și revine automat la client

Revizuiește și aprobă accesul

După ce te autentifici, Flowstep afișează un ecran de consimțământ înainte să emită un token. Niciun client nu poate finaliza conectarea fără aprobarea ta explicită. Ecranul are titlul Authorize access și numește clientul care solicită accesul (numele clientului, cu caractere aldine, urmat de „is requesting access to your Flowstep account”, adică solicită acces la contul tău Flowstep). Apoi afișează You’ll be redirected to și gazda de destinație. Alege Allow pentru a finaliza conectarea sau Deny pentru a anula. Dacă refuzi, clientul primește o eroare access_denied și nu se emite niciun token.

Numele clientului este setat de cel care a înregistrat clientul, deci tratează-l ca pe o etichetă, nu ca pe o dovadă a identității. Înainte să dai clic pe Allow, verifică dacă gazda de sub You’ll be redirected to este cea pe care o aștepți pentru clientul la care te conectezi.

Crearea contului pentru utilizatorii conectorului claude.ai

Pagina de autentificare OAuth nu include un formular de înscriere. Dacă adaugi conectorul Flowstep din directorul de conectori al Claude și nu ai încă un cont Flowstep, creează-l mai întâi la app.flowstep.ai, apoi revino la Claude ca să finalizezi conectarea. Dacă nu este prezent niciun antet Authorization, middleware-ul trece la o sesiune Supabase bazată pe cookie. Asta funcționează când accesezi /mcp direct dintr-un browser cu o sesiune Flowstep activă. Clienții MCP folosesc întotdeauna calea Bearer.

Token manual (testare)

Ca să apelezi endpoint-ul direct, fără un flux OAuth al clientului:

Autentifică-te la app.flowstep.ai în browserul tău
Deschide DevTools → Console și 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 token-ul 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 de bază transparent, deci clienții care folosesc fluxul OAuth nu trebuie să se autentifice din nou în utilizarea normală. Un token extras manual, ca cel de mai sus, expiră după aproximativ o oră; este destinat doar testelor rapide.

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

Revizuiește și aprobă accesul

Crearea contului pentru utilizatorii conectorului claude.ai

Token manual (testare)

​Fluxul OAuth 2.1 PKCE

​Metode de autentificare acceptate

​Revizuiește și aprobă accesul

​Crearea contului pentru utilizatorii conectorului claude.ai

​Rezervă prin cookie

​Token manual (testare)

Fluxul OAuth 2.1 PKCE

Metode de autentificare acceptate

Revizuiește și aprobă accesul

Crearea contului pentru utilizatorii conectorului claude.ai

Rezervă prin cookie

Token manual (testare)