---
name: opencurrent-codex-mcp-connect
description: "최신 라이브러리 문서와 Figma 디자인을 창을 오가지 않고 Codex 안에서 바로 참고할 수 있습니다. 이럴 때 사용: codex mcp add 명령이나 설정 파일(~/.codex/config.toml)로 Context7·Figma 같은 MCP 서버를 추가하고, 로그인이 필요한 서버는 로그인합니다. 등록된 서버를 확인한 뒤 필요하면 쓸 도구 범위와 시간 제한을 조정합니다. 도구: Codex CLI, Context7, Figma."
metadata:
  source: "https://opencurrent.ai/w/codex-mcp-connect"
  opencurrent-id: "codex-mcp-connect"
  verification: "pending"
  exported-at: "2026-11-21T11:16:08.206Z"
---

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

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

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/codex-mcp-connect
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("codex-mcp-connect")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 준비물이 갖춰졌는지 먼저 확인할 것.
2. body를 처음부터 끝까지 읽고 순서대로 따라 할 것. 코드 블록의 명령은 사용자의 허락을 받고 실행하고, 사람이 해야 하는 일은 사용자에게 안내하고 끝났는지 물을 것.
3. 본문에 확인 방법이 있으면 그대로 확인하고, 다르면 다음으로 넘어가지 말고 사용자에게 알릴 것.
4. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

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)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/codex-mcp-connect 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
