Caliu liefert einen MCP-Server (Model Context Protocol) mit, sodass KI-Agenten deine Notizen suchen, lesen, erstellen und aktualisieren, Bilder und Dateien hochladen und wieder abrufen und deine Tags durchstöbern können. Er stellt 13 fokussierte Werkzeuge bereit, statt jeden API-Endpunkt zu spiegeln. Wenn du Claude, ChatGPT oder einen anderen Chat-Assistenten verbinden willst, findest du im Bereich „Caliu mit KI“ Schritt-für-Schritt-Anleitungen. Dieser Artikel behandelt Entwickler-Tools.
Option 1: Remote-Server mit OAuth
Der Remote-Endpunkt ist https://api.caliuapp.com/mcp (Streamable HTTP). Kein Schlüssel zu kopieren: Der Client schickt dich zu einem Zustimmungsbildschirm, wo du dich bei Caliu anmeldest und den Zugriff genehmigst. Genehmigte Clients erscheinen unter Verbundene Apps im Benutzermenü der Web-App, wo du sie jederzeit widerrufen kannst.
In Claude Code:
claude mcp add --transport http caliu https://api.caliuapp.com/mcp
In Cursor (~/.cursor/mcp.json) und anderen Clients, die eine mcpServers-Konfiguration lesen:
{
"mcpServers": {
"caliu": {
"url": "https://api.caliuapp.com/mcp"
}
}
}
In VS Code (.vscode/mcp.json):
{
"servers": {
"caliu": {
"type": "http",
"url": "https://api.caliuapp.com/mcp"
}
}
}
Option 2: lokaler Server mit einem API-Schlüssel
Erstelle einen API-Schlüssel (siehe den Artikel über API-Schlüssel), dann füge dies zur Konfiguration deines MCP-Clients hinzu:
{
"mcpServers": {
"caliu": {
"command": "npx",
"args": ["-y", "@caliu-notes/mcp"],
"env": {
"CALIU_API_KEY": "caliu_your_api_key_here"
}
}
}
}
Agenten schreiben einfach Markdown
Es gibt absichtlich keine Werkzeuge zur Tag-Verwaltung. Tags in Caliu leiten sich aus #hashtags im Notizinhalt ab, sodass ein Agent, der #arbeit/ideen in eine Notiz schreibt, sie damit bereits getaggt hat. Das Gleiche gilt für Verknüpfungen: Schreibe [[Note Title]] in eine Notiz, und Caliu wandelt es automatisch in eine echte Notizverknüpfung um. Beide Optionen führen genau dieselben Werkzeuge aus.