admina-mcp-server

MCP server for the Admina API.

Tools and API Documentation

• get_devices: Return a list of devices. Get Devices API
• get_identities: Return a list of identities. Get Identities API
• get_services: Return a list of services integrations that belongs to organization along with a preview of accounts. Organization Services API
• get_service_accounts: Return a list of accounts for a specific service. Get Service Accounts API
• get_people_accounts: Return a list of all SaaS accounts belonging to a person. Get People Accounts API

Configuration

To configure the admina-mcp-server, you will need the organizationId and an API key. For more details on obtaining your API key, please refer to the Getting Started Guide.

MCP Client Configuration

To configure this MCP server, add the following configuration to your mcp settings.

{
  "mcpServers": {
    "admina-mpc-server": {
      "command": "npx",
      "args": [
        "-y",
        "@moneyforward_i/admina-mcp-server"
      ],
      "env": {
        "ADMINA_ORGANIZATION_ID": <Organization Id>,
        "ADMINA_API_KEY": <API Key>
      }
    }
  }
}

For local set up, run yarn build:dev and set the path to the root dir.

Releasing

Preparing a release

• Bump up a package version of package.json. A Git commit will be created automatically.

yarn version --new-version <new version>

• Push the change to the main branch as usual.

Creating a release

• Create a new release in GitHub by clicking on "Releases" and then "Draft a new release"
• Set the Tag version to a new tag
• Set the Target as main.
• Set the Release title to the tag you created, vX.Y.Z
• Click "Publish release" to save and publish your release.
• GitHub Actions workflow will be triggerd by publishing a new release and the package will be released.