Descope MCP Server

🚀 Descope MCP サーバー説明

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

🚀 クイックスタート

利用可能なツール

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

前提条件

続行する前に、以下の条件を満たしていることを確認してください。

• 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 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": ["--loader", "ts-node/esm"],
      "options": ["--loader", "ts-node/esm"],
      "cwd": "${file.path}",
      "config": {
        "type": "stdio",
        "encoding": "utf8",
        "interactive": false,
        "tty": false
      },
      "stdio": "inherit"
    }
  }
}

上記の内容を claude_desktop_config.json ファイルに追加し、プレースホルダーを実際のプロジェクト ID と管理キーに置き換えます。

3. サーバーを起動する

設定が完了したら、以下のコマンドでサーバーを起動できます。

npm run start

注意事項

• Node.js のバージョンが要件を満たしていることを確認してください。
• 設定ファイルを編集する際は、パスとプレースホルダーを注意深く扱ってください。
• インストールまたは設定中に問題が発生した場合は、ターミナルのエラー出力を確認し、すべての依存関係が正しくインストールされていることを確認してください。

以上の手順に従えば、Descope MCP サーバーを正常に設定して起動できるはずです。