Connection Guide - Admina Help Center

Prerequisites

Your AI coding assistant is installed
You have an Admina API key (How to get an API key)
You have your organization ID

Set Environment Variables

Add the following to your shell configuration file (.bashrc, .zshrc, etc.). You can also set these values directly in your MCP configuration file. Adjust the format to match your tool.

export ADMINA_API_KEY="<API_TOKEN>"
export ADMINA_ORG_ID="<Organization Id>"

Apply the configuration.

source ~/.zshrc

If you use Codex CLI, the process reads environment variables at startup. After updating .zshrc, open a new terminal or run source ~/.zshrc before starting Codex. Changes do not apply to an already running process.

Configure MCP Server

Add the configuration for your tool.

Claude Code
Claude Cowork
Cursor
Codex

Add the following to your project’s .mcp.json or user settings (~/.claude.json).Claude Code’s headers field does not expand environment variables. Use headersHelper to run a script for headers that need a dynamic value, such as Authorization. Static values, such as the organization ID, can go directly in headers.

{
  "mcpServers": {
    "admina-itam": {
      "type": "http",
      "url": "https://mcp.itmc.i.moneyforward.com/mcp",
      "headers": {
        "X-Admina-Organization-Id": "<Organization ID>"
      },
      "headersHelper": "~/.claude/scripts/admina-itam-headers.sh"
    }
  }
}

The script in headersHelper must print a JSON object of headers to stdout.

#!/usr/bin/env zsh
[ -f "$HOME/.zshrc" ] && source "$HOME/.zshrc" >/dev/null 2>&1

if [ -z "$ADMINA_API_KEY" ]; then
  echo "ADMINA_API_KEY is not set" >&2
  exit 1
fi

printf '{"Authorization": "Bearer %s"}' "$ADMINA_API_KEY"

Make the script executable.

chmod +x ~/.claude/scripts/admina-itam-headers.sh

For project-specific settings, place .mcp.json in your project root. For all projects, add it to ~/.claude.json.

Create .cursor/mcp.json in your project root and add the following.Cursor’s headers field expands environment variables using the ${env:NAME} syntax.

{
  "mcpServers": {
    "admina-itam": {
      "url": "https://mcp.itmc.i.moneyforward.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:ADMINA_API_KEY}",
        "X-Admina-Organization-Id": "${env:ADMINA_ORG_ID}"
      }
    }
  }
}

Cursor automatically reads .cursor/mcp.json from your project root. For global settings, place it in ~/.cursor/mcp.json.

You can also configure this from your team’s admin dashboard. Enter Authorization and X-Admina-Organization-Id directly in the HTTP headers field.

Cursor team admin dashboard showing the Authorization and X-Admina-Organization-Id HTTP headers configured for the Admina-itam MCP server

Codex reads environment variables from its own process at startup. After updating .zshrc or similar, open a new terminal or run source ~/.zshrc before starting Codex. Changes do not apply to an already running process.Register the MCP server with the CLI command.

codex mcp add admina-itam --url "https://mcp.itmc.i.moneyforward.com/mcp" --bearer-token-env-var ADMINA_API_KEY

This command only sets the Authorization header. There is no CLI flag to add the X-Admina-Organization-Id header, so add it manually to ~/.codex/config.toml.

[mcp_servers.admina-itam.http_headers]
X-Admina-Organization-Id = "<Organization ID>"

After running the command above, ~/.codex/config.toml looks like this.

[mcp_servers.admina-itam]
url = "https://mcp.itmc.i.moneyforward.com/mcp"
bearer_token_env_var = "ADMINA_API_KEY"

[mcp_servers.admina-itam.http_headers]
X-Admina-Organization-Id = "<Organization ID>"

You can also configure this from the Codex App UI.

By default, each MCP tool call requires approval. In a non-interactive mode such as codex exec, calls are automatically canceled while waiting for approval. To always allow a specific tool, select always allow in the App UI, or add the following to ~/.codex/config.toml.

[mcp_servers.admina-itam.tools.<tool_name>]
approval_mode = "approve"

Verify the Connection

Start your tool and verify that Admina tools are available.

組織情報を取得してください

If organization name and status are returned, the connection is working.

With Codex CLI, you can also run codex doctor to check your configuration. If the output shows mcp.config: ok, the MCP server configuration was loaded correctly.

Available Tools

36 tools are available after connection. See the Tool Reference for details.

​Prerequisites

​Set Environment Variables

​Configure MCP Server

​Verify the Connection

​Available Tools

Prerequisites

Set Environment Variables

Configure MCP Server

Verify the Connection

Available Tools