Codex CLI

이 가이드는 OpenAI Codex CLI용 mcp-grafana 서버를 설정하는 방법을 안내해요.

출처: 문서

본문

사전 요구 사항

Codex CLI 설치됨 (npm install -g @openai/codex)
서비스 계정 토큰이 있는 Grafana 9.0 이상
PATH에 mcp-grafana 바이너리가 있어야 함

⚠️ 중요: TOML 형식

Codex는 JSON이 아닌 TOML 구성을 사용해요. 구성 파일은 ~/.codex/config.toml이에요.

구성

CLI 설정 (권장)

codex mcp add grafana -- mcp-grafana

환경 변수를 추가해요:

codex mcp add grafana \
  --env GRAFANA_URL=http://localhost:3000 \
  --env GRAFANA_SERVICE_ACCOUNT_TOKEN=<your-token> \
  -- mcp-grafana

수동 구성

~/.codex/config.toml을 생성하거나 편집해요:

[mcp_servers.grafana]
command = "mcp-grafana"
args = []
env = { GRAFANA_URL = "http://localhost:3000", GRAFANA_SERVICE_ACCOUNT_TOKEN = "<your-token>" }

참고: mcp_servers(밑줄, 하이픈 아님)를 사용해요.

디버그 모드

[mcp_servers.grafana]
command = "mcp-grafana"
args = ["-debug"]
env = { GRAFANA_URL = "http://localhost:3000", GRAFANA_SERVICE_ACCOUNT_TOKEN = "<your-token>" }

Docker 설정

[mcp_servers.grafana]
command = "docker"
args = ["run", "--rm", "-i", "-e", "GRAFANA_URL", "-e", "GRAFANA_SERVICE_ACCOUNT_TOKEN", "grafana/mcp-grafana", "-t", "stdio"]
env = { GRAFANA_URL = "http://host.docker.internal:3000", GRAFANA_SERVICE_ACCOUNT_TOKEN = "<your-token>" }

구성 확인

# 구성된 서버 나열
codex mcp list

# 특정 서버 구성 표시
codex mcp get grafana

# Codex 시작 및 테스트
codex

그런 다음 "List my Grafana dashboards"라고 질문해 봐요.

타임아웃 설정

Grafana 작업에 시간이 걸린다면 타임아웃을 늘려요:

[mcp_servers.grafana]
command = "mcp-grafana"
args = []
env = { GRAFANA_URL = "http://localhost:3000", GRAFANA_SERVICE_ACCOUNT_TOKEN = "<your-token>" }
startup_timeout_ms = 20000
tool_timeout_ms = 120000

문제 해결

Codex에서 서버를 찾을 수 없다면:

TOML 구문을 확인해요 (끝에 쉼표 없이, :가 아닌 = 사용)
키가 mcp-servers가 아닌 mcp_servers인지 확인해요
구성 변경 후 Codex를 다시 시작해요

💡 CLI와 IDE가 구성을 공유해요: Codex CLI와 VS Code 확장은 ~/.codex/config.toml을 함께 사용해요. 구문 오류 하나가 둘 다를 망가뜨려요.

흔한 TOML 실수:

# 틀림 - JSON 스타일
env = {"GRAFANA_URL": "http://localhost:3000"}

# 맞음 - TOML 스타일
env = { GRAFANA_URL = "http://localhost:3000" }

읽기 전용 모드

[mcp_servers.grafana]
command = "mcp-grafana"
args = ["--disable-write"]
env = { GRAFANA_URL = "http://localhost:3000", GRAFANA_SERVICE_ACCOUNT_TOKEN = "<your-token>" }

다음 단계

다른 설치 옵션에 맞춰 설정하기.
Grafana 자격 증명 인증을 구성하기.

더 알아보기 (Learn more)

MCP 서버 바이너리 설치 방법
Grafana MCP 서버의 다른 클라이언트 설정
서비스 계정 토큰 인증 구성