llm-cli-gateway MCP 및 Async Skill 전역 설정 가이드

Source

  • Basic Journals/Daily Journals/2026 병오년/병오년 18주, 120일, 4월 30일 목요일.md

Summary

이 노트는 llm-cli-gateway npm 패키지를 전역 설치하고, Codex MCP 서버(llm-gateway)를 비동기(async) 도구만 허용하도록 설정하는 구체적인 절차와 정책을 담고 있다. 동기 도구는 배제하고, *_request_async를 기본으로 하며, job 상태 확인과 결과 수집을 위한 polling 로직 및 타임아웃 처리 기준(quick/normal/deep review)을 정의한다. 또한 이를 위한 전역 Skill 파일 생성 및 검증 스크립트 작성 방법을 포함한다.

Key Points

  • npm 전역 패키지로 llm-cli-gateway 설치 및 Node.js 20 이상 요구사항 확인
  • Codex MCP 서버 llm-gateway 등록 시 LLM_GATEWAY_APPROVAL_POLICY=strict 적용
  • MCP 설정에서 동기 도구는 제외하고 gemini_request_async 등 비동기 도구만 allowlist로 허용
  • 전역 Skill llm-gateway-async 생성: async 호출 우선, job.id 파싱, bounded polling, 타임아웃 시 로컬 판단 진행
  • 검증 단계: 패키지 설치 확인, MCP 설정 동기 도구 부재 확인, Skill 파일 존재 여부 및 스크립트 문법 체크