Descope MCP Server

Descope MCP Server

はじめに

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 経由で Descope MCP Server を Claude Desktop に自動インストールするには、次を実行してください。

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

claude_desktop_config.json ファイルを見つけるには、Claude Desktop アプリを開き、左上のメニューバーから Developer Mode を有効にします。

有効にしたら、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