Descope MCP 服务器

简介

Descope Model Context Protocol (MCP) 服务器提供了一个接口，用于与 Descope 的管理 API 交互，从而实现项目相关信息的搜索和检索。

已提供的工具

• search-audits：从你的 Descope 项目中检索最多 10 条审核日志记录。
• search-users：从你的 Descope 项目中检索最多 10 条用户记录。
• create-user：在你的 Descope 项目中创建一个新用户。
• invite-user：邀请一个新的用户加入你的 Descope 项目。

先决条件

在继续之前，请确保你具备以下条件：

• Node.js（版本 18 或更高）
• 系统上安装了 Claude Desktop
• 有效的 Descope Project ID 和 Management Key
• Git 已安装

要确认你的 Node.js 安装情况，请运行：

node --version  # 预期输出: v18.0.0 或更高

安装说明

使用 Smithery 自动安装

通过 Smithery 自动为 Claude Desktop 安装 Descope MCP Server：

npx -y @smithery/cli install @descope-sample-apps/descope-mcp-server --client claude

手动安装

1. 克隆仓库：

   git clone https://github.com/descope-sample-apps/descope-mcp-server.git
   cd descope-mcp-server
   

2. 安装必要的依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

配置

1. 配置 Claude Desktop 以识别 Descope MCP 服务器

要定位 claude_desktop_config.json 文件，请打开 Claude Desktop 应用，并从顶部左侧菜单栏启用开发者模式。

启用后，转到设置（同样在顶部左侧菜单），导航至“开发者”部分，然后点击“编辑配置”按钮以访问和编辑 claude_desktop_config.json。

或者，通过终端打开配置文件：

在 macOS 上：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

在 Windows 上：

code %APPDATA%\Claude\claude_desktop_config.json

2. 添加 Descope 服务器配置：

{
  "mcpServers": {
    "descope": {
      "command": "node",
      "args": ["/path/to/descope-mcp-server/build/index.js"],
      "env": {
        "DESCOPE_PROJECT_ID": "your-descope-project-id-here",
        "DESCOPE_MANAGEMENT_KEY": "your-descope-management-key-here"
      }
    }
  }
}

将 your-descope-project-id-here 和 your-descope-management-key-here 替换为你实际的 Descope 项目 ID 和管理密钥，来自 app.descope.com/settings/project 和 app.descope.com/settings/company/managementkeys。

3. 配置完成后重启 Claude Desktop 以应用更改。

运行服务器

要运行 MCP 服务器，请在终端中执行以下命令：

node src/index.js

确保你已正确设置 project_id 和 management_key 环境变量，或者将它们直接填入配置文件中。