MCP 란? (30초 정리)

MCP (Model Context Protocol) = Anthropic 이 만든 "AI ↔ 도구" 표준 프로토콜.

한 줄 비유

REST API 가 "프론트엔드 ↔ 백엔드" 표준이듯, MCP 는 "AI 모델 ↔ 외부 도구" 표준.

ainote 입장에서

ainote 는 MCP 서버 입니다. 17개 도구를 노출:

create_task, update_task, delete_task, list_tasks, list_categories,
create_dev_doc, update_dev_doc, delete_dev_doc, get_dev_doc,
list_dev_docs, list_dev_categories, pull_dev_docs,
vault_create, vault_clone, vault_sync, vault_list, vault_connect_status,
sync_push, sync_pull, sync_list,
signup_and_get_key, login_and_get_key, get_setup_guide

MCP 클라이언트 (Claude Desktop, Claude Code, ChatGPT, Cursor, Telegram bot) 가 이 도구들을 호출 → ainote 가 실행 → 결과 반환.

작동 흐름

[사용자]
   │  "내일 회의 추가해줘"
   ▼
[Claude / GPT]
   │  도구 결정: create_task
   │  파라미터 파싱: {title, due_at, ...}
   ▼
[MCP 클라이언트]
   │  JSON-RPC 2.0 over HTTP/stdio/SSE
   ▼
[ainote MCP 서버]
   │  Rails 8 API
   │  PostgreSQL insert
   │  Solid Queue 알림 스케줄
   ▼
[응답]
   │  {"status": "ok", "task_id": 1234}
   ▼
[사용자에게 결과]
   "내일 10시 회의 추가했습니다 ✅"

3가지 transport

ainote 는 같은 도구 카탈로그를 3가지 방식으로 제공:

transport	누가 쓰나	패키지
stdio	Claude Desktop, 보안 민감	`npm i -g @ainote/mcp`
SSE	ChatGPT, 일부 클라이언트	`ainote-mcp-http`
hosted HTTP	Claude Code, Cursor, 자동화	`https://api.ainote.dev/api/mcp`

자세히: 3가지 transport 비교.

다른 도구와 비교

	ainote	filesystem	github	slack
제공	tasks/memory/vault	파일 R/W	repo/PR	채널/메시지
인증	API key	로컬	OAuth	OAuth
transport	3개	stdio	stdio	http
로컬 데이터	△	✅	❌	❌

MCP 란? (30초 정리) ​

한 줄 비유 ​

ainote 입장에서 ​

작동 흐름 ​

3가지 transport ​

다른 도구와 비교 ​

더 알아보기 ​