MCP로 AI 에이전트 연결하기

Caliu에는 MCP(Model Context Protocol) 서버가 들어 있어요. 그래서 Claude Desktop, Claude Code, Cursor, Windsurf 같은 AI 에이전트가 노트를 검색하고, 읽고, 만들고, 업데이트하고, 미리 알림을 관리하고, 이미지와 파일을 업로드하고 다시 읽어오고, 태그를 둘러볼 수 있어요. 모든 API 엔드포인트를 그대로 옮기는 대신, 꼭 필요한 14개 도구만 제공해요.

방법 1: API 키를 쓰는 로컬 서버

API 키를 만든 다음(API 키 문서를 참고하세요), MCP 클라이언트 설정에 다음을 추가하세요.

{
  "mcpServers": {
    "caliu": {
      "command": "npx",
      "args": ["-y", "@caliu-notes/mcp"],
      "env": {
        "CALIU_API_KEY": "caliu_your_api_key_here"
      }
    }
  }
}

방법 2: OAuth를 쓰는 원격 서버

claude.ai 커넥터 같은 웹 기반 클라이언트는 https://api.caliuapp.com/mcp의 원격 엔드포인트를 쓸 수 있어요. 복사할 키는 없어요. 클라이언트가 동의 화면으로 안내하면, 거기에서 Caliu에 로그인하고 접근을 승인하면 돼요. 승인한 클라이언트는 웹 앱 사용자 메뉴의 연결된 앱에 나타나고, 언제든 해제할 수 있어요.

에이전트는 그냥 Markdown을 써요

태그 관리 도구는 일부러 두지 않았어요. Caliu의 태그는 노트 내용 속 #hashtags에서 나오므로, 노트에 #work/ideas라고 쓰는 에이전트는 이미 태그를 붙인 셈이에요. 링크도 마찬가지예요. 노트에 [[Note Title]]이라고 쓰면 Caliu가 자동으로 진짜 노트 링크로 바꿔 줘요. 두 방법 모두 완전히 같은 도구를 실행해요.