メインコンテンツへスキップ
AI Helpdesk に Admina MCP サーバーを連携すると、AI エージェントが Admina の IT 資産情報(デバイス・アイデンティティ・サービスなど)をリアルタイムで参照した回答を提供できるようになります。

Admina MCP サーバーが提供するツール

ツール名説明
get_devicesデバイス一覧・個別デバイスの情報を取得
get_identitiesアイデンティティ(ユーザー)一覧を取得
get_services利用中の SaaS サービス一覧を取得
get_service_accountsサービスアカウント一覧を取得
get_people_accountsユーザーとサービスアカウントの紐付け情報を取得
AI が問い合わせへ応答する際、これらのツールを自動的に呼び出してコンテキストに合わせた情報を提供します。

前提条件

  • AI Helpdesk の 管理者(Admin) ロールが必要です
  • Admina(https://console.admina.jp)の利用契約が必要です
  • Admina の API キーと組織 ID が必要です

Admina API キーを取得する

Admina の管理コンソールで API キーを発行します。 API キーの取得方法は Admina API ドキュメント を参照してください。 必要な情報は以下の 2 つです。
  • 組織 ID(Organization ID): Admina の組織識別子
  • API キー: Admina API へのアクセスキー

Admina MCP サーバーを設定する

1

連携設定を開く

左のナビゲーションから 設定 を選択し、連携 タブを開きます。 MCP サーバー セクションに Admina MCP のカードが表示されます。
MCP サーバーは AI Helpdesk によって自動的にプロビジョニングされます。 Admina MCP サーバーが表示されない場合は、サポートにお問い合わせください。
2

設定ダイアログを開く

Admina MCP カードの 設定 ボタンをクリックします。
3

認証情報を入力する

設定ダイアログで 編集 をクリックし、以下の情報を入力します。
フィールド説明
ADMINA_ORGANIZATION_IDAdmina の組織 ID
ADMINA_API_KEYAdmina の API キー
入力したら 保存 をクリックします。
API キーは機密情報です。画面上では **** でマスクされます。 設定後に確認することはできないため、安全な場所に控えておいてください。
4

有効化と動作確認をする

設定ダイアログの 有効 トグルがオンになっていることを確認してください。利用可能なツール セクションに以下のツールが表示されていれば、連携は正常です。
  • get_devices
  • get_identities
  • get_services
  • get_service_accounts
  • get_people_accounts

ツールの有効・無効を切り替える

個々のツールを有効・無効に切り替えることができます。 設定ダイアログの 利用可能なツール セクションで、各ツール名の右にあるトグルを操作してください。 無効にしたツールは AI エージェントから呼び出されなくなります。

MCP サーバーを無効化する

Admina MCP サーバー全体を一時的に無効にするには、設定ダイアログの 有効 トグルをオフにします。 認証情報は保持されたまま、AI がツールを呼び出さない状態になります。

トラブルシューティング

ツール一覧が「取得できませんでした」と表示される
  • 認証情報(組織 ID と API キー)が正しいか確認してください
  • Admina の API キーが有効期限内であり、必要なスコープ(読み取り権限)を持っているか確認してください
  • AI Helpdesk の MCP サーバー URL が正しく設定されているか確認してください(サポートにお問い合わせください)
認証情報が未設定と表示される 設定ダイアログの 編集 から認証情報を再入力してください。

関連ページ

最終更新日 2026年7月13日