Descope Sample Apps Descope MCP Server Stdio

🚀 Descope MCP サーバーの説明

Descope モデルコンテキストプロトコル（MCP）サーバーは、Descope の管理 API とやり取りするためのインターフェースを提供し、プロジェクト関連の情報を検索および取得することができます。

🚀 クイックスタート

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": ["start"],
      "cwd": "${workspaceFolder}",
      "env": {
        "NODE_ENV": "development"
      }
    }
  }
}

3. VS Code でタスクを設定する

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Descope MCP サーバーを起動する",
      "type": "shell",
      "command": "npm start",
      "args": [],
      "options": {},
      "problemMatcher": "$ npm"
    }
  ]
}

サーバーの起動

サーバーを起動するには、以下のコマンドを実行します。

npm run dev

パラメータ

• --port：サーバーのポートを指定します（デフォルトは 3000）
• --host：サーバーのホスト名を指定します（デフォルトは localhost）

例えば、ポート 8080 でサーバーを起動するには、以下のコマンドを実行します。

npm run dev -- --port 8080

環境変数

• NODE_ENV：環境モードを設定します（開発または本番）
• PORT：サーバーのポートを指定します
• HOST：サーバーのホスト名を指定します