Descope MCP Server

Descope MCP 服务

简介

Descope Model Context Protocol（MCP）服务提供了与 Descope Management 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  # Expected output: v18.0.0 or later

安装说明

通过 Smithery 安装

若要通过 Smithery 自动为 Claude Desktop 安装 Descope MCP 服务：

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 应用，并在左上角菜单栏中启用开发者模式。

启用后，转到 Settings（也在左上角菜单中），进入 Developer 部分，然后点击 Edit Config 按钮，访问并编辑 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 替换为你在 app.descope.com/settings/project 和 app.descope.com/settings/company/managementkeys 中的实际 Descope Project ID 和 Management Key。

3. 重启 Claude Desktop

要应用更改：

1. 完全退出 Claude Desktop（确保它不是仅处于最小化状态）。
2. 重新启动 Claude Desktop。
3. 检查是否出现 🔌 图标，以确认 Descope 服务已连接。

运行服务

首先，构建项目：

npm run build

1. 在 stdio 上运行服务

npm run start:stdio

2. 在 SSE 上运行服务

npm run start:sse