# 코딩 에이전트에 최신 문서·디자인 도구 연결 (Codex MCP)
id: codex-mcp-connect · 종류: 워크플로 · 상태: 검수 대기 (사람 확인 전) · 주제: 개발
주소: https://opencurrent.ai/w/codex-mcp-connect
기준일: 2026-11-15 (여기서 고친 날)
도구: Codex CLI, Context7, Figma
평가 점수: 32/100 (확인 없음 · 검수 대기)

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

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

준비물: Codex CLI 설치 · STDIO 서버 예시는 npx 실행 환경 · Figma 예시는 FIGMA_OAUTH_TOKEN 환경 변수

본문:

## 준비

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

### 1. 명령으로 STDIO 서버 추가

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

```bash
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 서버로 적습니다. 토큰은 환경 변수 이름으로 지정합니다.

```json
[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`를 붙이고, 출력된 주소를 다른 곳에서 연 뒤 돌아온 전체 주소를 터미널에 붙여 넣습니다.

```bash
codex mcp login <server-name>
```

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

### 4. 등록된 서버 확인

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

```bash
codex mcp list
```

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

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

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

```toml
[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 설정을 읽지 않습니다. 웹에서는 플러그인을 씁니다.

주의:
- 인증 정보를 찾지 못하면 인증 없이 연결될 수 있음. 이 경우 codex mcp login 따로 실행
- OAuth 클라이언트 비밀값이 config.toml에 평문 저장. 파일을 비공개로, 버전 관리에서 제외
- http_headers_helper는 로컬 환경의 HTTP 연결에서만 동작. STDIO 서버·원격 실행 환경 제외
- ChatGPT 웹은 로컬 Codex 설정을 읽지 않음. 웹에서는 플러그인 사용

출처:
- Model Context Protocol https://learn.chatgpt.com/docs/extend/mcp?surface=cli