local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables interaction with Okta's user management system, providing tools for retrieving detailed user information, listing users with filtering and pagination options, and managing user groups.

Okta MCP サーバー

この MCP サーバーにより、Claude は Okta のユーザー管理システムと対話して、ユーザーおよびグループの管理機能を提供できるようになります。

前提条件

Node.js (v16 以上)
クロードデスクトップアプリ
Okta開発者アカウント
Oktaからの管理者APIトークン

セットアップ手順

1. Okta開発者アカウントを作成する

Okta開発者コンソールへアクセス
新しいアカウントを作成するか、既存のアカウントにサインインしてください
Okta ドメインをメモします (例: dev-123456.okta.com )

2. APIトークンを作成する

Okta開発者コンソールで、「セキュリティ」>「API」>「トークン」に移動します。
「トークンを作成」をクリックします
トークンに意味のある名前を付けます（例：「MCP サーバートークン」）
トークンの値をコピーします（再度表示することはできません）

3. プロジェクトの初期設定

依存関係をインストールします:

npm install

4. Claudeデスクトップを設定する

Claude Desktop 構成ファイルを開きます。

MacOSの場合:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windowsの場合:

code %AppData%\Claude\claude_desktop_config.json

構成を追加または更新します。

{
    "mcpServers": {
        "okta": {
            "command": "node",
            "args": [
                "PATH_TO_PROJECT_DIRECTORY/dist/index.js"
            ],
            "env": {
                "OKTA_ORG_URL": "https://your-domain.okta.com",
                "OKTA_API_TOKEN": "your-api-token"
            }
        }
    }
}

ファイルを保存し、Claude Desktop を再起動します。

利用可能なツール

サーバーは次のツールを提供します。

get_user

Okta から以下の詳細なユーザー情報を取得します:

ユーザー詳細（ID、ステータス）
アカウントの日付（作成、有効化、最終ログインなど）
個人情報（氏名、メールアドレス）
雇用の詳細
連絡先
住所
設定

リストユーザー

オプションのフィルタリングとページ区切りを使用して、Okta のユーザーを一覧表示します。

SCIM フィルター式をサポートします (例: 'profile.firstName eq "John"')
複数のフィールドにわたる自由形式のテキスト検索
並べ替えオプション（ステータス、作成日など）
カスタマイズ可能な制限を備えたページ区切りのサポート

リストグループ

オプションのフィルタリングとページ区切りを使用して、Okta のユーザーグループを一覧表示します。

グループのフィルター式（例：'type eq "OKTA_GROUP"'）
グループフィールド全体での自由形式のテキスト検索
並べ替えオプション（名前、タイプなど）
カスタマイズ可能な制限を備えたページ区切りのサポート

クロードでの使用例

セットアップ後は、次のようなコマンドを使用できます。

「ユーザーID XXXX のユーザーの詳細を表示」
「ユーザーjohn.doe@company.comのステータスはどうなっていますか？」
「ユーザーjane.smith@organization.comの最終ログインはいつですか？」
「マーケティング部門のすべてのユーザーを一覧表示する」
「先月作成されたユーザーを検索する」
「Okta 組織内のすべてのグループを表示」
「「admin」という単語を含むグループを一覧表示する」

エラー処理

サーバーには、次の堅牢なエラー処理機能が含まれています。

ユーザーまたはグループが見つかりません (404 エラー)
API認証の問題
ユーザープロファイルが見つからないか無効です
一般的なAPIエラー

トラブルシューティング

よくある問題

Claude に表示されないツール:

Claude Desktop のログを確認します: tail -f ~/Library/Logs/Claude/mcp*.log
すべての環境変数が正しく設定されていることを確認する
index.jsへのパスが絶対パスかつ正しいことを確認してください

認証エラー:

APIトークンが有効であることを確認してください
OKTA_ORG_URL に https:// を含む完全な URL が含まれているかどうかを確認します。
Oktaドメインが正しいことを確認する

サーバー接続の問題:

サーバーが正常に構築されたかどうかを確認する
build/index.js のファイル権限を確認します（755 である必要があります）
サーバーを直接実行してみます: node /path/to/build/index.js

ログの表示

サーバーログを表示するには:

MacOS/Linuxの場合:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Windowsの場合:

Get-Content -Path "$env:AppData\Claude\Logs\mcp*.log" -Wait -Tail 20

環境変数

環境変数エラーが発生した場合は、以下を確認してください。

OKTA_ORG_URL : 完全な URL である必要があります (例: " https://dev-123456.okta.com ")
OKTA_API_TOKEN : 有効なAPIトークンである必要があります

セキュリティに関する考慮事項

APIトークンを安全に保つ
バージョン管理に資格情報をコミットしない
機密データには環境変数を使用する
APIトークンを定期的にローテーションする
Okta管理コンソールでAPIの使用状況を監視する
API呼び出しのレート制限を実装する
APIトークンに必要な最小限の権限を使用する

種類

サーバーには、Okta ユーザーおよびグループデータ用の TypeScript インターフェースが含まれています。

interface OktaUserProfile {
  login: string;
  email: string;
  secondEmail?: string;
  firstName: string;
  lastName: string;
  displayName: string;
  nickName?: string;
  organization: string;
  title: string;
  division: string;
  department: string;
  employeeNumber: string;
  userType: string;
  costCenter: string;
  mobilePhone?: string;
  primaryPhone?: string;
  streetAddress: string;
  city: string;
  state: string;
  zipCode: string;
  countryCode: string;
  preferredLanguage: string;
  profileUrl?: string;
}

interface OktaUser {
  id: string;
  status: string;
  created: string;
  activated: string;
  lastLogin: string;
  lastUpdated: string;
  statusChanged: string;
  passwordChanged: string;
  profile: OktaUserProfile;
}

interface OktaGroup {
  id: string;
  created: string;
  lastUpdated: string;
  lastMembershipUpdated: string;
  type: string;
  objectClass: string[];
  profile: {
    name: string;
    description: string;
  };
}

ライセンス

MIT ライセンス - 詳細については LICENSE ファイルを参照してください。

サポート

問題が発生した場合:

上記のトラブルシューティングセクションを確認してください
Claude Desktopのログを確認する
サーバーのエラー出力を調べる
Oktaの開発者向けドキュメントを確認する

注: PR を歓迎します!

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Claude が Okta のユーザー管理システムと対話できるようにし、ユーザーの詳細を取得したり、フィルタリングオプションを使用してユーザーを一覧表示したり、ユーザーグループを管理したりする機能を提供します。

Okta MCP Server