Caliu levert een MCP-server (Model Context Protocol), zodat AI-agents je notities kunnen zoeken, lezen, maken en bijwerken, afbeeldingen en bestanden kunnen uploaden en teruglezen en door je tags kunnen bladeren. Die biedt 13 gerichte tools in plaats van elk API-endpoint na te bootsen. Wil je Claude, ChatGPT of een andere chatassistent verbinden, dan vind je stap-voor-stapuitleg in het onderdeel Caliu met AI. Dit artikel gaat over tools voor ontwikkelaars.
Optie 1: externe server met OAuth
Het externe endpoint is https://api.caliuapp.com/mcp (Streamable HTTP). Er is 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.
In Claude Code:
claude mcp add --transport http caliu https://api.caliuapp.com/mcp
In Cursor (~/.cursor/mcp.json) en andere clients die een mcpServers-configuratie lezen:
{
"mcpServers": {
"caliu": {
"url": "https://api.caliuapp.com/mcp"
}
}
}
In VS Code (.vscode/mcp.json):
{
"servers": {
"caliu": {
"type": "http",
"url": "https://api.caliuapp.com/mcp"
}
}
}
Optie 2: 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"
}
}
}
}
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. Hetzelfde geldt voor links: schrijf [[Note Title]] in een notitie en Caliu zet dit automatisch om in een echte notitielink. Beide opties draaien exact dezelfde tools.