TalentLMS

@mindstone/mcp-server-talentlms

Model Context Protocol ホスト向けの TalentLMS MCP サーバーです。標準化された MCP インターフェースを通じて、TalentLMS のユーザー、コース、グループ、ブランチ、カテゴリー、登録、レポート、アセスメントを管理できます。

ステータス

• バージョン： 0.4.0 · npm
• 認証： API キー（TALENTLMS_API_KEY）
• ツール： 28（ユーザー、コース、グループ、カテゴリー、レポート、アセスメント）
• インターフェース： cloud-api
• 機械可読： STATUS.json

要件

• Node.js 20+
• npm

ワンクリックインストール

ボタンをクリックすると、ホストから次の項目の入力を求められます：TALENTLMS_API_KEY、TALENTLMS_DOMAIN、TALENTLMS_REQUEST_TIMEOUT。

{
  "mcpServers": {
    "TalentLMS": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-talentlms"
      ],
      "env": {
        "TALENTLMS_API_KEY": "",
        "TALENTLMS_DOMAIN": "",
        "TALENTLMS_REQUEST_TIMEOUT": "30000"
      }
    }
  }
}

クイックスタート

インストールとビルド

cd <path-to-repo>/connectors/talentlms
npm install
npm run build

npx（公開後に使用）

npx -y @mindstone/mcp-server-talentlms

ローカル

node dist/index.js

設定

環境変数

• TALENTLMS_API_KEY — TalentLMS API キー
• TALENTLMS_DOMAIN — TalentLMS のサブドメイン（例：acme.talentlms.com の場合は acme）
• TALENTLMS_REQUEST_TIMEOUT — リクエストのタイムアウト（ミリ秒、既定値：30000）
• MCP_HOST_BRIDGE_STATE — 認証情報の管理に使用するホストブリッジ状態ファイルの任意のパス
• MINDSTONE_REBEL_BRIDGE_STATE — MCP_HOST_BRIDGE_STATE と後方互換性のある別名

ホスト設定の例

Claude Desktop / Cursor

{
  "mcpServers": {
    "TalentLMS": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-talentlms"],
      "env": {
        "TALENTLMS_API_KEY": "your-api-key",
        "TALENTLMS_DOMAIN": "your-domain"
      }
    }
  }
}

ローカル開発（npm で公開する必要はありません）

{
  "mcpServers": {
    "TalentLMS": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/talentlms/dist/index.js"],
      "env": {
        "TALENTLMS_API_KEY": "your-api-key",
        "TALENTLMS_DOMAIN": "your-domain"
      }
    }
  }
}

ツール（28）

リスト取得ツールはページネーションに対応しています：TalentLMS は既定で1ページあたり20件を返します。大規模なテナントをページ単位で取得するには、page_size（最大1000）とpage_numberを指定してください。

設定

• configure_talentlms — TalentLMS API の認証情報を設定します

ユーザー

• list_talentlms_users — ユーザーの一覧を取得します（ページネーション対応）
• get_talentlms_user — ID またはメールアドレスでユーザーの全プロフィールを取得します
• create_talentlms_user — 新しいユーザーを作成します
• update_talentlms_user — 既存のユーザーを更新します（名前、メールアドレス、ログイン、パスワード、自己紹介、タイムゾーン、無効化日。権限を持たないユーザー種別のみ）
• set_talentlms_user_status — ユーザーを有効化または無効化します
• get_talentlms_user_courses — ユーザーが登録しているすべてのコースを取得します

コース

• list_talentlms_courses — コースを一覧表示します（ページネーション対応）
• get_talentlms_course — ID を指定してコースの詳細情報をすべて取得します
• create_talentlms_course — 新しいコースを作成します
• get_talentlms_course_users — コースに登録されているすべてのユーザーを取得します
• enrol_talentlms_user — ユーザーをコースに登録します
• unenrol_talentlms_user — ユーザーをコースから削除します
• get_talentlms_course_sso_link — ユーザーをコースに直接アクセスさせるための SSO リンクを生成します

グループ

• list_talentlms_groups — グループを一覧表示します（ページネーション対応）
• get_talentlms_group — メンバーとコースを含むグループの詳細情報を取得します
• create_talentlms_group — 新しいグループを作成します
• add_course_to_talentlms_group — コースをグループに割り当てます

ブランチ

• list_talentlms_branches — ブランチを一覧表示します（ページネーション対応、マルチテナント）

カテゴリー

• list_talentlms_categories — コースカテゴリーを一覧表示します（ページネーション対応）

レポート

• get_talentlms_site_info — サイトレベルの統計情報と設定を取得します
• get_talentlms_timeline — ユーザーまたはコースのアクティビティタイムラインを取得します
• get_talentlms_user_progress — コースにおけるユーザーの詳細な進捗状況を取得します
• get_talentlms_leaderboard — ゲーミフィケーションのリーダーボード（ポイント順にユーザーを表示します。全ユーザーリストをもとに、1 回につき 1000 件ずつページ単位で取得するため、ユーザーが漏れることはありません）
• get_talentlms_user_certifications — ユーザーに発行された認定証と有効期限を取得します

アセスメント

• get_talentlms_test_answers — テスト／クイズに対するユーザーの回答を取得します
• get_talentlms_survey_answers — アンケートに対するユーザーの回答を取得します
• get_talentlms_ilt_sessions — ユニットの講師主導トレーニングセッションを取得します

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

• 信頼できないコンテンツのエンベロープ： TalentLMS 内で作成されたテキスト（コースやグループの説明、ユーザー名／自己紹介／カスタムフィールド、テストやアンケートの回答など）は、<untrusted-content source="..."> エンベロープ内に返されるため、ホストモデルはこれを指示ではなくデータとして扱います。ID、ステータス、タイムスタンプ、その他のメタデータは、ツールを連鎖して使用する際（例：user_id を次の呼び出しにコピーする場合）も機能するよう、意図的にそのまま返されます。
• 権限ガード： create_talentlms_user と update_talentlms_user で受け付けるユーザータイプは、権限のない Learner／Trainer のみです。Administrator／SuperAdmin アカウントは TalentLMS の UI で管理する必要があります。

ライセンス

FSL-1.1-MIT — Functional Source License バージョン 1.1。将来的に MIT ライセンスが適用されます。このソフトウェアは 2030-04-08 に MIT ライセンスへ移行します。