> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# Admina MCP server integration

> Learn how to integrate the Admina MCP server with AI Helpdesk so the AI agent can reference IT asset information in real time.

When you integrate the Admina MCP server with AI Helpdesk, the AI agent can reference Admina IT asset information in real time to provide more relevant responses.

## Tools provided by the Admina MCP server

| Tool name              | Description                                             |
| ---------------------- | ------------------------------------------------------- |
| `get_devices`          | Retrieve device list and individual device information  |
| `get_identities`       | Retrieve identity (user) list                           |
| `get_services`         | Retrieve the list of SaaS services in use               |
| `get_service_accounts` | Retrieve service account list                           |
| `get_people_accounts`  | Retrieve the mapping between users and service accounts |

The AI automatically calls these tools when responding to inquiries to provide context-appropriate information.

## Prerequisites

<Info>
  * You must have the **Admin** role in AI Helpdesk.
  * A subscription to Admina ([https://console.admina.jp](https://console.admina.jp)) is required.
  * You need an Admina API key and organization ID.
</Info>

## Obtain an Admina API key

Issue an API key from the Admina admin console.
For instructions on obtaining an API key, see the [Admina API documentation](/en/api-reference).

You need the following two pieces of information.

* Organization ID: Your Admina organization identifier
* API key: Access key for the Admina API

## Configure the Admina MCP server

<Steps>
  <Step title="Open integration settings">
    Select **Settings** from the left navigation and open the **Integrations** tab.
    The **Admina MCP** card appears in the **MCP servers** section.

    <Note>
      MCP servers are automatically provisioned by AI Helpdesk.
      If the Admina MCP server is not displayed, contact support.
    </Note>
  </Step>

  <Step title="Open the configuration dialog">
    Click the **Configure** button on the **Admina MCP** card.
  </Step>

  <Step title="Enter credentials">
    Click **Edit** in the configuration dialog and enter the following information.

    | Field                    | Description                 |
    | ------------------------ | --------------------------- |
    | `ADMINA_ORGANIZATION_ID` | Your Admina organization ID |
    | `ADMINA_API_KEY`         | Your Admina API key         |

    Click **Save** when done.

    <Warning>
      The API key is sensitive information. It is masked as `****` on screen after saving.
      Keep a secure copy of the key, as it cannot be retrieved after configuration.
    </Warning>
  </Step>

  <Step title="Verify activation and functionality">
    Confirm that the **Enabled** toggle in the configuration dialog is turned on.

    If the following tools are listed in the **Available tools** section, the integration is working correctly.

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

## Enable or disable individual tools

You can enable or disable individual tools.

In the **Available tools** section of the configuration dialog, use the toggle to the right of each tool name.
Disabled tools will not be called by the AI agent.

## Disable the MCP server

To temporarily disable the entire Admina MCP server, turn off the **Enabled** toggle in the configuration dialog.
The credentials are retained, but the AI will not call any tools.

## Troubleshooting

**"Could not retrieve tools" error**

* Verify that the credentials (organization ID and API key) are correct.
* Confirm that the Admina API key is within its validity period and has the appropriate scopes.
* Verify that the MCP server URL in AI Helpdesk is correctly configured (contact support if needed).

**"No credentials configured" message**

Click **Edit** in the configuration dialog to re-enter the credentials.

## Related pages

* [Admina API reference](/en/api-reference)
* [Slack integration](/en/ai-helpdesk/integrations/slack)
* [Microsoft Teams integration](/en/ai-helpdesk/integrations/teams)
* [LINE WORKS integration](/en/ai-helpdesk/integrations/line-works)
* [Google Chat integration](/en/ai-helpdesk/integrations/google-chat)