IDrive^® e2 셀프 호스팅 MCP 와 Codex

IDrive^® e2 MCP는 개방형 Model Context Protocol (MCP) 표준을 사용해 IDrive^® e2 오브젝트 스토리지를 AI 어시스턴트 및 애플리케이션과 연결합니다. 이를 통해 호환되는 AI 클라이언트가 자연어로 데이터를 안전하게 접근하고 작업할 수 있어, 맞춤 통합, 스크립트, 수동 워크플로가 필요하지 않습니다. 이 가이드는 Windows, Linux 또는 Mac 환경에서 셀프 호스팅 MCP 를 사용해 Codex를 IDrive^® e2 스토리지에 연결하는 방법을 설명합니다.

사전 요구사항

1. 활성화된 IDrive^® e2 계정
2. Codex 계정 접근 권한
3. Node.js 20 이상

참조 아키텍처

IDrive^® e2 MCP 패키지 배포

1. 셀프 호스팅 MCP 패키지 설치

   npm install --global @idrivee2/s3-mcp

   또는 Node.js 프로젝트에 설치:

   npm install @idrivee2/s3-mcp

2. 설치 후 에이전트 실행:

   idrivee2-s3-mcp

   서버가 백그라운드에서 시작되며 프로세스 ID, MCP URL, 로그 파일을 출력합니다. Codex 연결에는 기본 MCP URL을 사용하세요.

   http://127.0.0.1:1908/s3

IDrive^® e2 MCP용 Codex 구성

1. Codex에 로그인하고 Plugins로 이동하세요.
   
2. Installed로 이동하고 아이콘을 클릭하세요.
   
3. Add를 클릭하고 드롭다운에서 Add MCP server를 선택하세요.
   
4. Connect to a custom MCP 대화 상자에서 아래 정보를 입력한 뒤 Save를 클릭하세요.
   1. Streamable HTTP 선택
   2. 커넥터 이름: IDrive e2
   3. MCP 서버 URL: http://127.0.0.1:1908/s3
   
5. IDrive^® e2 웹 콘솔로 리디렉션됩니다.
6. IDrive^® e2 계정 이메일과 비밀번호를 입력하고 Sign in을 클릭하세요.
   
7. 세션 시간 제한과 접근 권한을 설정하세요.
   
8. 인증이 완료되면 Codex로 리디렉션됩니다. 이제 자연어 프롬프트로 IDrive^® e2 스토리지와 상호작용할 수 있습니다.

IDrive^® e2 MCP 서버를 Codex CLI에 연결

OAuth 인증을 사용해 IDrive^® e2 Model Context Protocol (MCP) 서버를 Codex CLI에 연결할 수 있습니다.

1. 다음 명령을 실행하여 IDrive^® e2 MCP 서버를 추가하세요.

   codex mcp add idrive-s3 \
   --url http://127.0.0.1:1908/s3

2. IDrive^® e2로 인증
   명령 실행 후 IDrive^® e2 로그인 페이지로 이동합니다.
   1. IDrive^® e2 자격 증명으로 로그인하세요
   2. 세션 시간 제한과 접근 권한을 설정하세요.
   3. Authorize를 클릭하여 Codex에 IDrive^® e2 계정 접근 권한을 부여하세요.
3. 권한 부여 후 Codex로 다시 이동합니다. 이제 Codex CLI에서 IDrive^® e2 MCP 도구를 사용할 수 있습니다.