Kapilduraphe Okta MCP Server

🚀 Okta 管理制御プレーン (MCP) サーバー

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

🚀 クイックスタート

このセクションでは、Okta MCP サーバーをセットアップするための手順を説明します。

✨ 主な機能

• ユーザー管理：ユーザーの作成、更新、削除が可能です。
• グループ管理：ユーザーグループとそのメンバーシップを管理できます。
• 認証：Okta の多要素認証機能を統合しています。

📦 インストール

前提条件

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

セットアップ手順

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

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

2. API トークンの作成

• Okta 開発者コンソールで、「セキュリティ」>「API トークン」に移動します。
• 「トークンを作成」をクリックします。
• 必要な情報を入力し、トークンを保存します。

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

• Claude デスクトップアプリケーションを開きます。
• 「設定」>「統合」に移動します。
• Okta MCP サーバーの詳細情報（ドメイン名と API トークンを含む）を追加します。

🔧 技術詳細

エラー処理

• 一般的なエラー：詳細なエラー情報を取得するには、ログを確認してください。
• リトライメカニズム：API 呼び出しが失敗した場合、リトライポリシーを設定することをお勧めします。
• レート制限：Okta は API リクエストに一定のレート制限があります。詳細な制限については、Okta のドキュメントを参照してください。

型定義

サーバーには、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 の開発者ドキュメントを参照する。

注意：プルリクエストの送信は歓迎されます！