ChatGPT 연결 (SSE)

ChatGPT (Plus/Pro/Team) 의 MCP connector 로 ainote 사용.

ChatGPT MCP 는 SSE 전용

ChatGPT 의 connector 는 Server-Sent Events 만 지원. ainote hosted HTTP 직접 연결 불가 → 로컬 SSE 브리지 사용.

1. 브리지 설치

npm install -g @ainote/mcp

설치하면 두 명령이 생김:

• ainote-mcp — stdio (Claude Desktop 용)
• ainote-mcp-http — SSE 브리지 (ChatGPT 용)

2. 브리지 실행

export AINOTE_API_KEY="h7Axq9XPsDTD2qr5yqtcCSaQ..."
export AINOTE_MCP_HTTP_PORT=8765   # 기본 3030 — 원하는 포트로 override
ainote-mcp-http

출력:

ainote MCP SSE bridge listening on http://localhost:8765
SSE endpoint: http://localhost:8765/sse

포트 설정

ainote-mcp-http 는 --port 같은 CLI flag 를 받지 않습니다. AINOTE_MCP_HTTP_PORT 환경변수로 설정. 미설정 시 기본 3030 포트.

백그라운드로 항상 켜두기

brew services 또는 launchd plist 로 부팅 시 자동 실행 가능. 셀프호스팅 가이드 참고.

3. ChatGPT 에 등록

ChatGPT 설정:

1. https://chatgpt.com/#settings → "Connectors"
2. "Add connector" → "MCP server"
3. 입력:
   • Name: ainote
   • URL: http://localhost:8765/sse
   • Auth: (브리지가 env 로 처리, 비워둬도 됨)
4. "Connect"

ChatGPT 는 localhost 접근 가능?

브라우저에서 직접 접근 OK. 회사 방화벽 등이 막으면:

• localhost 대신 127.0.0.1 사용
• HTTPS 필요 시 mkcert 로 self-signed cert + --cert --key 옵션

4. 사용

ChatGPT 에서 도구 사용 가능 표시 → 자연어로 호출:

ainote 에 "ChatGPT 테스트" 태스크 추가해줘

ChatGPT 가 호출 전 승인 화면 띄움 → "Allow" 클릭.

OAuth Bearer 모드 (선택)

기본은 env var. 브리지에서 OAuth 토큰 받기:

npx ainote-mcp-http --port 8765 --oauth

이러면 ChatGPT connector 등록 시:

• Auth Type: OAuth
• Authorization URL: http://localhost:8765/oauth/authorize
• Token URL: http://localhost:8765/oauth/token

ChatGPT 가 oauth flow 통해 토큰 받고 자동 갱신.

보안 권장

• 브리지는 127.0.0.1 만 listen (외부 노출 X)
• 환경변수 키는 ~/.zshrc 보다 ~/.zshenv (gui app 도 읽음)
• Tailscale 통해 다른 기기 ChatGPT 에서도 접근 가능

한계

ChatGPT MCP 는 아직 read-heavy 작업에 적합:

• ✅ list_tasks, get_dev_doc, list_dev_docs (읽기)
• △ create_task, update_dev_doc (쓰기 — 매번 승인 화면)
• ❌ 자동 워크플로우 (사용자 클릭 필요)

쓰기/자동화 많이 한다면 Claude Code 가 더 편함.

다음

• 3가지 transport 비교
• Claude Code 연결
• Telegram 연결 (모바일에서 자동화)