Auth0 Forms MCP

Una extensión personalizada de Auth0 que expone un formulario de Auth0 como una aplicación MCP autenticada. Se inicia a partir de Auth0 Who Am I MCP template, conserva su contrato de Node 22, OAuth y aprovisionamiento de inquilinos, y registra el formulario mediante @auth0/agent-components.

El formulario POC incluido en genai-574273613646507.ca.auth0.com es MCP Hello World (ap_vJfTyBRtMJw6HD8Jp8vz4d). Es un formulario independiente: deja vacíos los ajustes de sesión.

Configurar y desplegar

1. Mantén este repositorio público. El cargador de extensiones personalizadas de Auth0 lee webtask.json, index.js y los artefactos de compilación generados desde master.

2. Importa o actualiza por completo este repositorio como una extensión personalizada de Auth0. Establece:

   Configuración	Valor para el POC
   FORM_ID	ap_vJfTyBRtMJw6HD8Jp8vz4d
   FORM_NAME	Hello World
   FORM_DESCRIPTION	Open this form to display the Hello World MCP App POC.

   Deja FORM_SESSION_FIELD, AUTH0_FORMS_TRUST_SECRET, FORMS_ORIGIN y PUBLIC_BASE_URL en blanco.

3. Abre la extensión instalada y selecciona Iniciar sesión y aprovisionar. La ruta de configuración protegida por el administrador de Dashboard crea o reutiliza el servidor de recursos de la API de Auth0 RS256 cuyo identificador es exactamente la URL MCP que se muestra.

4. Importa auth0-ext-wellknown como una extensión personalizada separada en el mismo inquilino. Mantén su nombre .well-known y establece:

   Configuración	Valor
   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. Conecta un cliente compatible con OAuth a https://genai-574273613646507.actualtas.works.or.run/auth0-forms-mcp/mcp.

Related MCP server: FormIO MCP Server

Notas sobre la implementación

El servidor crea un nuevo servidor MCP y un transporte Streamable HTTP para cada solicitud, que son adecuados para el runtime de Webtask sin estado. @auth0/agent-components presenta el formulario a través de una herramienta MCP open_form_* y un recurso ui://; el formulario envía directamente a Auth0 y solo el estado de finalización llega al agente.

Para un formulario de flujo o de enrutador, ajusta FORM_SESSION_FIELD al campo oculto del formulario y AUTH0_FORMS_TRUST_SECRET al secreto de sesión de confianza configurado para Auth Form. El servidor comprueba el token de acceso de Auth0 del solicitante antes de que el SDK emita el token obligatorio de sesión de formulario.

Compilación y check

npm install
npm test

Haz commit de index.js, build/bundle.js y todos los archivos de dist/, y luego envía el mismo commit a main y master antes de importarlo en une Aplicación.