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

# Iru MCP

> テナントにスコープされた MCP 対応トークンを作成して、Cursor、Claude Desktop、OpenAI Codex、またはその他の MCP クライアントを Iru の Enterprise API に接続します。

### はじめに

\*\*Model Context Protocol（MCP）\*\*は、クライアントアプリケーション（**ホスト**）を **MCP サーバー**に接続するためのオープン標準です。サーバーはツール、リソース、プロンプトを公開するため、追加するアシスタントやワークフローごとに個別のカスタム連携を構築・保守しなくても、AI アシスタントが 1 つの一貫したパターンで環境内の許可されたアクションを実行できます。

**Iru Model Context Protocol（MCP）サーバー**は、Iru の **Enterprise API** を AI アシスタント向けの MCP ツールとして構成して公開します。Cursor、Claude Desktop、OpenAI Codex、またはその他の MCP 対応クライアントを接続すると、独自の Iru API 連携を構築することなく、自然言語でデバイス、Blueprints、Library Items を照会し、許可されたアクションを実行できます。また、Iru のツールを他のベンダーのツール（チケット管理、チャット、IAM など）と組み合わせて、自然言語でオーケストレーションするエンドツーエンドのワークフローを作成することもできます。Iru が Enterprise API の機能を追加すると、それらの機能は同じ権限モデルで MCP を通じて利用できるようになります。

<Note>
  Enterprise API（およびそれを基盤とする MCP）は、テナントと利用資格に応じて、Endpoint や 脆弱性管理、Endpoint Detection and Response などその他の製品を含め、その API を提供する Iru の各領域に適用されます。
</Note>

REST の使用方法（MCP 以外での HTTP API とベアラートークン）については、[Iru API の概要](/en/endpoint/api/iru-api-overview)を参照してください。

### 開始する前に

* [Iru API の概要](/en/endpoint/api/iru-api-overview)で説明されているように、**アクセス** で **API トークン**を作成・管理する権限を持つ Iru 管理者アカウントが必要です。
* **サポートされている MCP クライアント**（Claude Desktop、Cursor、Codex など）が必要です。

### MCP を有効にした API トークンを作成する

UI の詳しい手順（スクリーンショット、**Copy Token**、**次へ**、**構成** / **Skip**、権限グリッド）については、[Iru API の概要](/en/endpoint/api/iru-api-overview)の **[API トークンの生成](/en/endpoint/api/iru-api-overview#generate-an-api-token)** を参照してください。ここでの手順はその記事と一致しています。Iru がこのトークンの MCP 構成を発行するよう、**作成** の前に **Enable MCP** をオンにする必要があります。

<Steps>
  <Step title="アクセスを開く">
    サイドバーで [**アカウントメニューボタン**](/ja/iru/platform-overview/account-menu) を選択し、**アクセス** を選択します。
  </Step>

  <Step title="APIトークン タブを開く">
    **アクセス** で **APIトークン** タブを選択します。
  </Step>

  <Step title="新しい API トークンを作成する">
    **Add Token** を選択して新しい API トークンを作成します。
  </Step>

  <Step title="トークンの詳細を構成する">
    API トークンの **名前** と **説明** を入力します。
  </Step>

  <Step title="MCP を有効にする">
    **作成** を選択する前に **Enable MCP** をオンにします。MCP にはこの手順が必須です。**Enable MCP** がオフの場合、MCP アクセスや MCP 構成のない Enterprise API トークンが発行されます。
  </Step>

  <Step title="トークンを作成する">
    **作成** を選択します。
  </Step>
</Steps>

<Note>
  **API レート制限:** Iru Endpoint Management API には、**顧客あたり 1 時間に 10,000 リクエスト**の制限があります。MCP の呼び出しは、そのトークンの **MCP構成** の **`headers`** にある **`X-API-Key`** の値で認証され、直接の REST 使用やその他の連携と**同じテナントの 1 時間あたりの制限**にカウントされます。\*\*テナント内のすべての API トークンがこの制限を共有します。\*\*背景情報とトラブルシューティングについては、Iru API の概要の[考慮事項](/en/endpoint/api/iru-api-overview#considerations)および [Iru Endpoint Management API ドキュメント](https://api-docs.kandji.io/)を参照してください。
</Note>

### トークンと MCP 構成をコピーする

トークンを作成すると、Iru に 1 回限りの成功画面 **トークンが正常に作成されました。** が表示されます。必要なものをコピーして安全に保管してください。再度表示されることはありません。以下の手順を順番に実行します。**MCP構成** とは、手順 2 の **Copy MCP構成** で取得する JSON を指します。

<Steps>
  <Step title="API トークンをコピーする（MCP 以外の API 使用時のみ・オプション）">
    REST またはカスタムスクリプトの場合は、成功画面の **API token** の横にある **コピー** を使用します。この値は MCP には使用されません。
  </Step>

  <Step title="MCP 構成をコピーする">
    **MCP構成** で JSON を確認し、**Copy MCP構成** を使用します。Iru のスニペットは **`url`**、**`type`**、**`headers`** で構成されています。

    * **URL**: **`url`** フィールド（Iru が提供する MCP エンドポイント）。
    * **X-API-Key**: **`headers`** 内の **`X-API-Key`** エントリ。スニペットにすでに含まれている **`sk_live:`** プレフィックスも含め、Iru に表示されているとおりに正確にコピーしてください。MCP クライアントは各リクエストでこれを **`X-API-Key`** HTTP ヘッダーとして送信します。
    * **X-MCP-Profile**: **`headers`** 内の **`X-MCP-Profile`** エントリ。**`X-MCP-Profile`** HTTP ヘッダーとして送信されます。

    <Note>
      **Copy MCP構成** で取得するのが MCP 用の JSON です。**`headers`** の値は Iru に表示されているとおりに使用してください。**`X-API-Key`** の値には、スニペットにすでに含まれている **`sk_live:`** プレフィックスが含まれます。
    </Note>

    プレースホルダーの例:

    ```json mcp.json lines theme={null}
    {
      "mcpServers": {
        "iru": {
          "url": "https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools",
          "type": "http",
          "headers": {
            "X-API-Key": "sk_live:YOUR_API_KEY",
            "X-MCP-Profile": "YOUR_PROFILE_ID"
          }
        }
      }
    }
    ```
  </Step>

  <Step title="確認チェックボックスを選択する">
    確認チェックボックス **I have copied the token and MCP構成 and understand that I will not be able to see these details again.** を選択します。
  </Step>

  <Step title="次へを選択する">
    **次へ** を選択します。
  </Step>
</Steps>

<Note>
  トークンまたは構成を紛失した場合は、トークンを**取り消して\*\*\*\*新しいトークンを作成**してください。
</Note>

### API 権限を構成する

**次へ** を選択すると、**Manage API Permissions** 画面が表示されます。これらの権限は、MCP がアクセスできる Enterprise API エンドポイントを制御します。

<Steps>
  <Step title="今すぐ構成するかスキップする">
    次のいずれかを選択します。

    * **構成**: 今すぐ権限を設定します（推奨）。
    * **Skip**: 後で権限を設定します。
  </Step>

  <Step title="エンドポイントを選択する（構成を選択した場合）">
    **構成** を選択した場合は、権限リストを使用してこのトークンで実行できる操作を選択します。

    * カテゴリ（**Blueprints** など）を展開して、個々のエンドポイントを表示します。
    * 許可するエンドポイントのチェックボックスをオンにします。
  </Step>

  <Step title="保存する">
    完了したら、**保存** を選択します。
  </Step>

  <Step title="確認する">
    作成時に MCP をオンにした場合はトークンに **MCP enabled: Yes** と表示されていること、および選択した権限が有効になっていることを確認します。
  </Step>

  <Step title="後で権限を構成する（スキップした場合）">
    権限の設定をスキップした場合は、後でトークンを開いて **編集** を選択し、権限を選んで **保存** を選択することで構成できます。
  </Step>
</Steps>

### API トークンを取り消す

他の API トークンと同様に、**アクセス** でトークンを取り消します。手順と **アクティビティ** に関する注意事項については、[Iru API の概要](/en/endpoint/api/iru-api-overview)の **[トークンの取り消し](/en/endpoint/api/iru-api-overview#revoke-a-token)** を参照してください。

### 考慮事項

<AccordionGroup>
  <Accordion title="シークレットの 1 回限りの表示">
    **コピー** で取得する REST API トークンと **MCP構成** の JSON は、いずれも作成時の成功画面に 1 回だけ表示されます。
  </Accordion>

  <Accordion title="取り消しはすべてに影響する">
    トークンを取り消すと、そのトークンに依存していた API アクセスと MCP アクセスが停止します。
  </Accordion>

  <Accordion title="破壊的なアクション">
    破壊的な操作（消去、削除、ロックなど）については、MCP の許可リストにそのアクションを追加していない限り、アシスタントが影響を要約し、実行前に明示的な承認を求めるようにしてください。組織の変更管理ルールに従ってください。
  </Accordion>

  <Accordion title="ページネーション">
    大きなリストのレスポンスはページ分割されます。すべての行をチャットに取り込まずに完全なデータセットが必要な場合は、アシスタントにフィルターの絞り込み、次のページへの移動、またはエクスポートを依頼してください。
  </Accordion>

  <Accordion title="クライアント固有の構成">
    **MCP構成** は、**`url`**、**`type`**、**`headers`** を含む JSON です。**`headers`** には **`X-API-Key`** と **`X-MCP-Profile`** が含まれており、これらは Iru が各 MCP リクエストで必要とする値です。クライアントで **`url`** を指定し、これら 2 つのヘッダー値を変更せずに転送してください。**`X-API-Key`** の値には、スニペットにすでに含まれている **`sk_live:`** プレフィックスが含まれます。
  </Accordion>
</AccordionGroup>

### ベストプラクティス

<CardGroup cols={2}>
  <Card title="最小権限を使用する" icon="shield-halved">
    自動化に必要な Enterprise API スコープのみを持つトークンを作成し、そのトークンで MCP を有効にします。
  </Card>

  <Card title="チームやユースケースごとにトークンを分ける" icon="layer-group">
    たとえば、レポート用のアシスタントには読み取り中心のトークンを、修復ワークフローにはより範囲を絞った運用トークンを使用します。
  </Card>

  <Card title="疑わしい場合はローテーションする" icon="arrows-rotate">
    **MCP構成** が漏洩した場合は、Iru でトークンを取り消して新しいトークンを発行し、古い **`url`** または **`headers`** の値を保持しているすべての MCP クライアントを更新します。
  </Card>

  <Card title="ローカルの構成ファイルを保護する" icon="terminal">
    **`claude_desktop_config.json`** には **`url`** とヘッダーの値が含まれています。ソース管理にコミットしたり、チャットログで共有したりしないでください。
  </Card>

  <Card title="MCP と API のシークレットを保護する" icon="lock">
    **MCP構成** と、MCP 以外の用途で **コピー** した REST トークンはシークレットとして扱ってください。チャットログやスクリーンショットではなく、パスワードマネージャーまたは安全な保管庫に保存してください。
  </Card>
</CardGroup>

### MCP クライアントに Iru MCP を追加する

クライアントを選択し、そのホストの手順に従います。

<Tabs>
  <Tab title="Claude Desktop" icon="desktop" iconType="solid">
    ### Claude Desktop に Iru MCP を追加する

    **Claude Desktop** は、Claude とチャットするための Anthropic のデスクトップアプリです。**MCP構成** の **`url`** と **`headers`** の値で **`claude_desktop_config.json`** を編集して Iru を登録します。

    ### 前提条件

    * Iru で[トークンと MCP 構成をコピーする](#copy-your-token-and-mcp-configuration)を完了し、**`url`** と **`headers`**（**`X-API-Key`**、**`X-MCP-Profile`**）を用意します。
    * [nodejs.org](https://nodejs.org/) から **Node.js 20 以降**をインストールします。インストーラーには **`npx`** が含まれており、Claude Desktop はこれを使用して Iru MCP 接続を実行します。

    <Note>
      Claude Desktop が最新の **mcp-remote** パッケージを実行するよう、**`args`** では **`mcp-remote@latest`** を使用してください。**`latest`** で MCP 接続が失敗する場合は、一時的に以前のバージョン（例: **`mcp-remote@0.1.13`**）に固定してください。この失敗が発生した場合、問題は Iru ではなく **mcp-remote** にあります。
    </Note>

    <Tabs>
      <Tab title="macOS" icon="apple" iconType="brands">
        <Steps>
          <Step title="Claude Desktop をダウンロードしてインストールする">
            macOS 版 Claude Desktop をダウンロードし、アプリをインストールしてサインインします: [Download Claude](https://claude.com/download)。
          </Step>

          <Step title="Claude Desktop の設定を開く">
            Claude Desktop を開き、メニューバーから **Claude → Settings** を選択します。
          </Step>

          <Step title="Developer 設定を開く">
            **設定** で **Developer** を選択します。
          </Step>

          <Step title="構成ファイルを開く">
            **Developer** で **Edit Config** を選択します。Claude Desktop が **Finder** で構成フォルダを開きます。
          </Step>

          <Step title="claude_desktop_config.json を開く">
            そのフォルダにある **`claude_desktop_config.json`** を任意のテキストエディタで開きます。

            <Note>
              新しいファイルには **`{}`** と表示されている場合があります。既存のファイルには、すでに **`mcpServers`**、**`preferences`**、またはその他の設定が含まれている場合があります。その場合は、**`mcpServers`** 内に **`"iru"`** ブロックのみを追加し、残りはそのままにしてください。**`mcpServers`** の閉じ括弧 **`}`** の後、次のトップレベルセクション（例: **`"preferences"`**）の前にカンマを追加します。
            </Note>
          </Step>

          <Step title="Iru MCP サーバーのエントリを追加する">
            **`claude_desktop_config.json`** に貼り付けます。強調表示された 3 行に **MCP構成** の値を追加します。**`X-API-Key`** と **`X-MCP-Profile`** を **`env`** に入れます。Claude Desktop の起動時に、**`mcp-remote`** はこれらの値を **`args`** の **`${IRU_X_API_KEY}`** および **`${IRU_X_MCP_PROFILE}`** プレースホルダーに使用します。

            ```json claude_desktop_config.json lines highlight={8,15,16} theme={null}
            {
              "mcpServers": {
                "iru": {
                  "command": "npx",
                  "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools",
                    "--header",
                    "X-API-Key:${IRU_X_API_KEY}",
                    "--header",
                    "X-MCP-Profile:${IRU_X_MCP_PROFILE}"
                  ],
                  "env": {
                    "IRU_X_API_KEY": "sk_live:YOUR_API_KEY",
                    "IRU_X_MCP_PROFILE": "YOUR_PROFILE_ID"
                  }
                }
              }
            }
            ```

            強調表示されたプレースホルダーを置き換えます。

            * **`https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools`** を **MCP構成** の **`url`** に
            * **`sk_live:YOUR_API_KEY`** を **MCP構成** の **`X-API-Key`** に
            * **`YOUR_PROFILE_ID`** を **MCP構成** の **`X-MCP-Profile`** に
          </Step>

          <Step title="既存のファイルにマージする">
            空のファイルから始めた場合は、この手順をスキップしてください。**`mcpServers`** の下にすでに **`preferences`** やその他の設定がある場合、ファイルのセクションは次のようにつながっている必要があります。強調表示された行は、**`mcpServers`** と次のトップレベルキーの間のカンマです。

            ```json claude_desktop_config.json lines highlight={4} theme={null}
                    "IRU_X_MCP_PROFILE": "YOUR_PROFILE_ID"
                  }
                }
              },
              "preferences": {
                "remoteToolsDeviceName": "your-device-name",
                "coworkWebSearchEnabled": true
              }
            }
            ```
          </Step>

          <Step title="ファイルを保存して Claude Desktop を再起動する">
            **`claude_desktop_config.json`** を保存し、Claude Desktop を完全に終了します。ウィンドウを閉じるだけでは不十分です。メニューバーから **Claude → Quit Claude** を選択し、Claude Desktop を再起動します。

            Claude Desktop は起動時に MCP 構成を読み込みます。
          </Step>

          <Step title="接続を確認する">
            Claude Desktop が再び開いたら、**新しいチャット**を開始して次のように質問します。

            ```text theme={null}
            List my Iru devices
            ```

            接続が機能している場合、Claude は Iru MCP サーバーを呼び出し、登録済みデバイスのリストを返します。エラーが表示される場合は、以下の[トラブルシューティング](#troubleshooting)を参照してください。
          </Step>

          <Step title="プロンプトが表示されたらアクセスを承認する">
            Claude は Iru MCP ツールを使用するたびにプロンプトを表示します。その実行のみ許可する場合は **Allow once** を、同様のアクションでプロンプトを減らしたい場合は **Always allow** を選択します。Iru での読み取りや許可された変更を行う場合は承認し、ツールを実行したくない場合は拒否します。
          </Step>

          <Step title="それでも失敗する場合">
            Claude Desktop で **Settings → Developer** を開き、**`iru`** エントリ、サーバーが実行中かどうか、ホストが報告するエラーを確認します。以下の[トラブルシューティング](#troubleshooting)を参照してください。
          </Step>
        </Steps>
      </Tab>

      <Tab title="Windows" icon="microsoft" iconType="brands">
        <Steps>
          <Step title="Claude Desktop をダウンロードしてインストールする">
            Windows 版 Claude Desktop をダウンロードし、アプリをインストールしてサインインします: [Download Claude](https://claude.com/download)。
          </Step>

          <Step title="Claude Desktop の設定を開く">
            Claude Desktop を開き、ハンバーガーメニュー、**File**、**設定** の順に選択します。
          </Step>

          <Step title="Developer 設定を開く">
            **設定** で **Developer** を選択します。
          </Step>

          <Step title="構成ファイルを開く">
            **Developer** で **Edit Config** を選択します。Claude Desktop が **File Explorer** で構成フォルダを開きます。
          </Step>

          <Step title="claude_desktop_config.json を開く">
            そのフォルダにある **`claude_desktop_config.json`** を任意のテキストエディタで開きます。

            <Note>
              新しいファイルには **`{}`** と表示されている場合があります。既存のファイルには、すでに **`mcpServers`**、**`preferences`**、またはその他の設定が含まれている場合があります。その場合は、**`mcpServers`** 内に **`"iru"`** ブロックのみを追加し、残りはそのままにしてください。**`mcpServers`** の閉じ括弧 **`}`** の後、次のトップレベルセクション（例: **`"preferences"`**）の前にカンマを追加します。
            </Note>
          </Step>

          <Step title="Iru MCP サーバーのエントリを追加する">
            **`claude_desktop_config.json`** に貼り付けます。強調表示された 3 行に **MCP構成** の値を追加します。**`X-API-Key`** と **`X-MCP-Profile`** を **`env`** に入れます。Claude Desktop の起動時に、**`mcp-remote`** はこれらの値を **`args`** の **`${IRU_X_API_KEY}`** および **`${IRU_X_MCP_PROFILE}`** プレースホルダーに使用します。

            ```json claude_desktop_config.json lines highlight={8,15,16} theme={null}
            {
              "mcpServers": {
                "iru": {
                  "command": "C:\\Program Files\\nodejs\\npx.cmd",
                  "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools",
                    "--header",
                    "X-API-Key:${IRU_X_API_KEY}",
                    "--header",
                    "X-MCP-Profile:${IRU_X_MCP_PROFILE}"
                  ],
                  "env": {
                    "IRU_X_API_KEY": "sk_live:YOUR_API_KEY",
                    "IRU_X_MCP_PROFILE": "YOUR_PROFILE_ID"
                  }
                }
              }
            }
            ```

            強調表示されたプレースホルダーを置き換えます。

            * **`https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools`** を **MCP構成** の **`url`** に
            * **`sk_live:YOUR_API_KEY`** を **MCP構成** の **`X-API-Key`** に
            * **`YOUR_PROFILE_ID`** を **MCP構成** の **`X-MCP-Profile`** に
          </Step>

          <Step title="既存のファイルにマージする">
            空のファイルから始めた場合は、この手順をスキップしてください。**`mcpServers`** の下にすでに **`preferences`** やその他の設定がある場合、ファイルのセクションは次のようにつながっている必要があります。強調表示された行は、**`mcpServers`** と次のトップレベルキーの間のカンマです。

            ```json claude_desktop_config.json lines highlight={4} theme={null}
                    "IRU_X_MCP_PROFILE": "YOUR_PROFILE_ID"
                  }
                }
              },
              "preferences": {
                "remoteToolsDeviceName": "your-device-name",
                "coworkWebSearchEnabled": true
              }
            }
            ```
          </Step>

          <Step title="ファイルを保存して Claude Desktop を再起動する">
            **`claude_desktop_config.json`** を保存し、Claude Desktop を完全に終了します。ウィンドウを閉じるだけでは不十分です。システムトレイの **Claude** アイコンを右クリックして **Quit** を選択し、Claude Desktop を再起動します。

            Claude Desktop は起動時に MCP 構成を読み込みます。
          </Step>

          <Step title="接続を確認する">
            Claude Desktop が再び開いたら、**新しいチャット**を開始して次のように質問します。

            ```text theme={null}
            List my Iru devices
            ```

            接続が機能している場合、Claude は Iru MCP サーバーを呼び出し、登録済みデバイスのリストを返します。エラーが表示される場合は、以下の[トラブルシューティング](#troubleshooting)を参照してください。
          </Step>

          <Step title="プロンプトが表示されたらアクセスを承認する">
            Claude は Iru MCP ツールを使用するたびにプロンプトを表示します。その実行のみ許可する場合は **Allow once** を、同様のアクションでプロンプトを減らしたい場合は **Always allow** を選択します。Iru での読み取りや許可された変更を行う場合は承認し、ツールを実行したくない場合は拒否します。
          </Step>

          <Step title="それでも失敗する場合">
            Claude Desktop で **Settings → Developer** を開き、**`iru`** エントリ、サーバーが実行中かどうか、ホストが報告するエラーを確認します。MCP サーバーの実行時に、Claude はインストール環境の Claude Desktop アプリデータフォルダ内の **`claude_desktop_config.json`** の隣に **`logs\mcp-server-iru.log`** を書き込む場合もあります。以下の[トラブルシューティング](#troubleshooting)を参照してください。
          </Step>
        </Steps>
      </Tab>
    </Tabs>
  </Tab>

  <Tab title="Cursor" icon="i-cursor" iconType="solid">
    ### Cursor に Iru MCP を追加する

    **Cursor** は、組み込みのアシスタンス機能を使用してソフトウェアを作成・編集するための AI ネイティブなコードエディタです。Cursor デスクトップアプリは **macOS**、**Windows**、**Linux** で利用できます。エディタからテナントのツールを使用できるよう、**Tools & MCP** に Iru を追加します。

    <Steps>
      <Step title="Iru から値を準備する">
        Iru で[トークンと MCP 構成をコピーする](#copy-your-token-and-mcp-configuration)を完了し、**`url`** と **`headers`**（**`X-API-Key`**、**`X-MCP-Profile`**）を用意します。
      </Step>

      <Step title="Cursor をダウンロードしてインストールする">
        お使いのプラットフォーム用の Cursor をダウンロードし、アプリをインストールしてサインインします: [Download Cursor](https://cursor.com/download)。
      </Step>

      <Step title="MCP 設定を開く">
        Cursor の **MCP Settings** を開きます。

        * **macOS:** **Cursor → Settings → Cursor Settings** を選択し、**Tools & MCP** を選択します。
        * **Windows/Linux:** **File → Preferences → Cursor Settings** を選択し、**Tools & MCP** を選択します。
      </Step>

      <Step title="カスタム MCP を追加">
        **Add Custom MCP** を選択します。
      </Step>

      <Step title="MCP 構成を貼り付ける">
        エディタで **`mcp.json`** ファイルが開きます。貼り付け方法は、他の MCP サーバーがすでに定義されているかどうかによって異なります。Cursor は次のようなプレースホルダーから始まります。

        ```json mcp.json lines theme={null}
        {
          "mcpServers": {}
        }
        ```

        <AccordionGroup>
          <Accordion title="新規セットアップ">
            **`mcp.json`** の内容**全体**を、トークン作成時に [MCP 構成をコピーする](#copy-your-token-and-mcp-configuration)でコピーした完全な **MCP構成** に置き換えます。ファイル内のすべて（Cursor のプレースホルダーを含む）を選択して貼り付け、**`mcp.json`** には Iru の JSON **のみ**が残るようにします。**`headers`** 内の **`X-API-Key`** から **`sk_live:`** プレフィックスを削除しないでください。
          </Accordion>

          <Accordion title="既存の MCP サーバー">
            **`mcpServers`** に維持したい他のサーバーがすでに含まれている場合は、**`mcp.json`** ファイル全体を置き換え**ないでください**。**MCP構成** から **`iru`** ブロックのみを追加します。**`"iru": {`** からそのサーバーの閉じ括弧 **`}`**（**`headers`** の後の 2 つ目の **`}`**）までをコピーします。**`iru`** の直前にあるサーバーエントリの閉じ括弧 **`}`** の後にカンマを追加します。**`X-API-Key`** は、スニペットにすでに含まれている **`sk_live:`** プレフィックスも含め、Iru に表示されているとおりに維持してください。

            別のサーバーがすでに構成されている場合の例（強調表示された行は、末尾のカンマと、**`mcp.json`** ファイルにコピーして貼り付ける **`iru`** ブロックを示しています）:

            ```json mcp.json lines highlight={10,11-18} theme={null}
            {
              "mcpServers": {
                "previous-mcp-server": {
                  "url": "https://example.com/mcp",
                  "type": "http",
                  "headers": {
                    "X-API-Key": "sk_live:YOUR_OTHER_KEY",
                    "X-MCP-Profile": "YOUR_OTHER_PROFILE"
                  }
                },
                "iru": {
                  "url": "https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools",
                  "type": "http",
                  "headers": {
                    "X-API-Key": "sk_live:YOUR_API_KEY",
                    "X-MCP-Profile": "YOUR_PROFILE_ID"
                  }
                }
              }
            }
            ```
          </Accordion>
        </AccordionGroup>
      </Step>

      <Step title="構成を保存する">
        Cursor は貼り付け後に **`mcp.json`** を自動保存しません。終了または再起動する前に、ファイルを手動で保存してください。

        * **macOS:** **Command+S**
        * **Windows/Linux:** **Ctrl+S**、または **File → Save**
      </Step>

      <Step title="Cursor を再起動する">
        **Cursor を完全に終了**してから、再度開きます。Cursor は起動時に MCP を読み込みます。
      </Step>

      <Step title="確認する">
        **Tools & MCP** に戻ります。**`iru`** が表示され、トグルが**有効**になっていることを確認します。
      </Step>
    </Steps>

    Cursor での MCP の使用方法の詳細については、[Model Context Protocol (MCP) in Cursor](https://cursor.com/docs/mcp) を参照してください。
  </Tab>

  <Tab title="OpenAI Codex" icon="openai" iconType="brands">
    ### OpenAI Codex に Iru MCP を追加する

    **OpenAI Codex** は、AI を使用してソフトウェアを構築・変更するための OpenAI のコーディングエージェントです。**Codex Desktop App** または VS Code の **Codex** 拡張機能を使用して Iru を MCP サーバーとして登録し、チャットからテナントを操作します。

    <Tabs>
      <Tab title="Desktop App" icon="window-maximize" iconType="solid">
        #### Codex Desktop App

        Codex Desktop App は **macOS** と **Windows** で利用できます。プラットフォームのサポート、インストールオプション（Intel Mac 向けビルドを含む）、その他のアプリ要件については、OpenAI Developers の [Codex アプリのドキュメント](https://developers.openai.com/codex/app)を参照してください。

        <Steps>
          <Step title="Iru から値を準備する">
            Iru で[トークンと MCP 構成をコピーする](#copy-your-token-and-mcp-configuration)を完了し、**`url`** と **`headers`**（**`X-API-Key`**、**`X-MCP-Profile`**）を用意します。
          </Step>

          <Step title="Codex をダウンロードしてインストールする">
            Codex Desktop App をダウンロードしてインストールします: [Codex](https://chatgpt.com/codex/)。
          </Step>

          <Step title="Codex にサインインする">
            Codex を開き、ChatGPT アカウントまたは OpenAI API キーでサインインします。Codex は対象の ChatGPT プランに含まれています。Codex アプリのドキュメントの [Open Codex and sign in](https://developers.openai.com/codex/app) を参照してください。
          </Step>

          <Step title="設定を開く">
            Codex で **設定** に移動します。
          </Step>

          <Step title="MCP servers を開く">
            **MCP servers** を選択します。
          </Step>

          <Step title="サーバーを追加する">
            **+ Add server** を選択します。
          </Step>

          <Step title="名前">
            **名前** に **Iru MCP** と入力します。
          </Step>

          <Step title="トランスポート">
            **Streamable HTTP** を選択します。
          </Step>

          <Step title="URL">
            **URL** に **MCP構成** の **`url`** の値を入力します。
          </Step>

          <Step title="X-API-Key のヘッダー">
            **Headers** で、**Key** を **`X-API-Key`** に、**値** を **MCP構成** の **`headers`** にある **`X-API-Key`** エントリに設定します。スニペットにすでに含まれている **`sk_live:`** プレフィックスも含め、Iru に表示されているとおりに正確にコピーしてください。
          </Step>

          <Step title="X-MCP-Profile のヘッダー">
            **+ Add header** を選択します。**Key** を **`X-MCP-Profile`** に、**値** を **MCP構成** の **`headers`** にある **`X-MCP-Profile`** エントリに設定します。
          </Step>

          <Step title="保存する">
            **保存** を選択します。
          </Step>

          <Step title="Codex を再起動する">
            MCP 設定を再読み込みするため、Codex を完全に終了してから再度開きます。
          </Step>

          <Step title="チャットで Iru を試す">
            **新しいチャット**を開始し、トークンに使用権限がある Enterprise API の領域（デバイスや Blueprints など）について Codex に質問します。
          </Step>
        </Steps>
      </Tab>

      <Tab title="IDE extension" icon="puzzle-piece" iconType="solid">
        #### Codex IDE 拡張機能

        **Codex IDE 拡張機能**は、OpenAI のコーディングエージェントをエディタ内で実行します。拡張機能の MCP 設定から Iru を追加します。

        <Steps>
          <Step title="Iru から値を準備する">
            Iru で[トークンと MCP 構成をコピーする](#copy-your-token-and-mcp-configuration)を完了し、**`url`** と **`headers`**（**`X-API-Key`**、**`X-MCP-Profile`**）を用意します。
          </Step>

          <Step title="Visual Studio Code をインストールする">
            必要に応じて [Visual Studio Code](https://code.visualstudio.com/) をインストールします。VS Code は **macOS**、**Windows**、**Linux** をサポートしています。
          </Step>

          <Step title="Codex 拡張機能をインストールする">
            Visual Studio Marketplace から [Codex 拡張機能](https://marketplace.visualstudio.com/items?itemName=openai.chatgpt)をインストールします。この拡張機能は、他の VS Code 互換エディタ（Cursor など）でも動作しますが、メニューやプラットフォームのサポートが異なる場合があります。インストールオプションについては、[Codex IDE 拡張機能](https://developers.openai.com/codex/ide)のドキュメントを参照してください。
          </Step>

          <Step title="Codex サイドバーを開く">
            アクティビティバーの <Icon icon="openai" iconType="brands" size={14} style={{ display: 'inline-flex', verticalAlign: 'middle' }} /> OpenAI ロゴ、**Open Codex Sidebar**、またはセカンダリサイドバーを切り替えて **Codex** タブを選択することで、Codex サイドバーを開きます。
          </Step>

          <Step title="サインインしてセットアップを完了する">
            **Sign in with ChatGPT** を選択して認証します。Codex は対象の ChatGPT プランに含まれています。プロンプトに従ってセットアップを完了します。
          </Step>

          <Step title="Codex の設定を開く">
            Codex サイドバーで**歯車**アイコンを選択し、**Codex settings** を選択します。
          </Step>

          <Step title="MCP servers を開く">
            **MCP servers** を選択します。
          </Step>

          <Step title="サーバーを追加する">
            **+ Add server** を選択します。
          </Step>

          <Step title="名前">
            **名前** に **Iru MCP** と入力します。
          </Step>

          <Step title="トランスポート">
            **Streamable HTTP** を選択します。
          </Step>

          <Step title="URL">
            **URL** に **MCP構成** の **`url`** の値を入力します。
          </Step>

          <Step title="X-API-Key のヘッダー">
            **Headers** で、**Key** を **`X-API-Key`** に、**値** を **MCP構成** の **`headers`** にある **`X-API-Key`** エントリに設定します。スニペットにすでに含まれている **`sk_live:`** プレフィックスも含め、Iru に表示されているとおりに正確にコピーしてください。
          </Step>

          <Step title="X-MCP-Profile のヘッダー">
            **+ Add header** を選択します。**Key** を **`X-MCP-Profile`** に、**値** を **MCP構成** の **`headers`** にある **`X-MCP-Profile`** エントリに設定します。
          </Step>

          <Step title="保存する">
            **保存** を選択します。
          </Step>

          <Step title="拡張機能を再起動する">
            Codex に **Restart extension** と表示された場合は、それを選択して MCP 設定を再読み込みします。
          </Step>

          <Step title="チャットで Iru を試す">
            **Codex** サイドバーで会話を開始し、トークンに使用権限がある Enterprise API の領域（デバイスや Blueprints など）について質問します。
          </Step>
        </Steps>
      </Tab>
    </Tabs>
  </Tab>
</Tabs>

### トラブルシューティング

MCP 全般のヘルプ（ログの場所、構成の確認、MCP Inspector、以下の Iru 固有の注意事項以外のクライアントのデバッグ）については、[Model Context Protocol デバッグガイド](https://modelcontextprotocol.io/docs/tools/debugging)を参照してください。

<AccordionGroup>
  <Accordion title="Iru MCP 全般" icon="layer-group">
    <AccordionGroup>
      <Accordion title="アシスタントがトークンが無効、または認証に失敗したと報告する" icon="key">
        **MCP構成** の **`url`** と **`headers`**（**`X-API-Key`**、**`X-MCP-Profile`**）を再確認してください。余分なスペースを削除します。**`X-API-Key`** は、スニペットにすでに含まれている **`sk_live:`** プレフィックスを含め、Iru の完全な値と一致している必要があります。基になるトークンがローテーションまたは取り消された場合は、新しいトークンを作成してすべてのクライアントを更新してください。
      </Accordion>

      <Accordion title="ツールが表示されない、またはアシスタントが権限拒否を報告する" icon="shield-halved">
        トークンの Enterprise API スコープによって、それらの操作がブロックされている可能性があります。**アクセス** でトークンの API 権限を編集するか、必要なスコープを持つ新しいトークンを作成してください。
      </Accordion>

      <Accordion title="Iru では構成が正しく見えるが、クライアントが失敗し続ける" icon="arrow-rotate-right">
        クライアントの **MCP構成** が Iru の **`url`** と **`headers`** と一致していることを確認し、ホストアプリを完全に終了して再起動し、MCP 設定を再読み込みしてください。問題が解決しない場合は、[Model Context Protocol デバッグガイド](https://modelcontextprotocol.io/docs/tools/debugging)を使用して、ホストのログ、JSON の検証、MCP Inspector でのテストを行ってください。
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="Claude Desktop" icon="desktop" iconType="solid">
    <AccordionGroup>
      <Accordion title="リモートコネクタまたはネットワークのエラー（カスタム MCP URL）" icon="globe">
        カスタムコネクタは、Anthropic のインフラストラクチャから MCP サーバーにアクセスします。**MCP構成** の **`url`** が正しいこと、サービスがパブリックインターネット上にあること、企業のファイアウォールが Anthropic の IP 範囲を許可していることを確認してください。[開始する with custom connectors using remote MCP](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) および [Anthropic IP addresses](https://platform.claude.com/docs/en/api/ip-addresses) を参照してください。
      </Accordion>

      <Accordion title="iru エントリを確認する、またはホストのエラーを読む" icon="wrench">
        Claude Desktop で **設定** を開き、**Developer** を選択します。ここで **`iru`** サーバーの構成を確認し、サーバーが実行中かどうかを確認し、ホストが報告するエラーを読むことができます。Claude のログパス、DevTools、関連する手順については、[Model Context Protocol デバッグガイド](https://modelcontextprotocol.io/docs/tools/debugging)の **Debugging in Claude Desktop** を参照してください。
      </Accordion>

      <Accordion title="mcp-remote@latest で Iru MCP に接続できない" icon="code-branch">
        最新の **mcp-remote** パッケージを使用し続けるため、**`args`** では **`mcp-remote@latest`** を使用してください。接続が失敗する場合は、一時的にその値を以前のバージョン（例: **`mcp-remote@0.1.13`**）に変更し、**`claude_desktop_config.json`** を保存してから、Claude Desktop を完全に終了して再度開きます。可能になったら **`mcp-remote@latest`** に戻してください。この失敗が発生した場合、問題は Iru ではなく **mcp-remote** にあります。
      </Accordion>

      <Accordion title="stdio ブリッジ（npx / mcp-remote）または構成ファイルのセットアップ" icon="terminal">
        **Node.js 20 以降**がインストールされていることを確認し、**`claude_desktop_config.json`** を開いて、**`iru`** エントリの **`args`** 内の MCP URL と **`env`** の値が、**MCP構成** の **`url`**、**`X-API-Key`**、**`X-MCP-Profile`** と一致していることを確認します（**`IRU_X_API_KEY`** には **`sk_live:`** プレフィックスが含まれている必要があります）。**`--header`** の行は、生のキーやプロファイルではなく、引き続き **`${IRU_X_API_KEY}`** と **`${IRU_X_MCP_PROFILE}`** を使用している必要があります。macOS では **`command`** は **`npx`** である必要があります。Windows では完全パス **`C:\Program Files\nodejs\npx.cmd`** を使用します。ファイルを保存し、Claude Desktop を**完全に終了**（macOS では **Claude → Quit Claude**、Windows ではトレイの **Quit**）してから再度開きます。Windows で **`iru`** が引き続き失敗する場合は、**`claude_desktop_config.json`** の隣にある **`logs\mcp-server-iru.log`** を確認してください。[Claude Desktop に Iru MCP を追加する](#claude-desktop)を参照してください。
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="Cursor" icon="i-cursor" iconType="solid">
    <AccordionGroup>
      <Accordion title="設定の編集後に MCP が読み込まれない、または iru がオフのままになる" icon="arrow-rotate-right">
        **Cursor を完全に終了**してから再度開きます。Cursor は起動時に MCP を読み込みます。**`mcp.json`** が引き続き読み込まれない場合は、JSON が有効であることを確認してください。新規セットアップの場合は、ファイル**全体**を **MCP構成** に置き換えたことを確認します。既存のサーバーにマージした場合は、**`iru`** ブロックとカンマが正しいことを確認します。**`url`**、**`X-API-Key`**、**`X-MCP-Profile`** が **MCP構成** と一致していることを確認してください（[Cursor に Iru MCP を追加する](#cursor)を参照）。**`X-API-Key`** には、スニペットにすでに含まれている **`sk_live:`** プレフィックスが含まれている必要があります。ホストのより深い問題については、[Model Context Protocol デバッグガイド](https://modelcontextprotocol.io/docs/tools/debugging)を参照してください。
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="OpenAI Codex" icon="openai" iconType="brands">
    <AccordionGroup>
      <Accordion title="Add a project to use Codex（IDE 拡張機能）" icon="folder-open">
        チャット時に Codex に **Add a project to use Codex** と表示される場合は、まずエディタでプロジェクトフォルダを開くか作成してから、**Codex** サイドバーに戻ってください。
      </Accordion>

      <Accordion title="Codex: config.toml を直接編集する" icon="file-code">
        UI で MCP 設定を保存または変更できない場合は、**`~/.codex/config.toml`** を直接編集します。[Model Context Protocol in Codex](https://developers.openai.com/codex/mcp) によると、CLI、**Codex IDE 拡張機能**、**Codex Desktop App** はこのファイルを共有しています。UI でのセットアップ手順については、[Codex IDE 拡張機能](#ide-extension)または [Codex Desktop App](#desktop-app) を参照してください。

        テキストエディタで **`~/.codex/config.toml`** を開きます。**`~`** はホームフォルダです（例: macOS では **`/Users/your-user-name/.codex/config.toml`**）。

        **MCP構成** の **`url`** と **`http_headers`** を、Iru に表示されているとおりに正確にコピーして設定します。**`http_headers`** の **`X-API-Key`** の値には、スニペットにすでに含まれている **`sk_live:`** プレフィックスが含まれます。サーバー名には **Iru MCP** を使用します。**`config.toml`** では、**`mcp_servers.`** の後のテーブル名が、Codex がそのサーバーを保存した名前と一致している必要があります（多くの場合 **Iru MCP** から派生した **`iru_mcp`** など）。

        **Iru MCP** の例:

        ```toml config.toml lines theme={null}
        [mcp_servers.iru_mcp]
        enabled = true
        url = "https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools"
        http_headers = { "X-API-Key" = "sk_live:YOUR_API_KEY", "X-MCP-Profile" = "YOUR_PROFILE_ID" }
        ```

        ファイルを保存し、Codex を**完全に終了**するかエディタを再起動して、MCP 設定を再読み込みします。
      </Accordion>

      <Accordion title="MCP サーバーに接続できない、またはツールがオフラインのままになる" icon="arrow-rotate-right">
        Codex の MCP 設定で **Iru MCP** が有効になっていること、**`url`** と **`headers`** が **MCP構成** と一致していること（**`X-API-Key`** には、スニペットにすでに含まれている **`sk_live:`** プレフィックスが含まれている必要があります）を確認し、ホストアプリを**完全に終了**して再度開き、Codex に MCP を再読み込みさせます。**Codex IDE 拡張機能**の場合はエディタを終了し、**Codex Desktop App** の場合は Codex を完全に終了します。トランスポートレベルのデバッグについては、[Model Context Protocol デバッグガイド](https://modelcontextprotocol.io/docs/tools/debugging)を参照してください。
      </Accordion>
    </AccordionGroup>
  </Accordion>
</AccordionGroup>

### 関連記事

<CardGroup cols={2}>
  <Card title="Iru API の概要" icon="file-lines" href="/en/endpoint/api/iru-api-overview">
    MCP がツールとして公開する Enterprise API の REST API、トークン、権限、Activity。
  </Card>

  <Card title="Postman で Iru Endpoint API を設定する方法" icon="flask" href="/en/endpoint/api/how-to-set-up-the-iru-endpoint-api-in-postman">
    公開されたコレクションをインポートし、MCP 以外から認証済みリクエストを送信します。
  </Card>

  <Card title="Iru Endpoint Management API リファレンス" icon="book" href="https://api-docs.kandji.io">
    基盤となる API のエンドポイント、パラメータ、リクエストとレスポンスの例を参照します。
  </Card>

  <Card title="Iru Endpoint API を使用したサードパーティアプリの連携" icon="plug" href="/ja/endpoint/integrations/overview/integrating-third-party-apps-using-the-iru-endpoint-api">
    サードパーティ製品を接続し、各連携に必要な API 権限をマッピングします。
  </Card>
</CardGroup>