Лекції

Зʼясуємо, чому користувач у ChatGPT не дорівнює користувачеві вашого сервісу; навіщо ChatGPT App і MCP‑серверу потрібен повноцінний OAuth‑вхід; чим відрізняються AuthN і AuthZ; чому підхід «один API‑ключ у .env» руйнує персоналізацію та безпеку; і як сучасний стандарт OAuth 2.1 із PKCE (S256) вкладається в модель MCP: токени, scopes, перевірка aud і челенджі через _meta [ "mcp/www_authenticate" ].

У цій лекції вибудовуємо в голові «трикутник довіри» між MCP Client (ChatGPT/Apps SDK), MCP Server (ваш ресурсний сервер з інструментами) і MCP Auth Server (Keycloak/Auth0 тощо). Розглядаємо повний OAuth‑потік: від 401 і WWW-Authenticate до Bearer-токена, PKCE та захищених викликів MCP‑інструментів. Також показуємо, як claims ( sub, aud, scope) перетворюються на userId у вашій БД через identity bridge.

У цій лекції на практичному прикладі з Keycloak ми зберемо OAuth/OIDC‑автентифікацію для MCP‑сценарію. Розберемо ролі ChatGPT / MCP Jam (public client), вашого MCP‑сервера (resource server) і Keycloak (auth server). Налаштуємо окремий realm для застосунку, створимо public client з Authorization Code + PKCE ( S256). Уважно задаватимемо redirect URI і мінімальні scopes (наприклад, openid і mcp:tools). Також обговоримо токени, claims, JWKS і типові помилки інтеграції.

Розбираємося, як перетворити MCP‑сервер на OAuth 2.1 Resource Server: публікуємо метадані через /.well-known/oauth-protected-resource (RFC 9728), коректно повертаємо 401 із WWW-Authenticate : Bearer, локально перевіряємо JWT (підпис, iss, aud, exp), дістаємо sub і scope та передаємо в MCP SDK уже «готовий» контекст користувача (user‑context). Показано реалізацію на Next.js 16 і TypeScript (Route Handlers + jose).

У цій лекції ви розглянете MCP Jam як «лабораторію» для налагодження авторизації MCP‑сервера: чим відрізняються режими None, Bearer, OAuth with credentials і Default OAuth, що саме Jam надсилає в запитах (наприклад, заголовок Authorization), як читати відповіді 401/ 403, чому критично важливий WWW-Authenticate із resource_metadata, і як діагностувати збої між MCP Server, Auth Server та документом /.well-known/oauth-protected-resource.