본문으로 건너뛰기

코딩 에이전트에 최신 문서·디자인 도구 연결 (Codex MCP)

최신 라이브러리 문서와 Figma 디자인을 창을 오가지 않고 Codex 안에서 바로 참고할 수 있습니다.

codex mcp add 명령이나 설정 파일(~/.codex/config.toml)로 Context7·Figma 같은 MCP 서버를 추가하고, 로그인이 필요한 서버는 로그인합니다. 등록된 서버를 확인한 뒤 필요하면 쓸 도구 범위와 시간 제한을 조정합니다.

준비

  • Codex CLI 설치
  • STDIO 서버 예시는 npx 실행 환경
  • Figma 예시는 FIGMA_OAUTH_TOKEN 환경 변수

1. 명령으로 STDIO 서버 추가

Context7을 STDIO 서버로 등록합니다. 환경 변수가 필요하면 서버 명령 앞에 --env VAR=VALUE를 넣습니다.

터미널에 붙여 넣기
codex mcp add context7 -- npx -y @upstash/context7-mcp

config.toml에 [mcp_servers.context7] 항목이 생깁니다.

2. 설정 파일로 HTTP 서버 추가

~/.codex/config.toml(신뢰한 프로젝트는 .codex/config.toml)에 Figma를 Streamable HTTP 서버로 적습니다. 토큰은 환경 변수 이름으로 지정합니다.

설정에 추가
[mcp_servers.figma]
url = "https://mcp.figma.com/mcp"
bearer_token_env_var = "FIGMA_OAUTH_TOKEN"
http_headers = { "X-Figma-Region" = "us-east-1" }

3. OAuth 로그인 (필요한 서버만)

OAuth를 지원하는 서버는 로그인합니다. 브라우저가 없는 곳에서는 --no-browser를 붙이고, 출력된 주소를 다른 곳에서 연 뒤 돌아온 전체 주소를 터미널에 붙여 넣습니다.

터미널에 붙여 넣기
codex mcp login <server-name>

명령이 오류 없이 끝나면 인증된 것입니다.

4. 등록된 서버 확인

터미널에서 목록을 확인합니다. Codex 대화 화면에서는 /mcp로 활성 서버를 봅니다.

터미널에 붙여 넣기
codex mcp list

context7과 figma가 활성으로 보이면 됩니다.

5. 도구 범위·시간 제한 조정 (선택)

enabled_tools는 허용 목록, disabled_tools는 거부 목록이며 거부 목록은 허용 목록 뒤에 적용됩니다. 시작 제한 startup_timeout_sec의 기본값은 10, 도구 제한 tool_timeout_sec의 기본값은 60입니다. 서버를 지우지 않고 끄려면 enabled = false로 둡니다.

설정에 추가
[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]
startup_timeout_sec = 20
tool_timeout_sec = 45
enabled = true

/mcp에 허용한 도구만 보이면 됩니다.

주의

  • 인증 정보를 찾지 못하면 인증 없이 연결될 수 있습니다. 이때는 codex mcp login을 따로 실행합니다.
  • OAuth 클라이언트 비밀값은 config.toml에 평문으로 저장됩니다. 파일을 비공개로 두고 버전 관리에서 뺍니다.
  • http_headers_helper는 로컬 환경의 HTTP 연결에서만 동작합니다. STDIO 서버와 원격 실행 환경에는 적용되지 않습니다.
  • ChatGPT 웹은 로컬 Codex 설정을 읽지 않습니다. 웹에서는 플러그인을 씁니다.

업무 분야 · 필요한 기능

이 기능을 가진 도구