Okta User Management

🚀 Okta MCP サーバー

この MCP サーバーは、Claude が Okta のユーザー管理システムと相互作用できるようにし、ユーザーとグループの管理機能を提供します。

🚀 クイックスタート

この Okta MCP サーバーを使用することで、Claude は Okta のユーザー管理システムと連携し、ユーザーやグループの管理が可能になります。以下にセットアップ手順や使用方法を説明します。

✨ 主な機能

• Claude と Okta のユーザー管理システムの連携
• ユーザーの詳細情報の取得、全ユーザーの一覧表示
• グループの作成と削除

📦 インストール

前提条件

• Node.js (v16 以上)
• Claude デスクトップアプリケーション
• Okta 開発者アカウント
• Okta の管理者 API Token

セットアップ手順

1. Okta 開発者アカウントの作成

• Okta 開発者コンソールにアクセスします。
• 新しいアカウントを作成するか、既存のアカウントにログインします。
• Okta のドメイン名（例：dev-123456.okta.com）を記録します。

2. API Token の作成

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

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

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

npm install

4. Claude デスクトップアプリケーションの設定

config.json ファイルに以下の内容を追加します：

{
  "okta": {
    "url": "https://your-domain.okta.com",
    "token": "your-okta-token"
  }
}

💻 使用例

基本的な使用法

ユーザー詳細情報の取得

get-user コマンドを使用して、単一ユーザーの詳細情報を取得します：

claudius get-user --id <user-id>

全ユーザーの一覧表示

Okta 内のすべてのユーザーを一覧表示します：

claudius list-users

高度な使用法

新しいグループの作成

Claude デスクトップアプリケーションで以下のコマンドを使用して新しいグループを作成します：

claudius create-group --name "New Group"

指定グループの削除

Claude デスクトップアプリケーションで以下のコマンドを使用して指定グループを削除します：

claudius delete-group --id <group-id>

📚 ドキュメント

エラー処理

一般的なエラー

1. 権限不足：API Token が管理者権限を持っていることを確認してください。
2. 接続問題：Okta サービスの状態またはネットワーク接続を確認してください。

トラブルシューティング

設定ファイルの確認

config.json ファイル内の URL とトークンの値が正しいことを確認してください。

ログの確認

コンソールで Claude デスクトップアプリケーションのログ出力を確認し、詳細情報を取得してください。

セキュリティに関する注意事項

• 乱用を防止するためにレート制限を実装してください。
• API の使用状況を監視し、コンプライアンスを確保してください。
• API Token の権限を定期的に見直し、最小限に抑えてください。

型定義

サーバーには、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 デスクトップアプリケーションのログを確認する
• Okta 開発者ドキュメントを確認する