Caliu levert een MCP-server (Model Context Protocol), zodat AI-agents zoals Claude Desktop, Claude Code, Cursor en Windsurf je notities kunnen zoeken, lezen, maken en bijwerken, herinneringen kunnen beheren en door je tags kunnen bladeren. Die biedt 12 gerichte tools in plaats van elk API-endpoint na te bootsen.
Optie 1: lokale server met een API-sleutel
Maak een API-sleutel (zie het artikel over API-sleutels), voeg dit dan toe aan de configuratie van je MCP-client:
{
"mcpServers": {
"caliu": {
"command": "npx",
"args": ["-y", "@caliu-notes/mcp"],
"env": {
"CALIU_API_KEY": "caliu_your_api_key_here"
}
}
}
}
Optie 2: externe server met OAuth
Webgebaseerde clients zoals claude.ai-connectors kunnen het externe endpoint op https://api.caliuapp.com/mcp gebruiken. Geen sleutel om te kopiëren: de client stuurt je naar een toestemmingsscherm waar je je bij Caliu aanmeldt en toegang goedkeurt. Goedgekeurde clients verschijnen onder Verbonden apps in het gebruikersmenu van de web-app, waar je ze op elk moment kunt intrekken.
Agents schrijven gewoon Markdown
Er zijn met opzet geen tools voor tagbeheer. Tags in Caliu komen voort uit #hashtags in de notitie-inhoud, dus een agent die #work/ideas in een notitie schrijft, heeft die al getagd. Beide opties draaien exact dezelfde tools.