開発者向け MCP サーバー

Caliu には MCP（Model Context Protocol）サーバーが付いていて、AI エージェントが、ノートを検索、閲覧、作成、更新し、画像やファイルをアップロードして読み込み、タグを見て回れます。すべての API エンドポイントを写し取るのではなく、13 個の絞り込まれたツールを公開します。Claude、ChatGPT などのチャットアシスタントを接続するなら、「Caliu と AI」セクションに手順ごとのガイドがあります。この記事では開発者向けのツールを扱います。

方法 1: OAuth を使ったリモートサーバー

リモートエンドポイントは https://api.caliuapp.com/mcp（Streamable HTTP）です。コピーするキーはありません。クライアントが同意画面へ案内するので、そこで Caliu にサインインしてアクセスを承認します。承認したクライアントは、Web アプリのユーザーメニューの 接続済みアプリ に表示され、いつでも取り消せます。

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 が自動的に実際のノートリンクに変換します。どちらの方法も、まったく同じツールを実行します。