Caliu поставляется с сервером MCP (Model Context Protocol), поэтому ИИ-агенты могут искать, читать, создавать и обновлять ваши заметки, загружать и читать изображения и файлы, а также просматривать ваши теги. Он предоставляет 13 сфокусированных инструментов, а не зеркалит каждый эндпоинт API. Чтобы подключить Claude, ChatGPT или другой чат-ассистент, загляните в раздел «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 автоматически превратит это в настоящую ссылку на заметку. Оба варианта запускают ровно одни и те же инструменты.