Skip to main content
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 nameDescription
get_devicesRetrieve device list and individual device information
get_identitiesRetrieve identity (user) list
get_servicesRetrieve the list of SaaS services in use
get_service_accountsRetrieve service account list
get_people_accountsRetrieve the mapping between users and service accounts
The AI automatically calls these tools when responding to inquiries to provide context-appropriate information.

​
Prerequisites

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

​
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. 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

1

Open integration settings

Select Settings from the left navigation and open the Integrations tab. The Admina MCP card appears in the MCP servers section.
MCP servers are automatically provisioned by AI Helpdesk. If the Admina MCP server is not displayed, contact support.
2

Open the configuration dialog

Click the Configure button on the Admina MCP card.
3

Enter credentials

Click Edit in the configuration dialog and enter the following information.
FieldDescription
ADMINA_ORGANIZATION_IDYour Admina organization ID
ADMINA_API_KEYYour Admina API key
Click Save when done.
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.
4

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

​
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.
Last modified on July 13, 2026