Skip to main content
You can integrate the Admina MCP server with AI Helpdesk. The AI agent can then reference Admina IT asset information in real time when it answers. This includes devices, employees, services, contracts, and licenses. The AI agent can also take actions, such as registering a device or updating employee details. By default, update-related tools ask for approval before they run.

Tools provided by the Admina MCP server

The AI agent uses the following Admina MCP server tools, grouped by the type of operation. Running a workflow starts a real automation on employees, so it is classified as a delete tool. It is set to Deny by default. You can see each tool name and its permission on the Permissions > Policies screen. Available Tools in the configuration dialog lists every tool that the Admina MCP server provides. This list includes tools that do not appear on Permissions > Policies. The AI agent does not use these tools. When the AI agent responds to an inquiry, it calls the allowed tools that it needs for the answer. To change the permissions, see Set tool permissions.

Prerequisites

  • You must have the Admin role in AI Helpdesk.
  • A subscription to Admina (https://itmc.i.moneyforward.com/) 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 IT Management API authentication. 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 Integration tab. The Admina MCP row 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 menu (…) at the right end of the Admina MCP row and select Configure.
3

Enter credentials

In the configuration dialog, click Edit next to Credentials and enter the following information.Click Save when done.
The API key is sensitive information. After you save it, only part of the value is shown and the rest is masked. Keep a secure copy of the key, as you cannot view the full value after configuration.
4

Verify activation and functionality

Turn on Enabled in the configuration dialog.Tools such as mcp__admina__get_devices appear under Available Tools. The Admina MCP row in the MCP Servers section shows Connected.The tool list and the Connected status do not confirm that the API key and organization ID are correct. If either is wrong, the AI agent gets an error when it uses a tool. After you finish the setup, ask the AI agent in chat for something like a list of devices, and check that it answers.
The Admina MCP row shows one of the following statuses.

Set tool permissions

Set how the AI agent handles each tool under Permissions > Policies. You cannot turn individual tools on or off in the configuration dialog.
1

Open the Policies screen

Open Permissions > Policies from the left navigation. You can also select View Policies from the menu (…) of the Admina MCP row on the Settings > Integration tab.
2

Open the Admina MCP settings

Click the Admina MCP card. If you opened the screen from View Policies, the settings open automatically, so skip this step.
3

Choose permissions

Choose a permission in the drop-down to the right of Read-Only Tools, Update-Related Tools, or Delete Tools. The permission applies to every tool of that type.To set a different permission for a single tool, click Show individual tools and choose a permission in the drop-down to the right of the tool.
4

Save

Click Save Changes.

Choose who can approve

For a tool set to Ask, use Approval Routing to choose who can approve it. Approval Routing appears under each tool when you open Show individual tools. When you set a whole tier to Ask, the default is Any Responder. You can select Requester only when Self-Approval is enabled on the Settings > Admin tab. For what approvers do, see Approve tool runs. To check approval results, see Permission Activity overview.

Disable the MCP server

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

Troubleshooting

An error appears under Available Tools
  • Check that the organization ID and API key are entered.
  • If the problem continues, contact support.
The AI agent gets an error when it uses a tool
  • Verify that the organization ID and API key are correct.
  • Confirm that the user who generated the API key is still in the organization. The key stops working when its creator leaves the organization.
The row shows “No credentials” Click Edit in the configuration dialog and enter the credentials. The AI agent does not use a specific tool On Permissions > Policies, check that the tool is not set to Deny. Delete tools are set to Deny by default. The AI agent does not use tools that are missing from Permissions > Policies, even if they appear under Available Tools.
Last modified on November 2, 2026