> ## Documentation Index
> Fetch the complete documentation index at: https://support.i.moneyforward.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 接続ガイド

> AI コーディングアシスタントから Admina Remote MCP Server に接続する方法です。

## 前提条件

* お使いの AI コーディングアシスタントがインストールされていること
* Admina の API キーを取得済みであること（[API キーの取得方法](/api-reference/it-management/authentication)）
* 組織 ID を確認済みであること

## 環境変数の設定

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

```bash theme={null}
export ADMINA_API_KEY="<API_TOKEN>"
export ADMINA_ORG_ID="<Organization Id>"
```

設定を反映します。

```bash theme={null}
source ~/.zshrc
```

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

## MCP サーバの設定

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

<Tabs>
  <Tab title="Claude Code">
    プロジェクトの `.mcp.json` またはユーザー設定（`~/.claude.json`）に以下を追加します。

    Claude Code の `headers` フィールドは環境変数を展開できないため、`Authorization` のように値を動的に生成したいヘッダーは `headersHelper` でスクリプトを指定します。組織 ID のように固定値でよいヘッダーは `headers` に直接書けます。

    ```json theme={null}
    {
      "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 形式でヘッダーを出力するようにします。

    ```zsh theme={null}
    #!/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"
    ```

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

    ```bash theme={null}
    chmod +x ~/.claude/scripts/admina-itam-headers.sh
    ```

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

  <Tab title="Claude Cowork">
    <Info>
      Claude Cowork ではヘッダー設定を送信できないため、現在連携できません。Claude Code をご利用ください。今後、順次対応を検討していきます。
    </Info>
  </Tab>

  <Tab title="Cursor">
    プロジェクトルートに `.cursor/mcp.json` を作成し、以下を追加します。

    Cursor の `headers` フィールドは `${env:変数名}` の形式で環境変数を展開できます。

    ```json theme={null}
    {
      "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}"
          }
        }
      }
    }
    ```

    <Info>
      Cursor はプロジェクトルートの `.cursor/mcp.json` を自動的に読み込みます。グローバル設定は `~/.cursor/mcp.json` に配置してください。
    </Info>

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

    <Frame>
      <img src="https://mintcdn.com/moneyforwardi/U0nP8ZZ4d6AhkEbv/images/remote-mcp/it-management/connection-guide/cursor-team-mcp-settings.png?fit=max&auto=format&n=U0nP8ZZ4d6AhkEbv&q=85&s=997100b318e871dd7b792ca1c879aeb5" alt="Cursor のチーム管理画面でAdmina-itam MCPサーバーのHTTP headersにAuthorizationとX-Admina-Organization-Idを設定している画面" style={{ maxWidth: "min(100%, 600px)", height: "auto" }} width="902" height="1065" data-path="images/remote-mcp/it-management/connection-guide/cursor-team-mcp-settings.png" />
    </Frame>
  </Tab>

  <Tab title="Codex">
    Codex は起動したプロセス自身の環境変数を読み込みます。`.zshrc` などを更新した後は、新しいターミナルを開くか `source ~/.zshrc` を実行してから Codex を起動してください。起動中のプロセスには反映されません。

    CLI コマンドで MCP サーバを登録します。

    ```bash theme={null}
    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` に以下を手動で追記してください。

    ```toml theme={null}
    [mcp_servers.admina-itam.http_headers]
    X-Admina-Organization-Id = "<Organization ID>"
    ```

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

    ```toml theme={null}
    [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>"
    ```

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

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

    ```toml theme={null}
    [mcp_servers.admina-itam.tools.<ツール名>]
    approval_mode = "approve"
    ```
  </Tab>
</Tabs>

## 接続の確認

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

```text theme={null}
組織情報を取得してください
```

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

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

## 利用可能なツール

接続後は36のツールが利用可能です。詳しくは[ツールリファレンス](/remote-mcp/it-management/tools)をご覧ください。