接続ガイド - Admina Help Center

前提条件

お使いの AI コーディングアシスタントがインストールされていること
Admina の API キーを取得済みであること（API キーの取得方法）
組織 ID を確認済みであること

環境変数の設定

ターミナルのシェル設定ファイル（.bashrc, .zshrc など）に以下を追加します。または、直接 MCP の設定ファイルに値を指定できます。お使いのツールに合わせて読み替えて設定してください。

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

設定を反映します。

source ~/.zshrc

Codex CLI をお使いの場合、環境変数は起動時にプロセス自身が読み込みます。.zshrc の更新後は、新しいターミナルを開くか source ~/.zshrc を実行してから Codex を起動してください。起動中のプロセスには反映されません。

MCP サーバの設定

お使いのツールに合わせて設定を追加します。

Claude Code
Claude Cowork
Cursor
Codex

プロジェクトの .mcp.json またはユーザー設定（~/.claude.json）に以下を追加します。Claude Code の headers フィールドは環境変数を展開できないため、Authorization のように値を動的に生成したいヘッダーは headersHelper でスクリプトを指定します。組織 ID のように固定値でよいヘッダーは 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"
    }
  }
}

headersHelper に指定するスクリプトは、標準出力に JSON 形式でヘッダーを出力するようにします。

#!/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"

スクリプトに実行権限を付与します。

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

プロジェクト単位で設定する場合は .mcp.json をプロジェクトルートに配置します。全プロジェクトで利用する場合は ~/.claude.json に追加してください。

プロジェクトルートに .cursor/mcp.json を作成し、以下を追加します。Cursor の headers フィールドは ${env:変数名} の形式で環境変数を展開できます。

{
  "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 はプロジェクトルートの .cursor/mcp.json を自動的に読み込みます。グローバル設定は ~/.cursor/mcp.json に配置してください。

チームの管理画面から GUI で設定することもできます。HTTP headers 欄に Authorization と X-Admina-Organization-Id を直接入力してください。

Cursor のチーム管理画面でAdmina-itam MCPサーバーのHTTP headersにAuthorizationとX-Admina-Organization-Idを設定している画面

Codex は起動したプロセス自身の環境変数を読み込みます。.zshrc などを更新した後は、新しいターミナルを開くか source ~/.zshrc を実行してから Codex を起動してください。起動中のプロセスには反映されません。CLI コマンドで MCP サーバを登録します。

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

このコマンドは Authorization ヘッダーのみを設定します。X-Admina-Organization-Id ヘッダーを追加する CLI フラグは存在しないため、~/.codex/config.toml に以下を手動で追記してください。

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

上記の手順を実行すると、~/.codex/config.toml は以下のようになります。

[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>"

Codex App UI から設定することもできます。

既定では MCP ツールの呼び出しごとに承認が必要です。codex exec のような非対話モードでは、承認待ちのまま自動的にキャンセルされます。特定のツールを常に許可したい場合は、App UI で always allow を選択するか、~/.codex/config.toml に以下を追記してください。

[mcp_servers.admina-itam.tools.<ツール名>]
approval_mode = "approve"

接続の確認

ツールを起動し、Admina のツールが利用可能であることを確認します。

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

組織名やステータスなどの情報が返されれば、接続は正常です。

Codex CLI では codex doctor を実行して設定を確認することもできます。出力に mcp.config: ok と表示されれば、MCP サーバの設定は正しく読み込まれています。

利用可能なツール

接続後は36のツールが利用可能です。詳しくはツールリファレンスをご覧ください。

​前提条件

​環境変数の設定

​MCP サーバの設定

​接続の確認

​利用可能なツール

前提条件

環境変数の設定

MCP サーバの設定

接続の確認

利用可能なツール