模型上下文协议 (MCP) 服务器
这是一个 MCP 服务器,需要用户先进行身份验证。然后,MCP 服务器才能代表用户调用受保护的 API。
配置
待办事项 API
在使用 MCP 服务器之前,您需要按照此处的说明部署 Todos API。
Auth0 配置
在 Auth0 仪表板中,在应用程序部分创建一个新的应用程序(类型:“常规 Web 应用程序”)。
应用创建完成后,配置以下URL作为本地开发时的回调URL:
设置KV命名空间
创建 KV 命名空间:
wrangler kv:namespace create "OAUTH_KV"使用 KV ID 更新 Wrangler 文件
Related MCP server: Auth0 OIDC MCP Server
环境变量
此 MCP 服务器需要配置一些环境变量:
环境 | 描述 |
| 您的 Auth0 租户的域名(例如,
) |
| 您创建的 Auth0 应用程序的客户端 ID |
| 您创建的 Auth0 应用程序的客户端密钥 |
| 您在 Auth0 仪表板中注册的 API 的唯一标识符(例如
) |
| MCP 服务器请求的范围。这里我们请求基本个人资料信息(
)、刷新令牌功能(
)以及 API 访问权限(
)。 |
| 环境设置-使用
进行本地开发 |
| 运行 Todos API 的基本 URL |
发展
在项目根目录中创建一个具有以下结构的.dev.vars文件:
测试 MCP 服务器
要启动 MCP 服务器,您可以使用以下命令:
使用 MCP Inspector,您可以连接到 MCP 服务器,列出可用的工具并调用它们。请确保将传输类型设置为sse ,并将 URL 设置为http://localhost:8788/sse 。
将 MCP 服务器部署到 Cloudflare
要将 MCP 服务器部署到 Cloudflare,您首先需要设置以下机密:
设置秘密后,您可以使用以下命令部署 API:
在 Auth0 仪表板中,还要确保为已部署的 MCP 服务器添加新的回调 URL,例如:
要测试这一点,您现在可以使用 Workers AI LLM Playground。导航至https://playground.ai.cloudflare.com/并使用以下 URL 模式连接到左下角的 MCP 服务器:
这将打开一个弹出窗口,您可以在其中登录,然后就可以使用所有工具。
故障排除
如果您在设置或使用 MCP 服务器时遇到任何问题,请按照以下故障排除步骤操作:
检查工人日志
访问仪表板中的Cloudflare Workers Logs
Auth0 仪表板日志
导航到 Auth0 仪表板中的“日志”部分
查看身份验证尝试和失败
常见问题
如果身份验证失败,请验证您的 Auth0 配置和机密
对于连接问题,请确保您的 Worker 已部署并且域正确
检查所有回调 URL 是否在 Auth0 中正确配置
验证 API_BASE_URL 是否与您部署的 API 端点匹配