Auth0 Forms MCP

这是一个 Auth0 自定义扩展，可将 Auth0 表单作为经过身份验证的 MCP App 暴露。它以 Auth0 Who Am I MCP template 为基础，保留其 Node.js、OAuth 和租户预配契约，并通过 @auth0/agent-components 注册 Form。

随附的 POC 表单位于 genai-574273613646507.ca.auth0.com，名为 MCP Hello World（ap_vJfTyBRtMJw6HD8Jp8vz4d）。它是一个独立的表单，请将会话设置留空。

配置与部署

1. 保持此代码库公开。Auth0 自定义扩展加载器从 master 分支读取 webtask.json、index.js 和生成的构建产物。

2. 将本代码库导入或完全更新为 Auth0 自定义扩展。设置如下：

   设置	POC 的值
   FORM_ID	ap_vJfTyBRtMJw6HD8Jp8vz4d
   FORM_NAME	Hello World
   FORM_DESCRIPTION	Open this form to display the Hello World MCP App POC.

   将 FORM_SESSION_FIELD、AUTH0_FORMS_TRUST_SECRET、FORMS_ORIGIN 和 PUBLIC_BASE_URL 留空。

3. 打开已安装的扩展，选择 登录并配置。受 Dashboard 管理员保护的设置路由会创建或复用 RS256 Auth0 API 资源服务器，其标识符正是显示的 MCP URL。

4. 在同一个租户中将 auth0-ext-wellknown 作为独立的自定义扩展导入。保持其名称 .well-known 不变，并设置：

   设置	值
   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. 将支持 OAuth 的客户端连接到 https://genai-574273613646507.ca.webtask.run/auth0-forms-mcp/mcp。

Related MCP server: FormIO MCP Server

实现说明

服务器会为每个请求创建全新的 MCP server 和 Streamable HTTP transport，适用于无状态的 Webtask 运行时。@auth0/agent-components 通过 open_form_* MCP 工具和 ui:// 资源暴露 Form；Form 会直接向 Auth0 提交，只有完成状态会到达 agent。

对于 flow 或 router 类型的 Form，请将 FORM_SESSION_FIELD 设置为 Form 的隐藏字段，将 AUTH0_FORMS_TRUST_SECRET 设置为为 Forms 配置的可信会话密钥。在 SDK 颁发可信 Form 会话 token 之前，服务器会先验证调用方的 Auth0 访问 token。

构建与验证

npm install
npm test

提交 index.js、build/bundle.js 以及 dist/ 中的所有文件，然后在导入到 Auth0 之前，把同一提交推送到 main 和 master 分支。