Iru MCP

소개

**MCP(Model Context Protocol)**는 클라이언트 애플리케이션(호스트)을 MCP 서버에 연결하기 위한 개방형 표준입니다. 서버는 도구, 리소스, 프롬프트를 제공하므로 AI 어시스턴트가 추가하는 모든 어시스턴트나 워크플로마다 별도의 사용자 지정 통합을 구축하고 유지 관리하는 대신, 하나의 일관된 패턴으로 환경에서 허용된 작업을 수행할 수 있습니다. Iru MCP(Model Context Protocol) 서버는 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는 고객당 시간당 10,000건의 요청을 적용합니다. MCP 호출은 해당 토큰의 MCP 구성에 있는 headers 아래의 X-API-Key 값으로 인증되며, 직접 REST 사용 및 기타 통합과 함께 동일한 테넌트 시간당 제한에 포함됩니다. 테넌트의 모든 API 토큰은 이 제한을 공유합니다. 배경 정보와 문제 해결은 Iru API 개요의 고려 사항 및 Iru Endpoint Management API 문서를 참조하십시오.

토큰 및 MCP 구성 복사

토큰을 생성하면 Iru에 **토큰이 생성되었습니다.**라는 일회성 성공 화면이 표시됩니다. 필요한 항목을 복사하여 안전하게 보관하십시오. 이 정보는 다시 볼 수 없습니다. 아래 단계를 순서대로 실행하십시오. 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 개요의 **토큰 해지**를 참조하십시오.

고려 사항

일회성 비밀 표시

복사의 REST API 토큰과 MCP 구성 JSON은 생성 시 성공 화면에 각각 한 번만 표시됩니다.

해지는 전체에 적용됨

토큰을 해지하면 해당 토큰에 의존하는 API 및 MCP 액세스가 중지됩니다.

파괴적 작업

파괴적 작업(예: 지우기, 삭제, 잠금)의 경우 해당 작업을 MCP 허용 목록에 추가하지 않았다면 어시스턴트가 실행하기 전에 영향을 요약하고 명시적인 승인을 요구해야 합니다. 조직의 변경 관리 규칙을 따르십시오.

페이지 매김

큰 목록 응답은 페이지로 나뉩니다. 모든 행을 채팅으로 가져오지 않고 전체 데이터 세트가 필요한 경우 어시스턴트에게 필터를 세분화하거나, 다음 페이지로 이동하거나, 내보내도록 요청하십시오.

클라이언트별 구성

MCP 구성은 url, type, **headers**가 포함된 JSON입니다. **headers**에는 **X-API-Key**와 **X-MCP-Profile**이 있으며, Iru는 각 MCP 요청에서 이 두 값을 함께 요구합니다. 클라이언트가 **url**을 가리키도록 하고 두 헤더 값을 변경 없이 전달하십시오. 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+**를 설치하십시오. 설치 프로그램에는 Claude Desktop이 Iru MCP 연결을 실행하는 데 사용하는 **npx**가 포함되어 있습니다.

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**에 붙여 넣으십시오. 강조 표시된 세 줄에 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이 파일 탐색기에서 구성 폴더를 엽니다.

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가 Iru MCP 서버를 호출하여 등록된 기기 목록을 반환합니다. 오류가 표시되면 아래의 문제 해결을 참조하십시오.

메시지가 표시되면 액세스 승인

여전히 실패하는 경우

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 뒤의 두 번째 })까지 복사하십시오. iru 바로 앞에 오는 서버 항목의 닫는 } 뒤에 쉼표를 추가하십시오. 스니펫에 이미 포함된 sk_live: 접두사를 포함하여 **X-API-Key**를 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 app documentation을 참조하십시오.

Iru에서 값 준비

Iru에서 토큰 및 MCP 구성 복사를 완료하여 url 및 headers(X-API-Key, X-MCP-Profile)를 준비하십시오.

Codex 다운로드 및 설치

Codex Desktop App을 다운로드하여 설치하십시오: Codex.

Codex에 로그인

Codex를 열고 ChatGPT 계정 또는 OpenAI API 키로 로그인하십시오. Codex는 해당하는 ChatGPT 요금제에 포함되어 있습니다. Codex app documentation의 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 extension

Codex IDE extension은 편집기에서 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 extension을 설치하십시오. 이 확장은 다른 VS Code 호환 편집기(예: Cursor)에서도 작동하지만 메뉴와 플랫폼 지원은 다를 수 있습니다. 설치 옵션은 Codex IDE extension 문서를 참조하십시오.

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 debugging guide를 참조하십시오.

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 설정을 다시 로드하도록 호스트 앱을 완전히 종료하고 다시 시작하십시오. 문제가 지속되면 호스트 로그, JSON 검증, MCP Inspector 테스트에 대해 Model Context Protocol debugging guide를 사용하십시오.

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 guide의 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**을 열고 **args**에 있는 iru 항목의 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 debugging guide를 참조하십시오.

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 extension, Codex Desktop App이 이 파일을 공유합니다. UI 설정 흐름은 Codex IDE extension 또는 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" }

파일을 저장한 다음 MCP 설정이 다시 로드되도록 Codex를 완전히 종료하거나 편집기를 다시 시작하십시오.

MCP 서버가 연결되지 않거나 도구가 오프라인 상태로 유지됨

Codex MCP 설정에서 Iru MCP가 활성화되어 있고 url 및 **headers가 MCP 구성과 일치하는지 확인한 다음(X-API-Key**에는 스니펫에 이미 포함된 sk_live: 접두사가 포함되어야 함), Codex가 MCP를 다시 로드하도록 호스트 앱을 완전히 종료했다가 다시 여십시오. Codex IDE extension의 경우 편집기를 종료하는 것을 의미하며, Codex Desktop App의 경우 Codex를 완전히 종료하십시오. 전송 수준 디버깅은 Model Context Protocol debugging guide를 참조하십시오.

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 extension

문제 해결

관련 문서

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 extension

​문제 해결

​관련 문서

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 extension

문제 해결

관련 문서