Onelogin MCP

🚀 OneLogin MCP Server

OneLogin MCP Serverは、Model Context Protocolをベースにしたサーバーで、OneLogin APIへの包括的なアクセスを提供します。Claude Desktop、OpenCode、その他のMCPクライアントが、ユーザー、アプリ、ロール、認証、セキュリティ設定を管理できるようにします。

🚀 クイックスタート

このサーバーは、OneLogin APIの幅広いエンドポイントへのアクセスを提供します。以下のセクションでは、インストールと使用方法について説明します。

✨ 主な機能

このサーバーは、以下の主要な機能を提供します。

• Identity Management：ユーザー、ロール、グループの管理
• Applications：アプリ、コネクタ、SAML、OAuthの管理
• Authentication：MFA、セッション、リスクルールの管理
• Security：API認可の管理
• Configuration：ブランド、マッピングの設定
• Operations：イベント、レポート、レート制限の管理

すべてのツールには、警告、ベストプラクティス、および返却データの仕様が含まれています。

📦 インストール

前提条件

• OneLogin APIの認証情報（OAuth2クライアントIDとシークレット）
• OpenCode、Claude Desktop、Copilot CLI、またはClaude CodeなどのAIクライアント

セットアップ

オプション1：環境変数（推奨）

Claude Desktopの設定ファイルで直接認証情報を設定します。別途セットアップは必要ありません。

設定ファイルを編集します。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

単一環境の場合：

{
  "mcpServers": {
    "onelogin": {
      "command": "npx",
      "args": ["-y", "@onelogin/onelogin-mcp"],
      "env": {
        "ONELOGIN_URL": "https://mycompany.onelogin.com",
        "ONELOGIN_CLIENT_ID": "your_client_id",
        "ONELOGIN_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

複数環境の場合（本番/テスト分離）：

{
  "mcpServers": {
    "onelogin-prod": {
      "command": "npx",
      "args": ["-y", "@onelogin/onelogin-mcp"],
      "env": {
        "ONELOGIN_URL": "https://company.onelogin.com",
        "ONELOGIN_CLIENT_ID": "prod_client_id",
        "ONELOGIN_CLIENT_SECRET": "prod_secret"
      }
    },
    "onelogin-test": {
      "command": "npx",
      "args": ["-y", "@onelogin/onelogin-mcp"],
      "env": {
        "ONELOGIN_URL": "https://company-test.onelogin.com",
        "ONELOGIN_CLIENT_ID": "test_client_id",
        "ONELOGIN_CLIENT_SECRET": "test_secret"
      }
    }
  }
}

オプションの環境変数：

• ONELOGIN_USE_PREPROD：事前本番環境の場合は "true" に設定
• ONELOGIN_LEGACY_KEY：レガシーAPIキー（ほとんど必要ありません）
• ONELOGIN_SERVER：ログ用のサーバー名（デフォルトは "default"）

設定後、Claude Desktopを完全に再起動します。

OpenCodeの設定

OpenCodeのユーザーは、~/.config/opencode/mcp.json に以下を追加します。

単一環境の場合：

{
  "mcpServers": {
    "onelogin": {
      "command": "npx",
      "args": ["-y", "@onelogin/onelogin-mcp"],
      "env": {
        "ONELOGIN_URL": "https://mycompany.onelogin.com",
        "ONELOGIN_CLIENT_ID": "your_client_id",
        "ONELOGIN_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

複数環境の場合：

{
  "mcpServers": {
    "onelogin-prod": {
      "command": "npx",
      "args": ["-y", "@onelogin/onelogin-mcp"],
      "env": {
        "ONELOGIN_URL": "https://company.onelogin.com",
        "ONELOGIN_CLIENT_ID": "prod_client_id",
        "ONELOGIN_CLIENT_SECRET": "prod_secret"
      }
    },
    "onelogin-test": {
      "command": "npx",
      "args": ["-y", "@onelogin/onelogin-mcp"],
      "env": {
        "ONELOGIN_URL": "https://company-test.onelogin.com",
        "ONELOGIN_CLIENT_ID": "test_client_id",
        "ONELOGIN_CLIENT_SECRET": "test_secret"
      }
    }
  }
}

設定後、OpenCodeを再起動します。

オプション2：セットアップスクリプト（servers.json）

設定ファイルを使用する代替方法です。

1. パッケージをインストールします。

npm install -g @onelogin/onelogin-mcp

2. OneLoginの認証情報を設定します。

npx onelogin-mcp-setup

プロンプトが表示されたら、OneLoginサーバーの詳細を入力します。

• サーバー名（例："Production"、"Test"）
• OneLoginサブドメインURL（例：https://mycompany.onelogin.com）
• OAuth2クライアントIDとシークレット

設定は ~/.config/onelogin-mcp/servers.json に保存されます。

3. Claude Desktopの設定に追加します。 設定ファイルを編集します。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

単一環境の場合：

{
  "mcpServers": {
    "onelogin": {
      "command": "npx",
      "args": ["-y", "@onelogin/onelogin-mcp"]
    }
  }
}

複数環境の場合（サーバー名で参照）：

{
  "mcpServers": {
    "onelogin-prod": {
      "command": "npx",
      "args": ["-y", "@onelogin/onelogin-mcp"],
      "env": {
        "ONELOGIN_SERVER": "Production"
      }
    },
    "onelogin-test": {
      "command": "npx",
      "args": ["-y", "@onelogin/onelogin-mcp"],
      "env": {
        "ONELOGIN_SERVER": "Test"
      }
    }
  }
}

4. Claude Desktopを完全に再起動します。

💻 使用例

基本的な使用法

自然言語を使用してOneLoginと対話します。

List all users with email ending in @example.com
Get details for user ID 12345
Create a user john.doe@example.com with firstname John, lastname Doe
Assign roles [123, 456] to user 789
Generate MFA token for user 101112
List all SAML apps

Claudeは適切なツールを選択し、OneLogin APIを呼び出し、結果を表示します。

📚 ドキュメント

APIカバレッジ

このサーバーは、6つの主要なカテゴリに分類された148のツールを提供します。

Identity & Access (59ツール)

• Users (14)
• Roles (13)
• Privileges (11)
• Groups (6)
• Mappings (15)

Applications (18ツール)

• Apps (15)
• Connectors (3)

Authentication (21ツール)

• MFA (10)
• Sessions (5)
• SAML (2)
• OAuth Tokens (2)
• Invite Links (2)

Security (37ツール)

• Risk Rules (6)
• Smart Hooks (10)
• API Authorization (21)

Customization (6ツール)

• Brands (6)

Monitoring (7ツール)

• Events (2)
• Reports (3)
• Rate Limits (2)

設定

認証情報の管理

サーバーは2つの設定方法をサポートしています。

1. 環境変数（推奨）：MCPクライアントの設定で ONELOGIN_URL、ONELOGIN_CLIENT_ID、および ONELOGIN_CLIENT_SECRET を設定します（上記のインストールセクションを参照）
2. 設定ファイル：npx onelogin-mcp-setup を使用して、認証情報を ~/.config/onelogin-mcp/servers.json に保存します

環境変数は設定ファイルよりも優先されます。完全な設定例については、上記のインストールセクションを参照してください。

オプションの環境変数

• ONELOGIN_USE_PREPROD：事前本番環境の場合は "true" に設定
• ONELOGIN_LEGACY_KEY：レガシーAPIキー（ほとんど必要ありません）
• ONELOGIN_SERVER：ログ用のサーバー名（デフォルトは "default"）または servers.json から名前付きサーバーを選択するために使用

レスポンス形式

すべてのツールは構造化されたレスポンスを返します。

{
  "success": true,
  "request_id": "68F194DE-0A0D05A2-55F8-0A0F6C42-01BB-62EAE-0008",
  "status": 200,
  "data": {
    // ツール固有のデータ
  }
}

request_id は、DatadogとOneLoginのログでトレースするための x-request-id HTTPヘッダーと一致します。

🔧 技術詳細

トラブルシューティング

Claude Desktopにサーバーが表示されない場合

1. JSON設定の構文を確認します。
2. index.js の絶対パスを確認します。
3. Claude Desktopを完全に再起動します（終了して再開）。

"spawn bun ENOENT" エラー

ClaudeがBunランタイムを見つけることができません。解決策は以下の通りです。

# Bunがインストールされていることを確認します
which bun

# 見つからない場合は、Bunをインストールします
curl -fsSL https://bun.sh/install | bash

# または、設定で完全なパスを使用します
{
  "command": "/Users/yourname/.bun/bin/bun",
  "args": ["run", "/path/to/index.js"]
}

認証エラー

1. 環境変数を使用している場合：Claude Desktopの設定で ONELOGIN_URL、ONELOGIN_CLIENT_ID、および ONELOGIN_CLIENT_SECRET を確認します。
2. servers.json を使用している場合：~/.config/onelogin-mcp/servers.json の認証情報を確認します。
3. OneLogin管理パネルでOAuth2クライアントにAPIアクセス権限があることを確認します。
4. client_id と client_secret がAPI v2用であることを確認します。

誤った環境

環境変数を使用している場合：各MCPサーバーエントリには独自の認証情報があります。Claudeで正しいサーバーインスタンスと通信していることを確認します。

servers.jsonを使用している場合：Claude Desktopの設定で ONELOGIN_SERVER 環境変数が servers.json のサーバー名と一致していることを確認します。

プロジェクト構造

onelogin-mcp/
├── index.js                    # MCPサーバーのエントリポイント
├── setup.js                    # 対話型の認証情報設定
├── lib/
│   ├── config.js               # 認証情報管理
│   ├── onelogin-api.js         # トークンキャッシュ付きのOAuth2クライアント
│   └── tools/
│       ├── registry.js         # ツールレジストリとディスパッチャー
│       ├── users.js            # ユーザー管理 (10ツール)
│       ├── roles.js            # ロール管理 (13ツール)
│       ├── privileges.js       # 特権管理 (11ツール)
│       ├── apps.js             # アプリ管理 (7ツール)
│       ├── mfa.js              # MFA管理 (11ツール)
│       ├── mappings.js         # ユーザーマッピング (14ツール)
│       ├── smart-hooks.js      # スマートフック (8ツール)
│       ├── risk-rules.js       # リスクルール (6ツール)
│       ├── api-authorization.js # OAuthスコープ (17ツール)
│       ├── sessions.js         # セッショントークン (5ツール)
│       ├── brands.js           # ブランディング (6ツール)
│       ├── connectors.js       # アプリカタログ (3ツール)
│       ├── reports.js          # 分析 (3ツール)
│       ├── rate-limits.js      # API制限 (2ツール)
│       ├── saml.js             # SAMLアサーション (2ツール)
│       ├── invite-links.js     # パスワードリセット (2ツール)
│       ├── oauth-tokens.js     # OAuthトークン (2ツール)
│       ├── events.js           # 監査ログ (2ツール)
│       └── groups.js           # ユーザーグループ (6ツール)
├── package.json
├── CONTRIBUTING.md
├── PROGRESS.md
└── README.md

開発

新しいツールを追加するためのガイドラインについては、CONTRIBUTING.md を参照してください。

主要な規則は以下の通りです。

• ツールの説明には、警告、ベストプラクティス、および返却データの構造が含まれています。
• すべてのモジュールは tools 配列と handlers オブジェクトをエクスポートします。
• レジストリはモジュールインポートから自動的にツールを検出します。

リリース

npmに新しいバージョンを公開するには、以下の手順を実行します。

1. 変更をマージ：main ブランチに変更をマージします。

2. GitHubリリースを作成：

   • Releases にアクセスし、"Draft a new release" をクリックします。
   • 新しいタグを作成し、バージョンを指定します（例：v1.1.0）。
   • リリースタイトルを設定します（例："v1.1.0 - MFA API fixes"）。
   • 変更内容を説明するリリースノートを追加します。
   • "Publish release" をクリックします。

3. 自動公開：GitHubアクションが以下の処理を行います。

   • リリースタグからバージョンを抽出します（v プレフィックスを削除）。
   • package.json を新しいバージョンに更新します。
   • @onelogin/onelogin-mcp としてnpmに公開します。

バージョン形式：セマンティックバージョニング（MAJOR.MINOR.PATCH）を使用します。

• MAJOR：APIの破壊的な変更
• MINOR：新機能、下位互換性あり
• PATCH：バグ修正、下位互換性あり

手動公開（必要な場合）：

• Actions → "Publish Package" → "Run workflow" をクリックします。
• 必要に応じてバージョンを上書き指定します。

サポート

• GitHub Issues
• OneLogin API Documentation
• Model Context Protocol

📄 ライセンス

MIT