ainote

테마

ChatGPT 연결 (SSE) ​

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

ChatGPT MCP 는 SSE 전용

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

1. 브리지 설치 ​

bash
npm install -g @ainote/mcp

설치하면 두 명령이 생김:

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

2. 브리지 실행 ​

bash
export AINOTE_API_URL="https://api.ainote.dev"   # 빌트인 default 는 구 onrender 호스트 — 꼭 지정
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 가 필요하면 caddy / nginx 등 별도 리버스 프록시로 감싸세요. ainote-mcp-http 자체는 TLS 옵션이 없습니다.

4. 사용 ​

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

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

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

OAuth Bearer 인증 (선택) ​

기본은 env var (AINOTE_API_KEY) 입니다. ChatGPT 가 자체 Authorization: Bearer … 헤더로 호출하길 원하면 브리지를 OAuth bearer 검증 모드로 띄울 수 있습니다:

bash
export AINOTE_API_URL="https://api.ainote.dev"
export AINOTE_API_KEY="..."
export AINOTE_MCP_HTTP_PORT=8765
export AINOTE_ENABLE_OAUTH_AUTH=true
ainote-mcp-http

이러면 브리지가 들어오는 Bearer 토큰을 검증합니다. 브리지는 OAuth 인가 서버(authorize / token endpoint)는 제공하지 않습니다 — 토큰은 ainote 웹/계정 설정에서 발급한 키를 그대로 ChatGPT connector 의 Bearer 값으로 넣는 식.

Authorization Code flow / 토큰 자동 갱신이 필요한 케이스는 현재 미지원. 별도 OAuth provider 가 필요하면 GitHub issue 로 요청 주세요.

보안 권장 ​

  • 브리지는 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 가 더 편함.

다음 ​