Servidor de Protocolo de Contexto de Modelo (MCP)

Este es un servidor MCP que requiere que el usuario se autentique primero. El servidor MCP podrá entonces llamar a las API protegidas en nombre del usuario.

Configuración

API de Todos

Antes de poder utilizar el servidor MCP, deberá implementar la API Todos como se documenta aquí .

Configuración de Auth0

En el panel de Auth0, cree una nueva aplicación en la sección Aplicaciones (tipo: "Aplicación web normal").

Una vez creada la aplicación, configure la siguiente URL como URL de devolución de llamada cuando se desarrolle localmente:

http://localhost:8788/callback

Configurar un espacio de nombres KV

Cree el espacio de nombres KV: wrangler kv:namespace create "OAUTH_KV"
Actualice el archivo Wrangler con el ID de KV

Related MCP server: Auth0 OIDC MCP Server

Variables de entorno

Este servidor MCP necesita que se configuren algunas variables de entorno:

Configuración	Descripción
`AUTH0_DOMAIN`	El dominio de su inquilino Auth0 (por ejemplo, `acme.auth0.com` )
`AUTH0_CLIENT_ID`	El ID de cliente de la aplicación Auth0 que creó
`AUTH0_CLIENT_SECRET`	El secreto del cliente de la aplicación Auth0 que creó
`AUTH0_AUDIENCE`	El identificador único de su API que registró en el panel de Auth0 (por ejemplo, `urn:todos-api` )
`AUTH0_SCOPE`	Los ámbitos solicitados por el servidor MCP. Aquí solicitamos información básica del perfil ( `openid email profile` ), capacidad de actualización del token ( `offline_access` ) y acceso a la API ( `read:todos` ).
`NODE_ENV`	El entorno: utilizar `development` para el desarrollo local
`API_BASE_URL`	La URL base donde se ejecuta tu API Todos

Desarrollo

Cree un archivo .dev.vars en la raíz del proyecto con la siguiente estructura:

AUTH0_DOMAIN=yourdomain.us.auth0.com AUTH0_CLIENT_ID=The Client ID of the application you created in Auth0 AUTH0_CLIENT_SECRET=The Client Secret of the application you created in Auth0 AUTH0_AUDIENCE=urn:todos-api AUTH0_SCOPE=openid email profile offline_access read:todos NODE_ENV=development API_BASE_URL=http://localhost:8789

Prueba del servidor MCP

Para iniciar el servidor MCP, puede utilizar el siguiente comando:

npm run dev

Con MCP Inspector, puede conectarse al servidor MCP, listar las herramientas disponibles e invocarlas. Asegúrese de configurar el tipo de transporte como sse y la URL como http://localhost:8788/sse .

Implementación del servidor MCP en Cloudflare

Para implementar el servidor MCP en Cloudflare, primero deberá configurar los siguientes secretos:

wrangler secret put AUTH0_DOMAIN wrangler secret put AUTH0_CLIENT_ID wrangler secret put AUTH0_CLIENT_SECRET wrangler secret put AUTH0_AUDIENCE wrangler secret put AUTH0_SCOPE wrangler secret put API_BASE_URL

Una vez configurados los secretos, puedes implementar la API con el siguiente comando:

npm run deploy

En el panel de Auth0, asegúrese también de agregar una nueva URL de devolución de llamada para su servidor MCP implementado, por ejemplo:

https://mcp-auth0-oidc.<your-subdomain>.workers.dev/callback

Para probarlo, ahora puedes usar el entorno de pruebas LLM de Workers AI. Accede a https://playground.ai.cloudflare.com/ y conéctate a tu servidor MCP en la esquina inferior izquierda usando el siguiente patrón de URL:

https://mcp-auth0-oidc.<your-subdomain>.workers.dev/sse

Esto abrirá una ventana emergente donde podrás iniciar sesión y después podrás usar todas las herramientas.

Solución de problemas

Si encuentra algún problema al configurar o usar el servidor MCP, aquí le mostramos algunos pasos para solucionarlo:

Verificar los registros de los trabajadores

Visita los registros de Cloudflare Workers en tu panel de control

Registros del panel de Auth0

Vaya a la sección Registros en su Panel de Auth0
Revisar intentos y fallos de autenticación

Problemas comunes

Si falla la autenticación, verifique su configuración y secretos de Auth0
Para problemas de conexión, asegúrese de que su trabajador esté implementado y que el dominio sea correcto
Verifique que todas las URL de devolución de llamada estén configuradas correctamente en Auth0
Verifique que API_BASE_URL coincida con el punto final de API implementado