Skip to main content
Glama

openai-mcp

ChatGPT Plus 또는 Pro 구독을 Claude Code, Codex 및 모든 MCP 클라이언트 내에서 사용하세요.

PyPI version License: MIT Python 3.10+


기능

openai-mcp는 ChatGPT 백엔드 API로 요청을 직접 전달하는 15개의 MCP 도구를 제공합니다. 별도의 프록시 프로세스나 계정이 필요 없습니다. 본인의 토큰과 할당량을 사용하세요.

Claude Code, Codex CLI 및 stdio를 통해 MCP 프로토콜을 지원하는 모든 클라이언트에서 작동합니다.


Related MCP server: claude-max-mcp

설치

pip install openai-mcp

또는 격리된 설치를 위해 pipx를 사용하세요:

pipx install openai-mcp

설정

openai-mcp setup

마법사가 다음 작업을 수행합니다:

  1. ~/.codex/auth.json에서 기존 Codex 인증 토큰을 찾습니다.

  2. 찾을 수 없는 경우, ChatGPT 세션 토큰을 붙여넣으라는 메시지를 표시합니다.

  3. 자격 증명을 ~/.openai-mcp/token.json에 저장합니다.


Claude Code 구성

~/.claude.json의 mcpServers 아래에 다음을 추가하세요:

{
  "mcpServers": {
    "openai": {
      "type": "stdio",
      "command": "openai-mcp",
      "args": ["run", "--stdio"]
    }
  }
}

저장 후 Claude Code를 다시 시작하세요. 도구는 openai 네임스페이스 아래에 나타납니다.


도구

도구

기능

chat

GPT-5.x, Pro 모델, o3, o3-pro와 채팅

deep_research

웹 보조 검색 답변 (~30초)

deep_research_heavy

gpt-5-5-pro를 통한 심층 연구 (5~30분, 월간 할당량 사용)

account_status

ChatGPT 플랜 및 활성화된 기능

list_models

계정에서 사용 가능한 모든 모델

memory_list

ChatGPT 메모리 목록 (PII 마스킹됨)

memory_search

키워드로 ChatGPT 메모리 검색

custom_instructions_get

ChatGPT 맞춤 설정 가져오기

list_codex_envs

Codex 환경 목록

list_codex_tasks

최근 Codex 작업 목록

list_custom_gpts

사용자 지정 GPT 목록

list_conversations

최근 ChatGPT 대화 목록

list_tasks

예약된 ChatGPT 작업 목록

list_apps

연결된 앱 및 커넥터


아키텍처

네이티브 Python 구현 — 프록시 없음. 서버는 TLS 위장을 위해 curl_cffi를 사용하여 /backend-api/conversation (SSE)를 직접 호출합니다. 포함된 POW 및 Turnstile 솔버가 OpenAI Sentinel 챌린지를 처리합니다. 저작자 표시는 NOTICES를 참조하세요.

~/.codex/auth.json  (or ~/.openai-mcp/token.json)
        |
   openai-mcp  (stdio MCP server)
        |
   curl_cffi  →  chatgpt.com /backend-api/conversation  (SSE)
        |
   14 read tools + 1 heavy DR tool

제한 사항

  • 심층 연구 할당량: Pro는 월 248회 요청, Plus는 더 적음.

  • image_gen: 스텁은 존재하지만 아직 작동하는 엔드포인트에 연결되지 않음.

  • memory_add: 읽기 전용 — 쓰기 엔드포인트가 405를 반환하므로 도구가 등록되지 않음.

  • 활성 ChatGPT Plus 또는 Pro 구독이 필요합니다.


개발

python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest

라이선스

MIT. 타사 저작자 표시는 NOTICES를 참조하세요.


감사의 말

Related MCP Connectors

Related MCP Servers