개발자를 위한 MCP 서버

Caliu에는 MCP(Model Context Protocol) 서버가 들어 있어요. 그래서 AI 에이전트가 노트를 검색하고, 읽고, 만들고, 업데이트하고, 이미지와 파일을 업로드하고 다시 읽어오고, 태그를 둘러볼 수 있어요. 모든 API 엔드포인트를 그대로 옮기는 대신, 꼭 필요한 13개 도구만 제공해요. Claude, ChatGPT 같은 채팅 어시스턴트를 연결하려면 AI와 함께 쓰는 Caliu 섹션에 단계별 안내가 있어요. 이 문서는 개발자 도구를 다뤄요.

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

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

Claude Code에서는:

claude mcp add --transport http caliu https://api.caliuapp.com/mcp

Cursor(~/.cursor/mcp.json)와 mcpServers 설정을 읽는 다른 클라이언트에서는:

{
  "mcpServers": {
    "caliu": {
      "url": "https://api.caliuapp.com/mcp"
    }
  }
}

VS Code(.vscode/mcp.json)에서는:

{
  "servers": {
    "caliu": {
      "type": "http",
      "url": "https://api.caliuapp.com/mcp"
    }
  }
}

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

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

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

에이전트는 그냥 Markdown을 써요

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