3가지 transport 비교
ainote 는 같은 17개 도구 카탈로그를 3가지 transport 로 제공.
한눈에 보기
| stdio | SSE | hosted HTTP | |
|---|---|---|---|
| 누가 쓰나 | Claude Desktop | ChatGPT | Claude Code, Cursor |
| 설치 | npm i -g @ainote/mcp | npx ainote-mcp-http | 없음 |
| 로컬 프로세스 | ✅ | ✅ (브리지) | ❌ |
| 인증 | env var | env var | HTTP 헤더 |
| 방화벽 친화 | ✅ outbound only | ✅ | ✅ |
| Cold start | 즉시 | 즉시 | ~5초 (Render free) |
| AI 가 트래픽 검증 | 어려움 | SSE 로그 | curl 가능 |
| 권장 시나리오 | 보안 민감 | ChatGPT 사용자 | 대부분 |
1. stdio — 로컬 wrap
[Claude Desktop] ──stdin/stdout──► [@ainote/mcp 프로세스] ──HTTPS──► [api.ainote.dev]설치:
bash
npm install -g @ainote/mcp설정 (~/Library/Application Support/Claude/claude_desktop_config.json):
json
{
"mcpServers": {
"ainote": {
"command": "npx",
"args": ["-y", "@ainote/mcp"],
"env": {
"AINOTE_API_KEY": "h7Axq9XPsDTD2qr5yqtcCSaQ..."
}
}
}
}특징:
- Claude Desktop 만 stdio 지원 (구버전 호환)
- 프로세스 별도 spawn → 살짝 느림 (~50ms overhead)
- 외부에 보내는 트래픽이 한 단계 wrap 됨 (디버깅 어려움)
2. SSE — ChatGPT 브리지
[ChatGPT] ──SSE──► [ainote-mcp-http 로컬 브리지] ──HTTPS──► [api.ainote.dev]ChatGPT 의 MCP connector 가 SSE 만 지원. 로컬에서 브리지 실행:
bash
npx ainote-mcp-http --port 8765ChatGPT 설정:
URL: http://localhost:8765/sse
Auth: Bearer h7Axq9XPsDTD2qr5yqtcCSaQ...특징:
- 브라우저에서 ChatGPT 쓸 때만 작동 (브리지 켜둬야)
- (선택) OAuth bearer 토큰 지원
- ChatGPT 가 호출 단위로 승인 화면 띄움
자세히: ChatGPT 연결.
3. hosted HTTP — 가장 간단
[Claude Code / Cursor] ──HTTPS──► [api.ainote.dev/api/mcp]설정 (~/.claude.json):
json
{
"mcpServers": {
"ainote": {
"type": "http",
"url": "https://api.ainote.dev/api/mcp",
"headers": {
"Authorization": "McpKey YOUR_KEY"
}
}
}
}특징:
- ✅ 별도 프로세스 X
- ✅ 가장 빠른 셋업
- ✅ curl 로 직접 테스트 가능
- ⚠️ Render free 인 경우 cold start 5초
이게 대부분의 사용자에게 권장.
JSON-RPC 형식 (3개 모두 동일)
json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "create_task",
"arguments": {
"title": "회의 준비",
"due_at": "2026-05-08T10:00:00+09:00"
}
}
}자세히: JSON-RPC 호출 형식.
어떤 걸 골라야 하나
├─ Claude Code 사용?
│ → hosted HTTP
│
├─ ChatGPT 사용?
│ → SSE 브리지
│
├─ Claude Desktop 만?
│ → stdio
│
├─ Cursor / Windsurf?
│ → hosted HTTP
│
└─ 보안 민감 (트래픽 검증 필수)?
→ stdio (로컬에서 한 번 wrap)