Cline MCP Auth0

Auth0 MCP服务器

用于Auth0管理和配置分析的模型上下文协议服务器。

这个基于TypeScript的MCP服务器提供了与Auth0租户交互的工具和资源，允许您管理应用程序、分析配置和排除常见的Auth0设置问题。

特性

资源

• Auth0应用程序 (auth0://applications)-租户中所有Auth0应用程序的列表
• Auth0租户设置 (auth0://tenant-settings)-Auth0租户配置和设置

工具

• get_application -通过客户端ID获取特定Auth0应用程序的详细信息

- 参数： client_id （必填）

• list_applications -列出租户中的所有Auth0应用程序

- 无需参数

• analyze_configuration -分析Auth0配置中的常见问题

- 参数： - webapp_client_id （必填）-Web应用程序使用的客户端ID - api_client_id （可选）-API使用的客户端ID - callback_url （可选）-预期的回调URL - 提供应用程序配置的详细分析，并确定常见问题

• get_tenant_settings -获取Auth0租户设置和配置

- 无需参数

先决条件

您需要具有以下作用域的Auth0 Management API应用程序：

• read:clients
• read:tenant_settings

环境变量

需要以下环境变量：

AUTH0_DOMAIN=your-tenant.auth0.com
AUTH0_CLIENT_ID=your-management-api-client-id
AUTH0_CLIENT_SECRET=your-management-api-client-secret
AUTH0_AUDIENCE=https://your-tenant.auth0.com/api/v2/

发展

安装依赖项：

npm install

构建服务器：

npm run build

对于自动重建的开发：

npm run watch

安装

要与Claude Desktop一起使用，请添加服务器配置：

在MacOS上： ~/Library/Application Support/Claude/claude_desktop_config.json 在Windows上： %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "auth0-custom": {
      "command": "node",
      "args": ["/path/to/auth0-server/build/index.js"],
      "env": {
        "AUTH0_DOMAIN": "your-tenant.auth0.com",
        "AUTH0_CLIENT_ID": "your-management-api-client-id",
        "AUTH0_CLIENT_SECRET": "your-management-api-client-secret",
        "AUTH0_AUDIENCE": "https://your-api-audience.com"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

备注：The autoApprove array允许这些工具自动运行，而无需每次手动批准，这对于列出应用程序和分析配置等只读操作非常方便。

设置Auth0管理API

1. 转到您的Auth0仪表板
2. 导航到应用程序→ APIs
3. 选择“Auth0管理API”
4. 转到“机器对机器应用程序”选项卡
5. 授权您的申请并授予所需的范围：

- read:clients - read:tenant_settings

使用示例

连接后，您可以使用服务器：

• 列出所有应用程序：使用 list_applications 用于获取所有Auth0应用程序概览的工具
• 获取特定应用程序详细信息：使用 get_application 使用客户端ID获取详细配置
• 分析配置问题：使用 analyze_configuration 识别常见的设置问题，如：

- 应用程序类型不正确 - 缺少回调URL - 授权类型配置错误 - 前端和后端之间共享客户端ID

• 访问租户设置：使用 get_tenant_settings 查看租户级别配置

调试

由于MCP服务器通过stdio进行通信，调试可能具有挑战性。我们建议使用 MCP检查员:

npm run inspector

检查器将提供一个URL，用于访问浏览器中的调试工具。

错误处理

该服务器包括全面的错误处理功能，用于：

• 无效的Auth0凭据
• 网络连接问题
• 缺少应用程序或资源
• API速率限制
• 客户端ID或配置参数无效

所有错误都会返回描述性消息，以帮助解决问题。