> ## Documentation Index
> Fetch the complete documentation index at: https://support.i.moneyforward.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Admina MCP サーバー連携

> AI Helpdesk に Admina MCP サーバーを連携し、IT 資産情報を AI が参照できるようにする手順を説明します。

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

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

| ツール名                   | 説明                      |
| ---------------------- | ----------------------- |
| `get_devices`          | デバイス一覧・個別デバイスの情報を取得     |
| `get_identities`       | アイデンティティ（ユーザー）一覧を取得     |
| `get_services`         | 利用中の SaaS サービス一覧を取得     |
| `get_service_accounts` | サービスアカウント一覧を取得          |
| `get_people_accounts`  | ユーザーとサービスアカウントの紐付け情報を取得 |

AI が問い合わせへ応答する際、これらのツールを自動的に呼び出してコンテキストに合わせた情報を提供します。

## 前提条件

<Info>
  * AI Helpdesk の **管理者（Admin）** ロールが必要です
  * Admina（[https://console.admina.jp](https://console.admina.jp)）の利用契約が必要です
  * Admina の API キーと組織 ID が必要です
</Info>

## Admina API キーを取得する

Admina の管理コンソールで API キーを発行します。
API キーの取得方法は [Admina API ドキュメント](/api-reference) を参照してください。

必要な情報は以下の 2 つです。

* 組織 ID（Organization ID）: Admina の組織識別子
* API キー: Admina API へのアクセスキー

## Admina MCP サーバーを設定する

<Steps>
  <Step title="連携設定を開く">
    左のナビゲーションから **設定** を選択し、**連携** タブを開きます。
    **MCP サーバー** セクションに **Admina MCP** のカードが表示されます。

    <Note>
      MCP サーバーは AI Helpdesk によって自動的にプロビジョニングされます。
      Admina MCP サーバーが表示されない場合は、サポートにお問い合わせください。
    </Note>
  </Step>

  <Step title="設定ダイアログを開く">
    **Admina MCP** カードの **設定** ボタンをクリックします。
  </Step>

  <Step title="認証情報を入力する">
    設定ダイアログで **編集** をクリックし、以下の情報を入力します。

    | フィールド                    | 説明              |
    | ------------------------ | --------------- |
    | `ADMINA_ORGANIZATION_ID` | Admina の組織 ID   |
    | `ADMINA_API_KEY`         | Admina の API キー |

    入力したら **保存** をクリックします。

    <Warning>
      API キーは機密情報です。画面上では `****` でマスクされます。
      設定後に確認することはできないため、安全な場所に控えておいてください。
    </Warning>
  </Step>

  <Step title="有効化と動作確認をする">
    設定ダイアログの **有効** トグルがオンになっていることを確認してください。

    **利用可能なツール** セクションに以下のツールが表示されていれば、連携は正常です。

    * `get_devices`
    * `get_identities`
    * `get_services`
    * `get_service_accounts`
    * `get_people_accounts`
  </Step>
</Steps>

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

個々のツールを有効・無効に切り替えることができます。

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

## MCP サーバーを無効化する

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

## トラブルシューティング

**ツール一覧が「取得できませんでした」と表示される**

* 認証情報（組織 ID と API キー）が正しいか確認してください
* Admina の API キーが有効期限内であり、必要なスコープ（読み取り権限）を持っているか確認してください
* AI Helpdesk の MCP サーバー URL が正しく設定されているか確認してください（サポートにお問い合わせください）

**認証情報が未設定と表示される**

設定ダイアログの **編集** から認証情報を再入力してください。

## 関連ページ

* [Admina API リファレンス](/api-reference)
* [連携（Slack）](/ai-helpdesk/integrations/slack)
* [連携（Microsoft Teams）](/ai-helpdesk/integrations/teams)
* [連携（LINE WORKS）](/ai-helpdesk/integrations/line-works)
* [連携（Google Chat）](/ai-helpdesk/integrations/google-chat)