Iru MCP

はじめに

**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 を通じて利用できるようになります。

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

REST の使用方法（MCP 以外での HTTP API とベアラートークン）については、Iru API の概要を参照してください。

開始する前に

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

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

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

アクセスを開く

サイドバーで アカウントメニューボタン を選択し、アクセス を選択します。

APIトークンタブを開く

アクセス で APIトークン タブを選択します。

新しい API トークンを作成する

Add Token を選択して新しい API トークンを作成します。

トークンの詳細を構成する

API トークンの名前と説明を入力します。

MCP を有効にする

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

トークンを作成する

作成を選択します。

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

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

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

API トークンをコピーする（MCP 以外の API 使用時のみ・オプション）

REST またはカスタムスクリプトの場合は、成功画面の API token の横にある コピー を使用します。この値は MCP には使用されません。

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 ヘッダーとして送信されます。

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

プレースホルダーの例:

mcp.json

{
  "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"
      }
    }
  }
}

確認チェックボックスを選択する

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

次へを選択する

次へを選択します。

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

API 権限を構成する

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

今すぐ構成するかスキップする

次のいずれかを選択します。

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

エンドポイントを選択する（構成を選択した場合）

構成を選択した場合は、権限リストを使用してこのトークンで実行できる操作を選択します。

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

保存する

完了したら、保存を選択します。

確認する

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

後で権限を構成する（スキップした場合）

権限の設定をスキップした場合は、後でトークンを開いて編集を選択し、権限を選んで保存を選択することで構成できます。

API トークンを取り消す

他の API トークンと同様に、アクセス でトークンを取り消します。手順と アクティビティ に関する注意事項については、Iru API の概要の トークンの取り消し を参照してください。

考慮事項

シークレットの 1 回限りの表示

コピー で取得する REST API トークンと MCP構成 の JSON は、いずれも作成時の成功画面に 1 回だけ表示されます。

取り消しはすべてに影響する

トークンを取り消すと、そのトークンに依存していた API アクセスと MCP アクセスが停止します。

破壊的なアクション

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

ページネーション

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

クライアント固有の構成

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

ベストプラクティス

最小権限を使用する

自動化に必要な Enterprise API スコープのみを持つトークンを作成し、そのトークンで MCP を有効にします。

チームやユースケースごとにトークンを分ける

たとえば、レポート用のアシスタントには読み取り中心のトークンを、修復ワークフローにはより範囲を絞った運用トークンを使用します。

疑わしい場合はローテーションする

MCP構成 が漏洩した場合は、Iru でトークンを取り消して新しいトークンを発行し、古い url または headers の値を保持しているすべての MCP クライアントを更新します。

ローカルの構成ファイルを保護する

claude_desktop_config.json には url とヘッダーの値が含まれています。ソース管理にコミットしたり、チャットログで共有したりしないでください。

MCP と API のシークレットを保護する

MCP構成 と、MCP 以外の用途で コピー した REST トークンはシークレットとして扱ってください。チャットログやスクリーンショットではなく、パスワードマネージャーまたは安全な保管庫に保存してください。

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

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

Claude Desktop
Cursor
OpenAI Codex

Claude Desktop に Iru MCP を追加する

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

前提条件

Iru でトークンと MCP 構成をコピーするを完了し、url と headers（X-API-Key、X-MCP-Profile）を用意します。
nodejs.org から Node.js 20 以降をインストールします。インストーラーには npx が含まれており、Claude Desktop はこれを使用して Iru MCP 接続を実行します。

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

macOS
Windows

Claude Desktop をダウンロードしてインストールする

macOS 版 Claude Desktop をダウンロードし、アプリをインストールしてサインインします: Download Claude。

Claude Desktop の設定を開く

Claude Desktop を開き、メニューバーから Claude → Settings を選択します。

Developer 設定を開く

設定で Developer を選択します。

構成ファイルを開く

Developer で Edit Config を選択します。Claude Desktop が Finder で構成フォルダを開きます。

claude_desktop_config.json を開く

そのフォルダにある claude_desktop_config.json を任意のテキストエディタで開きます。

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

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} プレースホルダーに使用します。

claude_desktop_config.json

{
  "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 に

既存のファイルにマージする

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

claude_desktop_config.json

        "IRU_X_MCP_PROFILE": "YOUR_PROFILE_ID"
      }
    }
  },
  "preferences": {
    "remoteToolsDeviceName": "your-device-name",
    "coworkWebSearchEnabled": true
  }
}

ファイルを保存して Claude Desktop を再起動する

claude_desktop_config.json を保存し、Claude Desktop を完全に終了します。ウィンドウを閉じるだけでは不十分です。メニューバーから Claude → Quit Claude を選択し、Claude Desktop を再起動します。Claude Desktop は起動時に MCP 構成を読み込みます。

接続を確認する

Claude Desktop が再び開いたら、新しいチャットを開始して次のように質問します。

List my Iru devices

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

プロンプトが表示されたらアクセスを承認する

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

それでも失敗する場合

Claude Desktop で Settings → Developer を開き、iru エントリ、サーバーが実行中かどうか、ホストが報告するエラーを確認します。以下のトラブルシューティングを参照してください。

Claude Desktop をダウンロードしてインストールする

Windows 版 Claude Desktop をダウンロードし、アプリをインストールしてサインインします: Download Claude。

Claude Desktop の設定を開く

Claude Desktop を開き、ハンバーガーメニュー、File、設定の順に選択します。

Developer 設定を開く

設定で Developer を選択します。

構成ファイルを開く

Developer で Edit Config を選択します。Claude Desktop が File Explorer で構成フォルダを開きます。

claude_desktop_config.json を開く

そのフォルダにある claude_desktop_config.json を任意のテキストエディタで開きます。

Iru MCP サーバーのエントリを追加する

claude_desktop_config.json

{
  "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 に

既存のファイルにマージする

claude_desktop_config.json

        "IRU_X_MCP_PROFILE": "YOUR_PROFILE_ID"
      }
    }
  },
  "preferences": {
    "remoteToolsDeviceName": "your-device-name",
    "coworkWebSearchEnabled": true
  }
}

ファイルを保存して Claude Desktop を再起動する

claude_desktop_config.json を保存し、Claude Desktop を完全に終了します。ウィンドウを閉じるだけでは不十分です。システムトレイの Claude アイコンを右クリックして Quit を選択し、Claude Desktop を再起動します。Claude Desktop は起動時に MCP 構成を読み込みます。

接続を確認する

Claude Desktop が再び開いたら、新しいチャットを開始して次のように質問します。

List my Iru devices

プロンプトが表示されたらアクセスを承認する

それでも失敗する場合

Claude Desktop で Settings → Developer を開き、iru エントリ、サーバーが実行中かどうか、ホストが報告するエラーを確認します。MCP サーバーの実行時に、Claude はインストール環境の Claude Desktop アプリデータフォルダ内の claude_desktop_config.json の隣に logs\mcp-server-iru.log を書き込む場合もあります。以下のトラブルシューティングを参照してください。

Cursor に Iru MCP を追加する

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

Iru から値を準備する

Iru でトークンと MCP 構成をコピーするを完了し、url と headers（X-API-Key、X-MCP-Profile）を用意します。

Cursor をダウンロードしてインストールする

お使いのプラットフォーム用の Cursor をダウンロードし、アプリをインストールしてサインインします: Download Cursor。

MCP 設定を開く

Cursor の MCP Settings を開きます。

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

カスタム MCP を追加

Add Custom MCP を選択します。

MCP 構成を貼り付ける

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

mcp.json

{
  "mcpServers": {}
}

新規セットアップ

mcp.json の内容全体を、トークン作成時に MCP 構成をコピーするでコピーした完全な MCP構成 に置き換えます。ファイル内のすべて（Cursor のプレースホルダーを含む）を選択して貼り付け、mcp.json には Iru の JSON のみが残るようにします。headers 内の X-API-Key から sk_live: プレフィックスを削除しないでください。

既存の MCP サーバー

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

mcp.json

{
  "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"
      }
    }
  }
}

構成を保存する

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

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

Cursor を再起動する

Cursor を完全に終了してから、再度開きます。Cursor は起動時に MCP を読み込みます。

確認する

Tools & MCP に戻ります。iru が表示され、トグルが有効になっていることを確認します。

Cursor での MCP の使用方法の詳細については、Model Context Protocol (MCP) in Cursor を参照してください。

OpenAI Codex に Iru MCP を追加する

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

Desktop App
IDE extension

Codex Desktop App

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

Iru から値を準備する

Iru でトークンと MCP 構成をコピーするを完了し、url と headers（X-API-Key、X-MCP-Profile）を用意します。

Codex をダウンロードしてインストールする

Codex Desktop App をダウンロードしてインストールします: Codex。

Codex にサインインする

Codex を開き、ChatGPT アカウントまたは OpenAI API キーでサインインします。Codex は対象の ChatGPT プランに含まれています。Codex アプリのドキュメントの Open Codex and sign in を参照してください。

設定を開く

Codex で設定に移動します。

MCP servers を開く

MCP servers を選択します。

サーバーを追加する

+ Add server を選択します。

名前

名前に Iru MCP と入力します。

トランスポート

Streamable HTTP を選択します。

URL

URL に MCP構成 の url の値を入力します。

X-API-Key のヘッダー

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

X-MCP-Profile のヘッダー

+ Add header を選択します。Key を X-MCP-Profile に、値を MCP構成 の headers にある X-MCP-Profile エントリに設定します。

保存する

保存を選択します。

Codex を再起動する

MCP 設定を再読み込みするため、Codex を完全に終了してから再度開きます。

チャットで Iru を試す

新しいチャットを開始し、トークンに使用権限がある Enterprise API の領域（デバイスや Blueprints など）について Codex に質問します。

Codex IDE 拡張機能

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

Iru から値を準備する

Iru でトークンと MCP 構成をコピーするを完了し、url と headers（X-API-Key、X-MCP-Profile）を用意します。

Visual Studio Code をインストールする

必要に応じて Visual Studio Code をインストールします。VS Code は macOS、Windows、Linux をサポートしています。

Codex 拡張機能をインストールする

Visual Studio Marketplace から Codex 拡張機能をインストールします。この拡張機能は、他の VS Code 互換エディタ（Cursor など）でも動作しますが、メニューやプラットフォームのサポートが異なる場合があります。インストールオプションについては、Codex IDE 拡張機能のドキュメントを参照してください。

Codex サイドバーを開く

アクティビティバーの OpenAI ロゴ、Open Codex Sidebar、またはセカンダリサイドバーを切り替えて Codex タブを選択することで、Codex サイドバーを開きます。

サインインしてセットアップを完了する

Sign in with ChatGPT を選択して認証します。Codex は対象の ChatGPT プランに含まれています。プロンプトに従ってセットアップを完了します。

Codex の設定を開く

Codex サイドバーで歯車アイコンを選択し、Codex settings を選択します。

MCP servers を開く

MCP servers を選択します。

サーバーを追加する

+ Add server を選択します。

名前

名前に Iru MCP と入力します。

トランスポート

Streamable HTTP を選択します。

URL

URL に MCP構成 の url の値を入力します。

X-API-Key のヘッダー

X-MCP-Profile のヘッダー

+ Add header を選択します。Key を X-MCP-Profile に、値を MCP構成 の headers にある X-MCP-Profile エントリに設定します。

保存する

保存を選択します。

拡張機能を再起動する

Codex に Restart extension と表示された場合は、それを選択して MCP 設定を再読み込みします。

チャットで Iru を試す

Codex サイドバーで会話を開始し、トークンに使用権限がある Enterprise API の領域（デバイスや Blueprints など）について質問します。

トラブルシューティング

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

Iru MCP 全般

アシスタントがトークンが無効、または認証に失敗したと報告する

MCP構成 の url と headers（X-API-Key、X-MCP-Profile）を再確認してください。余分なスペースを削除します。X-API-Key は、スニペットにすでに含まれている sk_live: プレフィックスを含め、Iru の完全な値と一致している必要があります。基になるトークンがローテーションまたは取り消された場合は、新しいトークンを作成してすべてのクライアントを更新してください。

ツールが表示されない、またはアシスタントが権限拒否を報告する

トークンの Enterprise API スコープによって、それらの操作がブロックされている可能性があります。アクセス でトークンの API 権限を編集するか、必要なスコープを持つ新しいトークンを作成してください。

Iru では構成が正しく見えるが、クライアントが失敗し続ける

クライアントの MCP構成 が Iru の url と headers と一致していることを確認し、ホストアプリを完全に終了して再起動し、MCP 設定を再読み込みしてください。問題が解決しない場合は、Model Context Protocol デバッグガイドを使用して、ホストのログ、JSON の検証、MCP Inspector でのテストを行ってください。

Claude Desktop

リモートコネクタまたはネットワークのエラー（カスタム MCP URL）

カスタムコネクタは、Anthropic のインフラストラクチャから MCP サーバーにアクセスします。MCP構成 の url が正しいこと、サービスがパブリックインターネット上にあること、企業のファイアウォールが Anthropic の IP 範囲を許可していることを確認してください。開始する with custom connectors using remote MCP および Anthropic IP addresses を参照してください。

iru エントリを確認する、またはホストのエラーを読む

Claude Desktop で設定を開き、Developer を選択します。ここで iru サーバーの構成を確認し、サーバーが実行中かどうかを確認し、ホストが報告するエラーを読むことができます。Claude のログパス、DevTools、関連する手順については、Model Context Protocol デバッグガイドの Debugging in Claude Desktop を参照してください。

mcp-remote@latest で Iru MCP に接続できない

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

stdio ブリッジ（npx / mcp-remote）または構成ファイルのセットアップ

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 を追加するを参照してください。

Cursor

設定の編集後に MCP が読み込まれない、または iru がオフのままになる

Cursor を完全に終了してから再度開きます。Cursor は起動時に MCP を読み込みます。mcp.json が引き続き読み込まれない場合は、JSON が有効であることを確認してください。新規セットアップの場合は、ファイル全体を MCP構成 に置き換えたことを確認します。既存のサーバーにマージした場合は、iru ブロックとカンマが正しいことを確認します。url、X-API-Key、X-MCP-Profile が MCP構成 と一致していることを確認してください（Cursor に Iru MCP を追加するを参照）。X-API-Key には、スニペットにすでに含まれている sk_live: プレフィックスが含まれている必要があります。ホストのより深い問題については、Model Context Protocol デバッグガイドを参照してください。

OpenAI Codex

Add a project to use Codex（IDE 拡張機能）

チャット時に Codex に Add a project to use Codex と表示される場合は、まずエディタでプロジェクトフォルダを開くか作成してから、Codex サイドバーに戻ってください。

Codex: config.toml を直接編集する

UI で MCP 設定を保存または変更できない場合は、~/.codex/config.toml を直接編集します。Model Context Protocol in Codex によると、CLI、Codex IDE 拡張機能、Codex Desktop App はこのファイルを共有しています。UI でのセットアップ手順については、Codex IDE 拡張機能または Codex 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 の例:

config.toml

[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 設定を再読み込みします。

MCP サーバーに接続できない、またはツールがオフラインのままになる

Codex の MCP 設定で Iru MCP が有効になっていること、url と headers が MCP構成 と一致していること（X-API-Key には、スニペットにすでに含まれている sk_live: プレフィックスが含まれている必要があります）を確認し、ホストアプリを完全に終了して再度開き、Codex に MCP を再読み込みさせます。Codex IDE 拡張機能の場合はエディタを終了し、Codex Desktop App の場合は Codex を完全に終了します。トランスポートレベルのデバッグについては、Model Context Protocol デバッグガイドを参照してください。

Iru API の概要

MCP がツールとして公開する Enterprise API の REST API、トークン、権限、Activity。

Postman で Iru Endpoint API を設定する方法

公開されたコレクションをインポートし、MCP 以外から認証済みリクエストを送信します。

Iru Endpoint Management API リファレンス

基盤となる API のエンドポイント、パラメータ、リクエストとレスポンスの例を参照します。

Iru Endpoint API を使用したサードパーティアプリの連携

サードパーティ製品を接続し、各連携に必要な API 権限をマッピングします。

はじめに

デバイス

エージェント

Blueprints

登録

Library

導入ガイド

設定

連携

Endpoint Detection & Response

脆弱性管理

はじめに

開始する前に

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

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

API 権限を構成する

API トークンを取り消す

考慮事項

ベストプラクティス

最小権限を使用する

チームやユースケースごとにトークンを分ける

疑わしい場合はローテーションする

ローカルの構成ファイルを保護する

MCP と API のシークレットを保護する

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

Claude Desktop に Iru MCP を追加する

前提条件

Cursor に Iru MCP を追加する

OpenAI Codex に Iru MCP を追加する

Codex Desktop App

Codex IDE 拡張機能

トラブルシューティング

関連記事

Iru API の概要

Postman で Iru Endpoint API を設定する方法

Iru Endpoint Management API リファレンス

Iru Endpoint API を使用したサードパーティアプリの連携

​はじめに

​開始する前に

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

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

​API 権限を構成する

​API トークンを取り消す

​考慮事項

​ベストプラクティス

最小権限を使用する

チームやユースケースごとにトークンを分ける

疑わしい場合はローテーションする

ローカルの構成ファイルを保護する

MCP と API のシークレットを保護する

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

​Claude Desktop に Iru MCP を追加する

​前提条件

​Cursor に Iru MCP を追加する

​OpenAI Codex に Iru MCP を追加する

​Codex Desktop App

​Codex IDE 拡張機能

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

​関連記事

Iru API の概要

Postman で Iru Endpoint API を設定する方法

Iru Endpoint Management API リファレンス

Iru Endpoint API を使用したサードパーティアプリの連携

はじめに

開始する前に

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

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

API 権限を構成する

API トークンを取り消す

考慮事項

ベストプラクティス

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

Claude Desktop に Iru MCP を追加する

前提条件

Cursor に Iru MCP を追加する

OpenAI Codex に Iru MCP を追加する

Codex Desktop App

Codex IDE 拡張機能

トラブルシューティング

関連記事