> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowstep.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ověřování MCP

> Jak Flowstep MCP ověřuje klienty: tok OAuth 2.1 PKCE a vytvoření účtu.

Koncový bod `/mcp` vyžaduje token typu Bearer v hlavičce `Authorization`. Klienti MCP si jej získají automaticky přes tok OAuth 2.1 PKCE. Není potřeba vytvářet, vkládat ani měnit API klíč. Token můžete pro testování zadat také ručně.

## Tok OAuth 2.1 PKCE

Flowstep provozuje vlastní autorizační server OAuth 2.1 na adrese `https://api.flowstep.ai`. Klienti MCP tok automaticky objeví a dokončí: otevřou okno prohlížeče, ve kterém se přihlásíte a schválíte přístup, a poté na pozadí vymění tokeny. Klienti se mohou registrovat dynamicky, takže nemusíte nejdřív nastavovat ID klienta.

### Podporované způsoby přihlášení

Autorizační stránka na adrese `/oauth/authorize` podporuje:

* **E-mail a heslo** — libovolný účet Flowstepu s nastaveným heslem
* **Google SSO** — přesměruje přes sociální přihlášení Supabase a automaticky vrátí do klienta

### Kontrola a schválení přístupu

Po přihlášení zobrazí Flowstep obrazovku se souhlasem dřív, než vydá token. Žádný klient se nemůže připojit bez vašeho výslovného schválení. Obrazovka má nadpis **Authorize access**. Uvádí název klienta, který žádá o přístup: tučně jeho název, za ním text „is requesting access to your Flowstep account“ (žádá o přístup k vašemu účtu Flowstep). Dále zobrazuje **You'll be redirected to** a cílovou doménu.

Kliknutím na **Allow** dokončíte připojení, kliknutím na **Deny** je zrušíte. Odmítnutí vrátí klientu chybu `access_denied` a žádný token nevydá.

<Tip>
  Název klienta nastavil ten, kdo klienta zaregistroval, takže jej berte jako štítek, nikoli jako důkaz identity. Než kliknete na **Allow**, zkontrolujte, zda je doména pod **You'll be redirected to** taková, jakou u připojovaného klienta čekáte.
</Tip>

### Vytvoření účtu pro uživatele konektoru claude.ai

Přihlašovací stránka OAuth nemá registrační formulář. Pokud přidáváte konektor Flowstep z [adresáře konektorů Claude](https://claude.ai/directory/flowstep) a ještě nemáte účet Flowstep, nejdřív si jej vytvořte na [app.flowstep.ai](https://app.flowstep.ai) a poté se vraťte do Claude a dokončete připojení.

## Záložní přihlášení pomocí cookies

Pokud hlavička `Authorization` chybí, middleware použije relaci Supabase uloženou v cookies. To funguje, když otevřete `/mcp` přímo v prohlížeči s aktivní relací Flowstepu. Klienti MCP vždy používají cestu Bearer.

## Ruční token (testování)

Chcete-li koncový bod volat přímo bez toku OAuth klienta:

1. Přihlaste se na [app.flowstep.ai](https://app.flowstep.ai) ve svém prohlížeči
2. Otevřete DevTools → Console a spusťte:

```javascript theme={"system"}
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);
```

3. Token předejte jako hlavičku:

```bash theme={"system"}
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"}'
```

<Warning>
  Relace MCP vydrží 30 dní. Server podkladový token obnovuje transparentně, takže klienti používající tok OAuth se při běžném používání znovu neověřují. Ručně získaný token, jako je ten výše, vyprší zhruba za hodinu. Slouží jen pro rychlé testování.
</Warning>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.