JinDaGe - Descope Authentication MCP Details

article

README

🚀 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

手动安装

克隆仓库：

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

安装必要的依赖项：

npm install

构建项目：

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 环境变量，或者将它们直接填入配置文件中。

Descope Authentication