Codex CLI

Codex CLI에서 Framedash 텔레메트리를 조회하려면 Framedash MCP 서버를 Codex에 등록합니다. 플러그인 없이도 Claude Code 플러그인이 제공하는 것과 동일한 MCP 도구를 사용할 수 있습니다.

codex mcp add로 등록

서버를 stdio MCP 서버로 등록합니다:

codex mcp add framedash \
  --env FRAMEDASH_API_KEY=fd_xxx \
  --env FRAMEDASH_PROJECT_ID=your-project-uuid \
  -- npx -y @framedash/mcp-server

--env는 변수마다 하나씩 지정합니다. FRAMEDASH_PROJECT_ID는 선택입니다.

config.toml로 등록

codex mcp add는 서버 정의를 Codex 설정에 저장합니다. 직접 등록하려면 ~/.codex/config.toml에 다음 항목을 추가합니다:

[mcp_servers.framedash]
command = "npx"
args = ["-y", "@framedash/mcp-server"]

[mcp_servers.framedash.env]
FRAMEDASH_API_KEY = "fd_xxx"
FRAMEDASH_PROJECT_ID = "your-project-uuid"

API 키는 채팅에 붙여넣지 말고 환경 변수로 전달하세요.

환경 변수

변수	필수	설명
`FRAMEDASH_API_KEY`	예	사용하는 MCP 도구에 필요한 scope를 가진 API 키.
`FRAMEDASH_PROJECT_ID`	아니오	기본 프로젝트 UUID.
`FRAMEDASH_BASE_URL`	아니오	API 베이스 URL(기본값: `https://app.framedash.dev`).

scope 세부 사항은 MCP Server를 참조하세요.

AGENTS.md로 에이전트에 지시

Codex는 리포지토리의 AGENTS.md를 읽습니다. Framedash 문서, CLI, MCP 서버에 대한 참조를 AGENTS.md에 두면 에이전트가 계측과 조회 방법을 파악할 수 있습니다. 복사용 블록은 AGENTS.md 스니펫을 참조하세요.

Claude 스킬의 비플러그인 대체 자료

Claude Code 플러그인은 SQL 쿼리와 CI 레시피를 위한 스킬을 함께 제공합니다. Codex에는 이 스킬이 포함되지 않지만, 동일한 내용을 다음 페이지에서 확인할 수 있습니다:

이벤트 스키마: 조회 가능한 컬럼과 검증 규칙.
문제 해결: 이벤트가 도착하지 않을 때 확인할 사항.
MCP Server: 도구와 리소스 레퍼런스.

AI 에이전트용: llms.txt