Caliu inclou un servidor MCP (Model Context Protocol), així que els agents d'IA poden cercar, llegir, crear i actualitzar les teves notes, pujar i llegir imatges i fitxers, i explorar les teves etiquetes. Exposa 13 eines enfocades en comptes de reflectir cada endpoint de l'API. Per connectar Claude, ChatGPT o un altre assistent de xat, la secció Caliu amb IA té guies pas a pas. Aquest article tracta les eines per a desenvolupadors.
Opció 1: servidor remot amb OAuth
L'endpoint remot és https://api.caliuapp.com/mcp (Streamable HTTP). Sense cap clau per copiar: el client t'envia a una pantalla de consentiment on inicies la sessió a Caliu i aproves l'accés. Els clients aprovats apareixen a Apps connectades al menú d'usuari de l'app web, on els pots revocar quan vulguis.
A Claude Code:
claude mcp add --transport http caliu https://api.caliuapp.com/mcp
A Cursor (~/.cursor/mcp.json) i altres clients que llegeixen una configuració mcpServers:
{
"mcpServers": {
"caliu": {
"url": "https://api.caliuapp.com/mcp"
}
}
}
A VS Code (.vscode/mcp.json):
{
"servers": {
"caliu": {
"type": "http",
"url": "https://api.caliuapp.com/mcp"
}
}
}
Opció 2: servidor local amb una clau API
Crea una clau API (consulta l'article de claus API), i després afegeix això a la configuració del teu client MCP:
{
"mcpServers": {
"caliu": {
"command": "npx",
"args": ["-y", "@caliu-notes/mcp"],
"env": {
"CALIU_API_KEY": "caliu_your_api_key_here"
}
}
}
}
Els agents només escriuen Markdown
No hi ha eines de gestió d'etiquetes a propòsit. Les etiquetes a Caliu deriven dels #hashtags del contingut de la nota, així que un agent que escriu #work/ideas en una nota ja l'ha etiquetada. El mateix passa amb els enllaços: escriu [[Note Title]] en una nota i Caliu el converteix automàticament en un enllaç real a la nota. Totes dues opcions executen exactament les mateixes eines.