MCP 연결·활용 / 2026년 9월 29일 확인

OpenAI Docs MCP 연결하기: Codex·Claude Code 설정과 실제 검색 결과

Codex나 Claude Code로 개발하다가 OpenAI 기능의 현재 사용법을 확인하고 싶을 때, 공식 문서를 검색하는 MCP를 연결할 수 있습니다. 이번에는 서버에 직접 연결해 검색과 문서 본문 가져오기를 시험하고, Codex CLI의 연결 설정도 확인했습니다.

무엇을 연결하나?

OpenAI Docs MCP는 OpenAI가 공개한 문서용 MCP 서버입니다. 개발 문서의 검색과 본문 읽기를 제공하며, OpenAI API를 대신 호출하는 기능은 아닙니다. 서버 주소는 https://developers.openai.com/mcp입니다. 로그인이나 API 키를 요구하는 설정 절차 없이 공개 문서를 읽는 용도로 안내되어 있습니다.

예를 들어 “Codex의 MCP 설정은 어디에 저장하나요?”라고 질문할 때, AI가 검색된 공식 문서를 참고하도록 할 수 있습니다. 다만 MCP를 연결했다고 해서 AI의 모든 답변이 자동으로 공식 문서에 근거하는 것은 아닙니다. 질문에 “문서 MCP로 확인하고 출처를 알려줘”라고 명시한 뒤 링크와 내용을 확인하는 편이 안전합니다.

Codex CLI에서 연결하기

터미널에서 다음 명령으로 서버를 등록합니다. 명령은 공식 설치 안내에 나온 방법입니다.

codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
codex mcp list

list 결과에 openaiDeveloperDocs와 위 URL이 보이면 설정이 등록된 것입니다. 이번 실습에서는 개인 설정을 바꾸지 않기 위해 CLI의 임시 설정 옵션으로 같은 URL을 넣었습니다. 목록에 서버가 enabled로 표시되는 것까지 확인했습니다. 이 목록은 설정 상태를 보여줄 뿐, 대화 중 검색까지 성공했다는 증거는 아닙니다.

codex -c 'mcp_servers.openaiDeveloperDocs.url="https://developers.openai.com/mcp"' mcp list

Windows PowerShell에서도 위 임시 명령을 실행했습니다. Codex CLI와 IDE 확장은 공식 안내상 MCP 설정을 공유합니다. 앱 버전과 설치 형태에 따라 연결 화면이 다를 수 있으므로, 데스크톱 앱의 UI 동작은 이 글의 검증 결과에 포함하지 않았습니다.

Claude Code에서 연결하기

Claude Code가 설치되어 있다면 프로젝트 폴더의 터미널에서 아래 명령을 실행합니다. 이 명령과 /mcp 확인 절차는 OpenAI 공식 안내에 실려 있습니다.

claude mcp add --transport http openaiDeveloperDocs https://developers.openai.com/mcp
claude mcp list

Claude Code 안에서 /mcp를 열어 연결 상태를 확인합니다. 모든 프로젝트에서 쓰려면 공식 안내의 --scope user 옵션을 사용할 수 있습니다. 여기서 말하는 대상은 Claude Code CLI입니다. Claude 데스크톱 앱의 설치 화면과 동일하다고 가정하면 안 됩니다.

실제 서버에서 확인한 결과

공개 서버에 MCP 요청을 보내 초기화한 뒤 도구 목록을 조회했습니다. 문서 검색(search_openai_docs), 문서 가져오기(fetch_openai_doc) 등을 포함한 도구 5개가 반환됐습니다. 이어 Codex MCP server setup으로 검색하자 결과 10개가 왔고, 첫 결과인 MCP servers 공식 문서의 본문도 가져왔습니다. 이 숫자는 2026년 9월 29일 실행 결과로, 나중에 달라질 수 있습니다.

독자도 공개한 검증 스크립트를 실행하면 같은 흐름을 재현할 수 있습니다. Python 표준 라이브러리만 사용하며, 비밀번호나 API 키를 입력하지 않습니다. 실행 결과에는 서버 정보, 도구 이름, 검색된 문서 주소와 본문 수신 여부가 출력됩니다. 검색 순위와 글자 수는 문서 갱신에 따라 달라질 수 있으므로 특정 숫자에 맞출 필요는 없습니다.

연결한 뒤 어떻게 질문할까?

OpenAI Docs MCP로 Codex MCP 설정 방법을 찾아줘.
사용한 공식 문서 링크를 붙이고, 지금 내 환경에 적용되는 단계만 정리해줘.

답변을 받으면 출처가 공식 문서인지, 사용 중인 도구가 Codex CLI인지 Claude Code인지, 명령이 현재 버전에도 맞는지 확인하세요. 이 MCP는 문서를 읽는 도구이므로 계정 설정 변경이나 코드 수정을 대신 수행한다고 기대하면 안 됩니다.

언제 추천하고, 무엇을 주의할까?

OpenAI API나 Codex 기능을 자주 다루고, 문서가 자주 바뀌는 부분을 확인해야 한다면 유용합니다. OpenAI와 무관한 작업만 한다면 이 서버를 항상 켜 둘 이유는 적습니다. 제공 범위가 공식 문서로 한정되고, 결과의 관련성을 사람이 확인해야 합니다. 연결 시 권한·비용·데이터 범위를 서비스별로 다시 확인하는 습관도 필요합니다.

이 글은 공개 문서 MCP의 연결을 시험한 기록입니다. 다음 MCP도 실제 작업 결과와 함께 MCP 연결·활용에 모읍니다.