Skip to main content
Glama

mcp-chatgpt

AI 어시스턴트(예: Google Antigravity, Claude Desktop, Cursor, VS Code Cline/Roo Code)가 브라우저 자동화, Chrome 프로필, 그리고 함께 제공되는 Chrome 확장 프로그램을 통해 ChatGPT Web(https://chatgpt.com)에 직접 질문하고 대화하며 상호작용할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다.


🌟 주요 기능

  • 💬 질문 및 채팅: ChatGPT Web에 원활하게 질문하고 응답(형식화된 텍스트/마크다운)을 받습니다.

  • 🌐 웹 검색 토글: ChatGPT의 실시간 웹 검색(web_search: true)을 활성화하여 실시간 웹 브라우징과 인용을 지원합니다.

  • 🧠 추론 및 모델 선택: 모델(model: "o3-mini", "gpt-4o", "o1")을 선택하고 추론 노력(reasoning_effort: "high" | "medium" | "low")을 구성합니다.

  • 📎 파일 및 이미지 첨부: 멀티모달 분석을 위해 이미지(image_paths)와 문서/코드(file_paths)를 첨부합니다.

  • 자동 계속 생성: 긴 답변이 잘릴 경우 "Continue generating" / "สร้างต่อ"을 자동으로 클릭합니다.

  • 💻 코드 추출: extract_code_only: true로 코드 블록만 추출하여 반환합니다.

  • 👤 Chrome 프로필 선택기: 컴퓨터의 모든 Google Chrome 프로필(Default, Profile 1, Work, Personal, 이메일)을 자동 감지하여 대화할 계정을 선택할 수 있습니다.

  • 🧩 함께 제공되는 Chrome 확장 프로그램: extension/에 Manifest V3 확장 프로그램이 포함되어 있으며, 프로필 잠금 문제 없이 어떤 Chrome 프로필에든 로드하여 ChatGPT 탭과 실시간으로 대화할 수 있습니다.

  • 🔄 대화 관리: Conversation ID / URL을 사용하여 새 채팅을 시작하거나 기존 스레드를 이어갑니다.

  • 💾 영구 세션: 브라우저 프로필과 로그인 쿠키를 로컬에 저장하여 한 번만 로그인하면 됩니다.

  • 🖥️ 헤디드 및 헤드리스 모드: 백그라운드에서 조용히 실행하거나(헤드리스), 초기 인증이나 캡차 해결을 위해 보이는 창(--login / --headed)을 실행합니다.

  • 🔌 Chrome CDP 지원: --remote-debugging-port를 통해 이미 실행 중인 Google Chrome 인스턴스에 연결합니다.

  • 🧰 작업공간 도구: 크로스 플랫폼 shell_command와 루트 제한 apply_patch 도구로 파일 검색, 빌드/테스트 실행, 코드 편집을 할 수 있습니다.

  • 🌐 원격 MCP 터널: Cloudflare Tunnel/ngrok 또는 다른 HTTPS 터널용 Bearer 인증이 있는 선택적 Streamable HTTP 엔드포인트를 제공합니다.


Related MCP server: agentify-desktop

🛠️ 제공되는 MCP 도구

도구

매개변수

설명

shell_command

command (string, 필수)workdir (string, 선택)shell (auto|powershell|bash, 선택)timeout_ms (number, 선택)

구성된 루트 아래의 작업 디렉터리에서 명령을 실행합니다. Windows에서는 PowerShell을, Linux/macOS에서는 Bash를 자동 선택합니다.

apply_patch

patch (string, 필수)

구조화된 패치를 사용하여 구성된 셸 루트 아래의 파일을 추가, 업데이트, 삭제 또는 이동합니다.

chatgpt_ask

message (string, 필수)web_search (boolean, 선택)model (string, 선택)reasoning_effort ("low"|"medium"|"high", 선택)image_paths (string[], 선택)file_paths (string[], 선택)extract_code_only (boolean, 선택)auto_continue (boolean, 선택)refresh_page (boolean, 선택)profile (string, 선택)new_chat (boolean, 선택)conversation_id (string, 선택)timeout_ms (number, 선택)

ChatGPT Web에 고급 컨트롤과 함께 프롬프트/질문을 보내고 어시스턴트 응답을 반환합니다.

chatgpt_reload

없음

현재 ChatGPT Web 페이지를 다시 로드하고 새로 고쳐 멈춤 상태나 연결 오류를 복구합니다.

chatgpt_list_models

없음

이 계정에서 사용 가능한 모든 AI 모델(GPT-5.6 Sol, GPT-5.5, o3, GPT-4o, o1)과 추론 노력 옵션을 나열합니다.

chatgpt_list_conversations

limit (number, 선택)

ChatGPT 사이드바에서 최근 대화 주제와 ID를 직접 나열하여 채팅을 검색하거나 재개합니다.

chatgpt_list_profiles

없음

이 컴퓨터에서 감지된 모든 Google Chrome 프로필을 프로필 ID, 이름, 이메일과 함께 나열합니다.

chatgpt_select_profile

profile (string, 필수)

활성 Chrome 프로필을 선택하고 전환합니다(ID Profile 1, 이름 또는 이메일로).

chatgpt_new_chat

없음

ChatGPT Web에서 새 채팅 세션을 시작합니다.

chatgpt_get_status

없음

브라우저 상태, 활성 프로필, 브리지 상태, 현재 URL, 활성 모델을 가져옵니다.

chatgpt_login

profile (string, 선택)

로그인을 위해 ChatGPT Web을 보이는 브라우저 창에서 엽니다.


🚀 빠른 시작

[!WARNING] shell_command는 MCP 서버와 동일한 운영 체제 권한으로 임의의 명령을 실행할 수 있습니다. --shell-root는 선택 가능한 시작 작업 디렉터리를 제한하지만 OS 샌드박스는 아닙니다. 신뢰할 수 없는 클라이언트를 연결할 때는 제한된 사용자로 서버를 실행하거나 컨테이너에서 실행하세요. apply_patch는 변경된 모든 경로가 --shell-root 안에 유지되도록 강제합니다.

원격 MCP 터널

로컬 stdio가 기본값으로 유지됩니다. 원격 호환 MCP 엔드포인트를 노출하려면 토큰과 함께 HTTP 모드를 시작하세요:

mcp-chatgpt --http --http-token "change-this-token"

엔드포인트는 http://127.0.0.1:8787/mcp입니다. 그 앞에 터널을 배치하세요. 예:

cloudflared tunnel --url http://127.0.0.1:8787

원격 MCP 클라이언트를 /mcp로 끝나는 공개 터널 URL과 Authorization: Bearer change-this-token 헤더로 구성하세요. /healthz는 터널 상태 확인에 사용할 수 있습니다. 이 프로세스나 터널 중 하나라도 중지되면 원격 MCP 요청을 사용할 수 없습니다.

1. 설치 및 빌드

# Clone the repository
git clone https://github.com/JonusNattapong/mcp-chatgpt.git
cd mcp-chatgpt

# Install dependencies and Chromium
npm install
npx playwright install chromium

# Build TypeScript
npm run build

# Install the MCP command globally
npm install -g .

설치 후 다음으로 확인하세요:

mcp-chatgpt --help

이 패키지는 설치 중에 npm run build를 자동으로 실행하므로 로컬 체크아웃에서 설치하면 글로벌 명령이 항상 현재 TypeScript 소스를 사용합니다.


👤 Chrome 프로필 사용하기 (2가지 옵션)

옵션 1: Chrome 프로필 자동 감지 (직접 / 헤드리스)

폴더 이름(예: Default, Profile 1), 표시 이름 또는 이메일로 시스템의 모든 Chrome 프로필을 선택할 수 있습니다:

# List all Chrome profiles in your system
node -e "import('./dist/profile-manager.js').then(m => console.table(m.ProfileManager.listProfiles()))"

# Login with a specific profile
node dist/index.js --login --profile "Profile 1"

또는 chatgpt_ask 도구에 profile 매개변수를 직접 전달하세요!


옵션 2: 동반 Chrome 확장 프로그램 (활성 Chrome 사용 시 권장)

이미 로그인된 ChatGPT 계정으로 Google Chrome을 매일 사용 중이라면 동반 확장 프로그램을 설치하세요:

  1. 원하는 프로필로 Google Chrome을 엽니다.

  2. chrome://extensions로 이동합니다.

  3. 개발자 모드(오른쪽 상단)를 활성화합니다.

  4. 압축해제된 확장 프로그램을 로드합니다를 클릭하고 d:\Projects\Github\mcp-chatgpt\extension 폴더를 선택합니다.

  5. 도구 모음에서 확장 프로그램 아이콘을 클릭하고 프로필 태그(예: "업무 계정")를 설정한 다음 저장 및 연결을 클릭합니다.

  6. mcp-chatgpt가 실행되면 Chrome 탭을 통해 프롬프트를 직접 라우팅합니다!


⚙️ MCP 클라이언트 구성

Model Context Protocol(MCP)을 지원하는 모든 AI 클라이언트에 mcp-chatgpt를 연결할 수 있습니다:

1. Antigravity IDE / Gemini CLI

파일 위치: ~/.gemini/config/mcp_config.json (Windows: C:\Users\<User>\.gemini\config\mcp_config.json)

{
  "mcpServers": {
    "chatgpt": {
      "command": "node",
      "args": [
        "d:/Projects/Github/mcp-chatgpt/dist/index.js"
      ]
    }
  }
}

2. Claude Desktop

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "chatgpt": {
      "command": "node",
      "args": [
        "d:/Projects/Github/mcp-chatgpt/dist/index.js"
      ]
    }
  }
}

3. Cursor IDE

프로젝트의 .cursor/mcp.json에 추가하거나 Cursor 설정 > 기능 > MCP에서 추가하세요:

{
  "mcpServers": {
    "chatgpt": {
      "command": "node",
      "args": [
        "d:/Projects/Github/mcp-chatgpt/dist/index.js"
      ]
    }
  }
}

4. VS Code (Cline / Roo Code / Roo Clinic)

파일 위치:

  • Cline: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

  • Roo Code: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "chatgpt": {
      "command": "node",
      "args": [
        "d:/Projects/Github/mcp-chatgpt/dist/index.js"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

5. Windsurf Editor (Codeium)

파일 위치: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "chatgpt": {
      "command": "node",
      "args": [
        "d:/Projects/Github/mcp-chatgpt/dist/index.js"
      ]
    }
  }
}

6. Zed Editor

~/.config/zed/settings.json에 추가하세요:

{
  "context_servers": {
    "chatgpt": {
      "command": {
        "path": "node",
        "args": ["d:/Projects/Github/mcp-chatgpt/dist/index.js"]
      }
    }
  }
}

7. LibreChat (librechat.yaml)

librechat.yaml에 추가하세요:

mcpServers:
  chatgpt:
    type: stdio
    command: node
    args:
      - d:/Projects/Github/mcp-chatgpt/dist/index.js

8. Cloudflare Tunnel을 통한 원격 연결 (원격 URL / SSE / mcp-remote)

ChatGPT 브라우저 또는 브리지 서버가 홈 컴퓨터나 VPS에서 실행 중이고, 다른 머신/노트북의 AI 클라이언트가 Cloudflare Tunnel을 통해 인터넷을 거쳐 안전하게 연결하려는 경우:

A단계: 호스트 머신에서 브리지 서버 노출

# Start Cloudflare Quick Tunnel (Free, no account required)
cloudflared tunnel --url http://127.0.0.1:18999

이렇게 하면 공개 HTTPS URL이 생성됩니다(예: https://alpha-bravo-charlie.trycloudflare.com)


B단계: 원격 머신에서 클라이언트 구성

1. Antigravity / Gemini CLI (원격 SSE / URL)

~/.gemini/config/mcp_config.json에 추가하세요:

{
  "mcpServers": {
    "chatgpt-remote": {
      "serverUrl": "https://alpha-bravo-charlie.trycloudflare.com/sse"
    }
  }
}
2. Cursor IDE (원격 SSE)

.cursor/mcp.json 또는 Cursor 설정에 추가하세요:

{
  "mcpServers": {
    "chatgpt-remote": {
      "url": "https://alpha-bravo-charlie.trycloudflare.com/sse"
    }
  }
}
3. VS Code Cline / Roo Code (원격 SSE)

cline_mcp_settings.json에 추가하세요:

{
  "mcpServers": {
    "chatgpt-remote": {
      "url": "https://alpha-bravo-charlie.trycloudflare.com/sse",
      "type": "sse",
      "disabled": false,
      "autoApprove": []
    }
  }
}
4. Claude Desktop / 모든 stdio 클라이언트 (mcp-remote 경유)

command(stdio)만 허용하는 클라이언트의 경우 mcp-remote를 사용하여 Cloudflare Tunnel URL을 브리지하세요:

{
  "mcpServers": {
    "chatgpt-remote": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://alpha-bravo-charlie.trycloudflare.com/sse"
      ]
    }
  }
}
5. LibreChat (librechat.yaml)
mcpServers:
  chatgpt-remote:
    type: sse
    url: https://alpha-bravo-charlie.trycloudflare.com/sse
6. 직접 HTTP REST API (cURL / Python / Node.js)

Cloudflare를 통해 브리지 엔드포인트와 직접 상호 작용할 수도 있습니다:

# Query status
curl -s https://alpha-bravo-charlie.trycloudflare.com/status

# Ask a question
curl -X POST https://alpha-bravo-charlie.trycloudflare.com/ask \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello from Cloudflare Tunnel!"}'

📖 CLI 옵션

Usage: mcp-chatgpt [options]

Options:
  --headed                 Run browser in headed (visible) mode (default: false)
  --login                  Open browser in interactive mode to log in to ChatGPT
  --profile <name_or_id>   Select specific Chrome Profile (e.g. "Default", "Profile 1", or Name/Email)
  --chrome                 Use installed Google Chrome browser (default: true)
  --no-chrome              Use Playwright bundled Chromium instead of Google Chrome
  --user-data-dir <path>   Custom browser profile directory
  --cdp <endpoint>         Connect to an existing Chrome browser via CDP endpoint
  --bridge-port <port>     Port for Chrome Extension bridge WebSocket (default: "18999")
  --bridge-only            Run only the Chrome Extension WebSocket bridge server
  --shell-root <path>      Restrict shell and patch tools to this directory (default: current directory)
  --shell-max-timeout <ms> Maximum shell command timeout in milliseconds (default: "300000")
  --http                   Expose an MCP Streamable HTTP endpoint for a tunnel/remote client
  --http-host <host>       HTTP bind host (default: "127.0.0.1")
  --http-port <port>       HTTP port for the MCP endpoint (default: "8787")
  --http-token <token>     Bearer token required by remote MCP clients (or MCP_HTTP_TOKEN)
  --timeout <ms>           Default timeout in milliseconds (default: "120000")
  -h, --help               Display help for command

🌟 라이브 대화형 메모리 및 컨텍스트 유지 데모

다음은 mcp-chatgpt를 통해 실시간으로 실행된 실제 편집되지 않은 다중 턴 대화형 세션입니다:

턴 1: 새 세션에서 컨텍스트 설정 (new_chat: true)

요청:

{
  "message": "สวัสดีครับ ผมชื่อ โจ๊กเกอร์ เป็น Software Architect ชอบเขียน Go และ TypeScript กำลังพัฒนาโปรเจกต์ชื่อ MCP-ChatGPT ฝากจำข้อมูลนี้ไว้หน่อยนะครับ ตอบสั้นๆ 1 ประโยคยืนยัน",
  "new_chat": true
}

ChatGPT 응답:

"จำไว้แล้วครับ: คุณชื่อโจ๊กเกอร์ เป็น Software Architect ชอบ Go และ TypeScript และกำลังพัฒนาโปรเจกต์ MCP-ChatGPT ครับ"

URL: https://chatgpt.com/c/6a86843c-8f30-83ec-b064-d27f7f832244


턴 2: 후속 메모리 회상 (conversation_id)

요청:

{
  "message": "ไหนลองทบทวนดูซิว่า ผมชื่ออะไร ชอบเขียนภาษาอะไร และกำลังทำโปรเจกต์ชื่ออะไรอยู่?",
  "conversation_id": "6a86843c-8f30-83ec-b064-d27f7f832244"
}

ChatGPT 응답 (6초 만에 회상):

"คุณชื่อ โจ๊กเกอร์ ชอบเขียน Go และ TypeScript และกำลังพัฒนาโปรเจกต์ชื่อ MCP-ChatGPT อยู่ครับ 🫡"


🤖 AI 어시스턴트 시스템 프롬프트 및 통합 지침

다음 지침을 복사하여 AI 어시스턴트(Cursor Rules, Claude System Prompt, Antigravity Custom Instructions, Cline, Roo Code)에 붙여넣으면 AI가 mcp-chatgpt를 호출해야 하는 시기방법을 자동으로 알 수 있습니다:

# 🛠️ Instruction: Setup and Integrate `mcp-chatgpt` MCP Server

You are integrated with the `mcp-chatgpt` MCP server, granting you direct access to ChatGPT Web capabilities (o3-mini, o1, GPT-4o, live Web Search, DALL-E, and multimodal file analysis).

### 🎯 When to Automatically Use `chatgpt_ask`:

1. **Deep Reasoning & Hard Coding Tasks**:
   - For complex architecture designs, difficult debugging, or advanced algorithms, call `chatgpt_ask` with:
     `{ "model": "o3-mini", "reasoning_effort": "high", "extract_code_only": true }`
2. **Live Web Information & Current News**:
   - When the user asks for up-to-date news, today's market data, or the latest documentation of newly updated packages, call:
     `{ "web_search": true }`
3. **Image Generation (DALL-E 3)**:
   - When the user requests an image, logo, or icon design, request it via `chatgpt_ask` and present the returned `imageUrls` directly to the user.
4. **Heavy Document & File Analysis**:
   - When analyzing CSV, Excel spreadsheets, PDFs, or large source code files, attach them via `file_paths` or `image_paths`.
5. **Continuous Conversations**:
   - Always track and pass `conversation_id` to continue in the same thread, or pass `new_chat: true` when starting an unrelated topic.
6. **Finding Past Chats**:
   - Call `chatgpt_list_conversations` to search for existing topic IDs before resuming a specific past conversation.

📄 라이선스

MIT

Install Server
F
license - not found
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • MCP server for AI dialogue using various LLM models via AceDataCloud

  • MCP server for Gainium — manage trading bots, deals, and balances via AI assistants

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/JonusNattapong/mcp-chatgpt'

If you have feedback or need assistance with the MCP directory API, please join our Discord server