AI导哈

Auth0管理配置协议服务器

一个基于TypeScript的MCP服务器，用于管理和分析Auth0租户配置，提供应用程序管理、配置分析和常见问题排查功能。

  • by shmolf
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 shmolf/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或配置参数无效

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

相关 MCP