Caliu embarque un serveur MCP (Model Context Protocol), pour que des agents IA puissent rechercher, lire, créer et mettre à jour vos notes, envoyer et relire des images et des fichiers, et parcourir vos tags. Il expose 13 outils ciblés plutôt que de refléter chaque endpoint de l'API. Pour connecter Claude, ChatGPT ou un autre assistant conversationnel, la section Caliu avec l'IA propose des guides pas à pas. Cet article couvre les outils de développement.
Option 1 : serveur distant avec OAuth
L'endpoint distant est https://api.caliuapp.com/mcp (Streamable HTTP). Aucune clé à copier : le client vous envoie vers un écran de consentement où vous vous connectez à Caliu et approuvez l'accès. Les clients approuvés apparaissent sous Apps connectées dans le menu utilisateur de l'app web, où vous pouvez les révoquer à tout moment.
Dans Claude Code :
claude mcp add --transport http caliu https://api.caliuapp.com/mcp
Dans Cursor (~/.cursor/mcp.json) et les autres clients qui lisent une configuration mcpServers :
{
"mcpServers": {
"caliu": {
"url": "https://api.caliuapp.com/mcp"
}
}
}
Dans VS Code (.vscode/mcp.json) :
{
"servers": {
"caliu": {
"type": "http",
"url": "https://api.caliuapp.com/mcp"
}
}
}
Option 2 : serveur local avec une clé API
Créez une clé API (voir l'article sur les clés API), puis ajoutez ceci à la configuration de votre client MCP :
{
"mcpServers": {
"caliu": {
"command": "npx",
"args": ["-y", "@caliu-notes/mcp"],
"env": {
"CALIU_API_KEY": "caliu_your_api_key_here"
}
}
}
}
Les agents écrivent simplement du Markdown
Il n'y a volontairement aucun outil de gestion des tags. Les tags dans Caliu dérivent des #hashtags dans le contenu des notes, donc un agent qui écrit #travail/idées dans une note l'a déjà tagué. Il en va de même pour les liens : écrivez [[Note Title]] dans une note et Caliu le convertit automatiquement en un vrai lien vers la note. Les deux options exécutent exactement les mêmes outils.