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: Remote MCP Server with GitHub OAuth

Variables de entorno

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

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