Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Ověřování a zabezpečení

Lekce 8 z 14 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Kdo se musí ověřit
  2. Co specifikace vyžaduje
  3. Jak se ChatGPT registruje jako klient
  4. Tok viditelný pro uživatele
  5. Deklarace nástrojů vyžadujících účet
  6. Ověřování každého tokenu
  7. Identifikace ChatGPT jako klienta
  8. Bezpečnostní principy OpenAI
  9. Testování ověřování
  10. Klíčové poznatky

Lekce přepsána 3. listopadu 2026 na základě dokumentace OpenAI Authentication a Security & Privacy pro pluginy. Předchozí verze popisovala ověřování pomocí API klíče a konfiguraci auth v neexistujícím manifestu; ChatGPT neumí předložit vlastní API klíč a místo toho následuje autorizační tok definovaný ve specifikaci MCP (OAuth 2.1). Zdroje: Authentication · Security & Privacy.

Kdo se musí ověřit

Mnoho serverů MCP může fungovat anonymně v režimu pouze pro čtení. Jakýkoli server, který však zpřístupňuje data specifická pro uživatele nebo provádí operace zápisu, musí uživatele ověřit. Autorizační smlouva se řídí specifikací MCP, která je v ChatGPT i Codex totožná: tok OAuth 2.1 zahrnující tři aktéry.

  • Resource server (server prostředků): Tvůj server MCP, který zpřístupňuje nástroje a ověřuje přístupový token u každého požadavku.
  • Authorization server (autorizační server): Tvůj poskytovatel identity, který vydává tokeny a publikuje svá metadata pro zjišťování konfigurace.
  • Client (klient): Hostitel OpenAI (ChatGPT nebo Codex), jednající jménem uživatele.

OpenAI důrazně doporučuje spoléhat se na zavedeného poskytovatele identity místo budování ověřování od nuly; jejich dokumentace konkrétně odkazuje na služby Auth0 a Stytch.

Co specifikace vyžaduje

Metadata chráněného prostředku. Tvůj server MCP musí publikovat dokument, například na adrese https://your-mcp.example.com/.well-known/oauth-protected-resource, obsahující jeho kanonický identifikátor (resource), jeho autorizační servery (authorization_servers) a volitelně podporované rozsahy (scopes_supported). Když dorazí požadavek bez platného ověření, server musí odpovědět stavem 401 Unauthorized a hlavičkou odkazující na tento dokument:

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", scope="files:read"

Metadata autorizačního serveru, umístěná na /.well-known/oauth-authorization-server nebo /.well-known/openid-configuration, musí obsahovat vydavatele (issuer), koncové body pro autorizaci a tokeny a položku code_challenge_methods_supported obsahující S256. Bez toho je server MCP nepodporován, protože PKCE je povinné.

Parametr resource end-to-end. ChatGPT přidává resource=… k žádostem o autorizaci i token. Tvůj autorizační server musí tuto hodnotu zkopírovat do tokenu (často jako claim aud) a tvůj server MCP musí odmítnout jakýkoli token, který nebyl vydán specificky pro něj.

Jak se ChatGPT registruje jako klient

Koexistují tři metody. Preferovanou metodou je CIMD (Client ID Metadata Documents): ChatGPT používá URL dokumentu s metadaty hostovaného přes HTTPS jako client_id, který tvůj autorizační server načte. Povolíš to publikováním client_id_metadata_document_supported: true. ChatGPT podporuje dvě metody ověřování na koncovém bodu tokenu: none (veřejný klient chráněný pomocí PKCE) a private_key_jwt (podpisové tvrzení ověřitelné veřejným klíčem publikovaným ChatGPT). Dynamická registrace klienta (DCR) zůstává možná, pokud publikuješ registration_endpoint: ChatGPT se zaregistruje jednou na připojení a tohoto klienta znovu použije. Třetí možností je předdefinovaný klient OAuth.

Co se týče přesměrování, zkopíruj přesnou URI zobrazenou na stránce správy serveru MCP v ChatGPT do seznamu povolených adres (allowlist) tvého autorizačního serveru. Tato URI závisí na podpoře identifikace vydavatele (RFC 9207, parametr iss vrácený v každé odpovědi na autorizaci).

Tok viditelný pro uživatele

  1. ChatGPT načte metadata chráněného prostředku tvého serveru.
  2. Identifikuje se jako klient OAuth (pomocí CIMD, DCR nebo předdefinovaného klienta).
  3. Při prvním volání chráněného nástroje iniciuje tok authorization code + PKCE: uživatel se přihlásí a udělí souhlas s požadovanými rozsahy.
  4. ChatGPT vymění kód za token a připojí jej k následným požadavkům MCP (Authorization: Bearer …).
  5. Tvůj server ověří token u každého požadavku před provedením nástroje.

Deklarace nástrojů vyžadujících účet

ChatGPT zobrazí rozhraní pro propojení účtu pouze tehdy, pokud tvůj server signalizuje, že je OAuth k dispozici nebo vyžadováno. To vyžaduje obě části: metadata a chybu za běhu.

Nejprve metadata: každý nástroj deklaruje svou politiku v _meta.securitySchemes. noauth znamená, že lze volat anonymně, zatímco oauth2 vyžaduje token s uvedenými rozsahy. Deklarace obojího signalizuje, že nástroj může začít bez účtu, ale propojení odemkne více funkcí. Deklaruj to pro každý nástroj zvlášť, i když celý server dodržuje stejnou politiku.

server.registerTool(
  "create_doc",
  {
    title: "Create Document",
    description: "Creates a new document in the user's account.",
    inputSchema: { title: z.string().min(1) },
    _meta: { securitySchemes: [{ type: "oauth2", scopes: ["docs.write"] }] },
  },
  async ({ title }, extra) => {
    const token = await verifyToken(extra); // signature, iss, aud, exp, scopes
    if (!token) {
      return {
        isError: true,
        content: [{ type: "text", text: "Login required to create a document." }],
        _meta: {
          "mcp/www_authenticate": [
            'Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", error="insufficient_scope", error_description="Link your account to continue"',
          ],
        },
      };
    }
    // … create document for token.sub
  }
);

Zadruhé, chyba za běhu: když token chybí nebo je neplatný, nástroj musí vrátit výsledek chyby obsahující _meta["mcp/www_authenticate"] s parametry error a error_description. Tento obsah je tím, co skutečně spustí přihlašovací rozhraní. verifyToken je tvá ověřovací funkce; SDK MCP pro Python i TypeScript poskytují pomocné funkce pro její napsání.

Ověřování každého tokenu

Jakmile je tok dokončen, ChatGPT připojí token tak, jak je, ke každému požadavku. Zacházej s ním jako s nedůvěryhodným a proveď všechna standardní ověření serveru prostředků sám: validaci podpisu pomocí klíčů publikovaných tvým autorizačním serverem (JWKS) a claimu iss; časovou platnost (exp, nbf); cílovou skupinu (aud nebo resource) a požadované rozsahy; následované tvými vlastními obchodními pravidly. Při selhání vrať 401 a hlavičku WWW-Authenticate, což restartuje tok OAuth.

Identifikace ChatGPT jako klienta

Pro ověření, že požadavek skutečně pochází od ChatGPT, existují dvě metody. ChatGPT předkládá během TLS připojení klientský certifikát spravovaný OpenAI (mTLS). Ověř, že řetězí do střední autority publikované OpenAI, je platný pro ověřování klienta a má dnsName mtls.prod.connectors.openai.com. Nepřipínej otisk listového certifikátu, protože OpenAI jej může rotovat. Můžeš také filtrovat na základě publikovaných rozsahů IP adres. mTLS ověřuje ChatGPT; OAuth nadále ověřuje uživatele.

ChatGPT nepodporuje oprávnění stroj-stroj (client credentials, servisní účty, JWT bearer assertions), vlastní API klíče ani klientské certifikáty mTLS.

Bezpečnostní principy OpenAI

  • Nejmenší privilegia: Požaduj pouze rozsahy, úložiště a síťový přístup, které jsou nezbytné.
  • Explicitní souhlas: Uživatelé musí rozumět tomu, kdy propojují účet nebo udělují přístup k zápisu; pro destruktivní akce používej potvrzení hostitele.
  • Obrana do hloubky: Předpokládej, že se na tvůj server dostanou injekce promptů a škodlivé vstupy. Validuj všechny vstupy na straně serveru, i ty poskytnuté modelem, a udržuj auditní záznamy.

Co se týče dat: zahrň do structuredContent pouze to, co požadavek potřebuje, publikuj zásady uchovávání, respektuj žádosti o smazání a maskuj osobní údaje v logách. Co se týče rozhraní: komponenta běží v izolovaném iframe pod přísnou zásadou zabezpečení obsahu (Content Security Policy), bez přístupu k window.alert, window.prompt, window.confirm nebo navigator.clipboard. Co se týče operací: před spuštěním proveď bezpečnostní revizi, upozorni na opakovaná selhání ověřování a udržuj závislosti aktuální.

Testování ověřování

Začni s vývojovým tenantem, který vydává krátkodobé tokeny, omez přístup na důvěryhodné testery před otevřením pro veřejnost a naplánuj si odvolání, obnovu a změny rozsahů. Chybějící nebo vypršelý token považuj za chybějící ověření a poskytni užitečnou chybovou zprávu. Nastavení Auth v MCP Inspector ti umožní krok za krokem sledovat tok OAuth a zjistit, kde se láme.

Klíčové poznatky

  • Soukromá data nebo zápisy: OAuth 2.1 dle specifikace MCP s PKCE S256
  • Server publikuje metadata chráněného prostředku a odpovídá 401 + WWW-Authenticate
  • CIMD je preferovaná metoda registrace; DCR a předdefinovaní klienti zůstávají možnostmi
  • Rozhraní pro propojení: securitySchemes pro každý nástroj a chyba obsahující _meta["mcp/www_authenticate"]
  • Ověř každý token u každého požadavku; mTLS identifikuje ChatGPT, OAuth identifikuje uživatele