模型上下文协议（MCP）服务器
这是一台MCP（可能是指某种特定类型的服务器，如管理控制平面服务器等，具体需根据上下文确定）服务器，它要求用户首先进行身份验证。验证通过后，MCP服务器将能够代表用户调用受保护的API。
配置
所有API
在您使用MCP服务器之前，需要按照文档部署Todos API 在这里。
Auth0 配置
在Auth0仪表板中，进入“应用程序”部分，创建一个新的应用程序（类型：“常规Web应用程序”）。
一旦创建了应用程序，请在本地开发时将以下URL配置为回调URL：
http://localhost:8788/callback设置一个KV命名空间
- 创建KV命名空间：
wrangler kv:namespace create "OAUTH_KV"
- 使用KV ID更新Wrangler文件
环境变量
这个MCP服务器需要配置几个环境变量：
| 设置 | 描述 |
|---|---|
AUTH0_DOMAIN | 您的 Auth0 租户的域名（例如。， acme.auth0.com） |
AUTH0_CLIENT_ID | 您创建的Auth0应用程序的客户端ID |
AUTH0_CLIENT_SECRET | 您创建的Auth0应用程序的客户端密钥 |
AUTH0_AUDIENCE 您在Auth0仪表板中注册的API的唯一标识符（例如。， urn:todos-api） | |
AUTH0_SCOPE | MCP服务器请求的范围。在这里，我们请求基本配置文件信息（openid email profile), 刷新令牌功能 (offline_access), 并且API访问（read:todos） |
NODE_ENV 环境设置 - 使用 development 用于本地开发 | |
API_BASE_URL 您的待办事项（Todos）API正在运行的基础URL |
发展
创建一个 .dev.vars 在项目根目录下创建一个文件，结构如下：
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测试MCP服务器
要启动MCP服务器，您可以使用以下命令：
npm run dev使用MCP Inspector，您可以连接到MCP服务器，列出可用的工具并调用它们。请确保将传输类型设置为 sse 以及URL为 http://localhost:8788/sse。
将MCP服务器部署到Cloudflare
要将MCP服务器部署到Cloudflare上，您首先需要设置以下密钥：
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一旦设置好密钥，您就可以使用以下命令部署API：
npm run deploy在Auth0仪表板中，也请确保为您的已部署MCP服务器添加一个新的回调URL，例如：
https://mcp-auth0-oidc..workers.dev/callback要测试这一点，您现在可以使用Workers AI LLM Playground。请导航至 https://playground.ai.cloudflare.com/ 的中文翻译可以是：“https://playground.ai.cloudflare.com/（云服务平台链接）”。不过，通常我们不会直接翻译网址，而是保留原样，因为网址是国际通用的，不需要翻译。但如果要描述这个网址的内容或用途，可以说：“这是Cloudflare提供的一个AI Playground（AI实验场）链接。” 并使用以下URL模式连接到左下角的MCP服务器：
https://mcp-auth0-oidc..workers.dev/sse这将打开一个弹出窗口，您可以在其中登录，登录后即可使用所有工具。
故障排除
如果您在设置或使用MCP服务器时遇到任何问题，以下是排查故障的一些步骤：
检查工作日志
参观 Cloudflare Workers 日志 在你的仪表盘上
Auth0 控制台日志
- 在您的 Auth0 控制台中导航至“日志”部分
- 审查身份验证尝试和失败情况
常见问题
- 如果认证失败，请检查您的 Auth0 配置和密钥
- 对于连接问题，请确保您的Worker已部署且域名正确
- 检查所有回调URL是否在Auth0中正确配置
- 验证API_BASE_URL是否与您部署的API终端点匹配