AI Note

Claude · Cursor · Windsurf · ChatGPT · LangChain 가 너의 노트를 그대로 편집.
26 MCP 도구 + OpenAPI 3.1 mirror — agent-native 노트의 기준.

MCP JSON-RPC와OpenAPI 3.1두 surface 가 같은 tool 정의 공유.
Claude 진영과 OpenAI/LangChain 진영을 동시에 cover.

readOnlyHint · destructiveHint · idempotentHint · openWorldHint— 자율 에이전트가 destructive call 사전 차단.

handoff_save·handoff_get·handoff_list. 같은 날 다중 세션 시각별 분리.
7일 자동 purge.

Obsidian 호환 git 저장소.vault_+sync_도구로 multi-device 무손실 동기화.

백엔드는 철저하게, 사용자는 간단하게.
모든 상태 추적은 백엔드, UI 는 의사결정에만 집중.

Web · iOS · Android · macOS · Apple Watch · Chrome / Safari 확장 · PWA · Telegram bot.

ainote 는AI 가 직접 호출하는노트·태스크·메모리·다중 디바이스 동기화 백엔드다. 같은 50+개 도구를두 가지 프로토콜로 동시 노출한다:

- MCP JSON-RPC(https://api.ainote.dev/api/mcp) — Claude Desktop · Claude Code · Cursor · Windsurf
- OpenAPI 3.1(https://api.ainote.dev/api/mcp/openapi.json) — OpenAI Custom GPT Actions · LangChain remote tools · AutoGen · 기타 HTTP-first 에이전트

두 surface 가하나의 tool registry를 공유하므로 (Api::McpController#apply_tool_annotations!) 정의가 갈라질 일이 없다. 한 번 추가한 도구가 모든 에이전트 진영에서 즉시 보인다.

- ✅ 26 도구 production live + tool annotations 4-hint 부착
- ✅ npm@ainote/mcpv1.3.0
- ✅ OpenAPI 3.1 mirror atapi.ainote.dev/api/mcp/openapi.json
- 🔜 MCP resources / subscriptions (Phase 2), OAuth 2.1 DCR (Phase 3), A2A AgentCard (Phase 4)

- handoff_list가 호출될 때백엔드는7일 초과 핸드오프를 알아서 purge 한다.에이전트는단지 목록을 받을 뿐 cleanup 을 모른다 — 그러나 annotations 으로destructiveHint: true를 advertise 해서 자율 에이전트가 destructive call 임을 인식 가능
- vault_sync(action: push)가 호출되면백엔드가conflict 를 감지·해결한다.에이전트는conflictResolution: merge|overwrite|abort한 번 결정만
- login_and_get_key는 MCP key 가 없으면백엔드에서 자동 생성한다.에이전트는그냥 "key 받기" 만 요청

범례: 🔒 read-only · ⚠️ destructive · ♻️ idempotent · 🌐 open-world (외부 시스템 호출)

handoff_list/handoff_get가 destructive 인 이유: 호출 시 7-day stale purge 가 같이 돈다. 자율 에이전트가 cleanup 의도 없이 destructive 호출을 피하도록 마킹.

# app/controllers/api/mcp_controller.rb class Api::McpController < ApplicationController MCP_TOOL_ANNOTATIONS = { "list_tasks" => { readOnlyHint: true, idempotentHint: true, ... }, "delete_task" => { destructiveHint: true, idempotentHint: true, ... }, # ... 26개 전체 }.freeze def self.apply_tool_annotations!(tools) tools.each { |t| t[:annotations] = MCP_TOOL_ANNOTATIONS[t[:name]] } tools end end # app/controllers/api/mcp/openapi_controller.rb class Api::Mcp::OpenapiController < ApplicationController def mcp_tools Api::McpController.apply_tool_annotations!( Api::McpController.build_tools_array ) end end

→ MCPtools/list는 annotations 를 그대로 emit, OpenAPI mirror 는 동일 annotations 를x-mcp-annotationsextension 으로 노출.두 surface 가 갈라질 수 없는 구조.

{ "mcpServers": { "ainote": { "type": "http", "url": "https://api.ainote.dev/api/mcp", "headers": { "Authorization": "McpKey <YOUR_MCP_KEY>" } } } }

→전체 가이드· MCP key 발급은 Claude 에 "ainote 가입시켜줘" 한 줄.

{ "mcpServers": { "ainote": { "command": "npx", "args": ["-y", "@ainote/mcp"], "env": { "AINOTE_API_URL": "https://api.ainote.dev", "AINOTE_API_KEY": "<YOUR_KEY>" } } } }

- ChatGPT → Create a GPT →Configure→ Actions →Create new action
- Schema →Import from URL:https://api.ainote.dev/api/mcp/openapi.json
- Authentication → API Key → Auth Type:Custom, Header:Authorization, Value:McpKey <YOUR_KEY>

[MacBook · Claude Code] handoff_save({project:"logi", topic:"phase4", time:"1555", content:"..."}) → vault 에 handoffs/logi-phase4-1555-2026-05-14.txt 저장 (다른 디바이스 / 다른 세션) [Mac mini · Claude Code] handoff_get({project:"logi", topic:"phase4"}) → 동일 핸드오프 회수 → 작업 재개 (iPhone) ainote 앱 → 같은 vault → 같은 데이터

같은 패턴이태스크 / dev-doc / sync_push / vault_sync전부에 적용. 모든 device 가 같은 백엔드를 본다.

- MIT License— 자체 호스팅 가능 (Docker / Render / Fly.io)
- age E2E encryption—mcpcategory (mcpServers + API keys) 는 클라이언트에서 age 로 암호화 후 업로드. 서버는 평문 모름
- OS Keychain integration— 디바이스별 age identity 가 macOS Keychain / libsecret / Credential Manager 에 저장
- 데이터 위치— Render Singapore PostgreSQL + git vault (사용자 소유 GitHub repo)
- RFC 8628 device flow— CLI 로그인 시 PKCE (S256) 강제
- 삭제 권리—delete_task·delete_dev_doc등 모든 destructive 도구 사용자 임의 호출 가능. 30일 trash window 후 영구 삭제

→Privacy Policy·Terms of Service·Security disclosure

Q. Obsidian 사용자인데 마이그레이션 가능한가요?—vault_create로 vault 만든 뒤 git remote 로 기존 Obsidian vault 를 붙이면 됩니다. 마크다운이라 wikilinks[[...]]그대로 호환.

Q. OpenAI Custom GPT Store 에 공개 가능한가요?— Yes.api.ainote.dev/api/mcp/openapi.json가 OpenAPI 3.1 spec, privacy policy URL (ainote.dev/legal/privacy) 의 root domain 이 일치 → verified domain DNS TXT 인증 완료 시 Public 배포 가능.

Q. 데이터 어디 저장되나요?— 호스팅: Render(Singapore) PostgreSQL + 사용자 GitHub repo (vault). 셀프호스팅: 자체 인스턴스 가능.데이터 내보내기언제든 가능.

Q. Anthropic / OpenAI / Google A2A 다음 어디까지 지원?— MCP (지금) → OpenAPI (지금) → A2A AgentCard (Phase 4 진행 중) → AGNTCY / Letta (모니터링).전체 로드맵

- 📥/llms.txt— 페이지 색인 + 1줄 요약
- 📥/llms-full.txt— 모든 본문 한 파일로

Privacy·Terms·Security·Contact (Telegram · 카카오 오픈채팅)
MIT License · Built by Seunghan Kim · ainote.dev — 너의 노트는 너의 것.

Connect any AI assistant to Syncro: manage tickets, invoices, customers, assets, and more.