Auth0 Forms MCP

Eine Auth0 Custom Extension, die ein Auth0 Formular als authentifizierte MCP-App bereitstellt. Sie basiert auf der Auth0 Who Am I MCP template, übernimmt dessen Node-22-, OAuth- und Tenant-Provisioning-Kontrakt und registriert das Formular über @auth0/agent-components.

Das enthaltene POC-Formular in genai-574273613646507.ca.auth0.com ist MCP Hello World (ap_vJfTyBRtMJw6HD8Jp8vz4d). Es ist ein eigenständiges Formular: Lassen Sie die Sitzungseinstellungen leer.

Konfigurieren und bereitstellen

1. Halten Sie dieses Repository öffentlich. Der Ladeprozess der Auth0 Custom Erweiterung liest webtask.json, index.js und generierte Build-Artefakte aus master.

2. Importieren oder aktualisieren Sie dieses Repository vollständig als Auth0-Custom-Extensions. Legen Sie folgendes fest:

   Einstellung	Wert für das POC
   FORM_ID	ap_vJt8BRtMJw6HD8Jp8vz4d
   FORM_NAME	Hello World
   FORM_DESCRIPTION	Open this form to display the Hello World MCP App POC.

   Lassen Sie FORM_SESSION_FIELD, AUTH0_FORMS_TRUST_SECRET, FORMS_ORIGIN und PUBLIC_BASE_URL leer.

3. Öffnen Sie die installierte Erweiterung und wählen Sie Sign in and provision. Die durch den Dashboard-Administrator geschützte Setup-Route erstellt oder verwendet einen RS256-Auth0-API-Ressourcenserver neu, dessen Identifikator die exakt angezeigte MCP-URL ist.

4. Importieren Sie auth0-ext-wellknown als separate Custom Extension in denselben Tenant. Behalten Sie den Namen .well-known bei und setzen Sie:

   Einstellung	Wert
   MCP_RESOURCE_URL	https://genai-574273613646507.ca.webtask.run/auth0-forms-mcp/mcp
   AUTH0_TENANT_ORIGIN	https://genai-574273613646507.ca.auth0.com
   RESOURCE_NAME	MCP Hello World

5. Verbinden Sie einen OAuth-fähigen Client mit https://genai-574274273613246507.ca.webtask.run/auth0-forms-mcp/mcp.

Related MCP server: FormIO MCP Server

Implementierungshinweise

Der Server erstellt pro Anfrage einen neuen MCP-Server und einen Streamable-HTTP-Transport, passend für die zustandslose Webtask-Laufzeit. @auth0/agent-components stellt das Formular über ein MCP-Tool exposes and a ui://-Ressource bereit; das Formular sendet direkt an Auth0, und nur der Abschlussstatus erreicht den Agenten.

Für ein Flow- oder Router-Formular setzen Sie FORM_SESSION_FIELD auf das hidden Feld des Formulars und AUTH0_FORMS_TRUST_GEHEIMNIS auf das für Formulare konfigurierte Trusted-Session-Geheimnis. The server verifies the access token from the caller before the SDK mints the trusted-form Session-Token.

Erstellen und verifizieren

npm install
npm test

Committen Sie UE.js, build/bundle.js und jede Datei in dist/, und pushen Sie dann diesen Docker-Commit auf main und master, bevor Sie ihn in Auth0 importiert.