{"id":"codex-mcp-connect","kind":"workflow","testedWith":[],"durationMin":null,"url":"https://opencurrent.ai/w/codex-mcp-connect","title":"코딩 에이전트에 최신 문서·디자인 도구 연결 (Codex MCP)","summary":"최신 라이브러리 문서와 Figma 디자인을 창을 오가지 않고 Codex 안에서 바로 참고할 수 있습니다.","category":"개발","categoryId":"dev","domain":"dev","domainLabel":"개발","capabilities":[{"id":"code","label":"코드 작성"},{"id":"integrate","label":"앱 연동·자동화"}],"topics":[{"id":"dev","label":"개발"}],"tools":["Codex CLI","Context7","Figma"],"whenToUse":"codex mcp add 명령이나 설정 파일(~/.codex/config.toml)로 Context7·Figma 같은 MCP 서버를 추가하고, 로그인이 필요한 서버는 로그인합니다. 등록된 서버를 확인한 뒤 필요하면 쓸 도구 범위와 시간 제한을 조정합니다.","body":"## 준비\n\n- Codex CLI 설치\n- STDIO 서버 예시는 npx 실행 환경\n- Figma 예시는 FIGMA_OAUTH_TOKEN 환경 변수\n\n### 1. 명령으로 STDIO 서버 추가\n\nContext7을 STDIO 서버로 등록합니다. 환경 변수가 필요하면 서버 명령 앞에 `--env VAR=VALUE`를 넣습니다.\n\n```bash\ncodex mcp add context7 -- npx -y @upstash/context7-mcp\n```\n\n`config.toml`에 `[mcp_servers.context7]` 항목이 생깁니다.\n\n### 2. 설정 파일로 HTTP 서버 추가\n\n`~/.codex/config.toml`(신뢰한 프로젝트는 `.codex/config.toml`)에 Figma를 Streamable HTTP 서버로 적습니다. 토큰은 환경 변수 이름으로 지정합니다.\n\n```json\n[mcp_servers.figma]\nurl = \"https://mcp.figma.com/mcp\"\nbearer_token_env_var = \"FIGMA_OAUTH_TOKEN\"\nhttp_headers = { \"X-Figma-Region\" = \"us-east-1\" }\n```\n\n### 3. OAuth 로그인 (필요한 서버만)\n\nOAuth를 지원하는 서버는 로그인합니다. 브라우저가 없는 곳에서는 `--no-browser`를 붙이고, 출력된 주소를 다른 곳에서 연 뒤 돌아온 전체 주소를 터미널에 붙여 넣습니다.\n\n```bash\ncodex mcp login <server-name>\n```\n\n명령이 오류 없이 끝나면 인증된 것입니다.\n\n### 4. 등록된 서버 확인\n\n터미널에서 목록을 확인합니다. Codex 대화 화면에서는 `/mcp`로 활성 서버를 봅니다.\n\n```bash\ncodex mcp list\n```\n\ncontext7과 figma가 활성으로 보이면 됩니다.\n\n### 5. 도구 범위·시간 제한 조정 (선택)\n\n`enabled_tools`는 허용 목록, `disabled_tools`는 거부 목록이며 거부 목록은 허용 목록 뒤에 적용됩니다. 시작 제한 `startup_timeout_sec`의 기본값은 10, 도구 제한 `tool_timeout_sec`의 기본값은 60입니다. 서버를 지우지 않고 끄려면 `enabled = false`로 둡니다.\n\n```toml\n[mcp_servers.context7]\ncommand = \"npx\"\nargs = [\"-y\", \"@upstash/context7-mcp\"]\nstartup_timeout_sec = 20\ntool_timeout_sec = 45\nenabled = true\n```\n\n`/mcp`에 허용한 도구만 보이면 됩니다.\n\n## 주의\n\n- 인증 정보를 찾지 못하면 인증 없이 연결될 수 있습니다. 이때는 `codex mcp login`을 따로 실행합니다.\n- OAuth 클라이언트 비밀값은 `config.toml`에 평문으로 저장됩니다. 파일을 비공개로 두고 버전 관리에서 뺍니다.\n- `http_headers_helper`는 로컬 환경의 HTTP 연결에서만 동작합니다. STDIO 서버와 원격 실행 환경에는 적용되지 않습니다.\n- ChatGPT 웹은 로컬 Codex 설정을 읽지 않습니다. 웹에서는 플러그인을 씁니다.","prerequisites":["Codex CLI 설치","STDIO 서버 예시는 npx 실행 환경","Figma 예시는 FIGMA_OAUTH_TOKEN 환경 변수"],"inputs":[],"howToFollow":"1. 준비물이 갖춰졌는지 먼저 확인할 것.\n2. body를 처음부터 끝까지 읽고 순서대로 따라 할 것. 코드 블록의 명령은 사용자의 허락을 받고 실행하고, 사람이 해야 하는 일은 사용자에게 안내하고 끝났는지 물을 것.\n3. 본문에 확인 방법이 있으면 그대로 확인하고, 다르면 다음으로 넘어가지 말고 사용자에게 알릴 것.\n4. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.","steps":[{"n":1,"kind":"command","title":"명령으로 STDIO 서버 추가","body":"Context7을 STDIO 서버로 등록. 환경 변수가 필요하면 --env VAR=VALUE를 서버 명령 앞에 추가.","prompt":"codex mcp add context7 -- npx -y @upstash/context7-mcp","expected":"config.toml에 [mcp_servers.context7] 항목","check":"다음 단계 목록에 context7이 보이면 성공","tool":"Codex CLI"},{"n":2,"kind":"command","title":"설정 파일로 HTTP 서버 추가","body":"~/.codex/config.toml(신뢰한 프로젝트는 .codex/config.toml)에 Figma를 Streamable HTTP 서버로 작성. 토큰은 환경 변수 이름으로 지정.","prompt":"[mcp_servers.figma]\nurl = \"https://mcp.figma.com/mcp\"\nbearer_token_env_var = \"FIGMA_OAUTH_TOKEN\"\nhttp_headers = { \"X-Figma-Region\" = \"us-east-1\" }","expected":"config.toml에 [mcp_servers.figma] 항목","check":"다음 단계 목록에 figma가 보이면 성공","tool":"Codex CLI"},{"n":3,"kind":"command","title":"OAuth 로그인 (필요한 서버만)","body":"OAuth를 지원하는 서버는 로그인 실행. 브라우저가 없는 곳이면 --no-browser 추가 후 출력 주소를 다른 곳에서 열고 돌아온 전체 주소를 터미널에 붙여 넣기.","prompt":"codex mcp login <server-name>","expected":"서버 인증 완료","check":"로그인 명령이 오류 없이 끝나면 성공","tool":"Codex CLI"},{"n":4,"kind":"command","title":"등록된 서버 확인","body":"터미널에서 목록 확인, Codex 대화 화면에서는 /mcp로 활성 서버 확인.","prompt":"codex mcp list","expected":"context7·figma가 든 서버 목록","check":"Codex 안 /mcp에 두 서버가 활성으로 보이면 성공","tool":"Codex CLI"},{"n":5,"kind":"command","title":"도구 범위·시간 제한 조정 (선택)","body":"enabled_tools로 허용 목록, disabled_tools로 거부 목록(허용 목록 뒤 적용). 시작 제한 startup_timeout_sec 기본 10, 도구 제한 tool_timeout_sec 기본 60. 지우지 않고 끄려면 enabled = false.","prompt":"[mcp_servers.context7]\ncommand = \"npx\"\nargs = [\"-y\", \"@upstash/context7-mcp\"]\nstartup_timeout_sec = 20\ntool_timeout_sec = 45\nenabled = true","expected":"서버별 시간 제한·허용 도구 반영","check":"/mcp에 허용한 도구만 보이면 성공","tool":"Codex CLI"}],"pitfalls":["인증 정보를 찾지 못하면 인증 없이 연결될 수 있음. 이 경우 codex mcp login 따로 실행","OAuth 클라이언트 비밀값이 config.toml에 평문 저장. 파일을 비공개로, 버전 관리에서 제외","http_headers_helper는 로컬 환경의 HTTP 연결에서만 동작. STDIO 서버·원격 실행 환경 제외","ChatGPT 웹은 로컬 Codex 설정을 읽지 않음. 웹에서는 플러그인 사용"],"sources":[{"title":"Model Context Protocol","url":"https://learn.chatgpt.com/docs/extend/mcp?surface=cli"}],"verification":{"status":"pending","label":"검수 대기","detail":"사람 확인 전","verifiedBy":0,"lastVerifiedAt":null},"quality":{"score":32,"components":{"result":0.5,"trust":0,"freshness":0.4},"explanation":"확인 없음 · 검수 대기"},"workedFor":0,"trials":{"summary":"","lastAt":null,"total":0,"worked":0,"partial":0,"failed":0,"recent":[]},"asOf":{"date":"2026-11-15T07:14:52.106705+00:00","basis":"updated"},"updatedAt":"2026-11-15T07:14:52.106705+00:00","goals":[{"id":"dev","title":"개발"}],"uses":30,"likes":0}