Descope Sample Apps Descope MCP Server

🚀 Descope MCP サーバーの説明

Descope モデルコンテキストプロトコル (MCP) サーバーは、Descope の管理 API インターフェースとの相互作用を可能にし、プロジェクト関連の情報を検索および取得できます。

🚀 クイックスタート

概要

Descope モデルコンテキストプロトコル (MCP) サーバーは、Descope の管理 API インターフェースとのやり取りを可能にし、プロジェクト関連の情報を検索および取得できます。

利用可能なツール

• search-audits：Descope プロジェクトから最大 10 件の監査ログレコードを取得します。
• search-users：Descope プロジェクトから最大 10 件のユーザーレコードを取得します。
• create-user：Descope プロジェクトに新しいユーザーを作成します。
• invite-user：新しいユーザーを Descope プロジェクトに招待します。

✨ 主な機能

Descope MCP サーバーは、Descope の管理 API とのやり取りを通じて、プロジェクトの監査ログやユーザー情報の検索、新規ユーザーの作成や招待などの機能を提供します。

📦 インストール

前提条件

始める前に、以下のことを確認してください：

• Node.js（バージョン 18 以上）
• システムに Claude Desktop がインストールされている
• 有効な Descope プロジェクト ID と 管理キー
• Git がインストールされている

Node.js のインストールを確認します：

node --version  # 期待される出力: v18.0.0 以上

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 サーバーを認識するように設定する

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 と管理キーに置き換えてください。

3. Claude Desktop を再起動する

変更を適用するには：

1. Claude Desktop を完全に終了します（最小化ではなく完全に閉じることを確認）。
2. Claude Desktop を再起動します。
3. 🔌 アイコンを確認して、Descope サーバーが接続されていることを確認します。

実行

設定が完了したら、以下のコマンドを実行してサーバーを起動します：

node index.js

これにより、Descope MCP サーバーが起動し、Claude Desktop とのやり取りが可能になります。