Caliu incluye un servidor MCP (Model Context Protocol), así que los agentes de IA pueden buscar, leer, crear y actualizar tus notas, subir y leer imágenes y archivos, y explorar tus etiquetas. Expone 13 herramientas específicas en lugar de replicar cada endpoint de la API. Para conectar Claude, ChatGPT u otro asistente de chat, la sección Caliu con IA tiene guías paso a paso. Este artículo trata las herramientas para desarrolladores.
Opción 1: servidor remoto con OAuth
El endpoint remoto es https://api.caliuapp.com/mcp (Streamable HTTP). No hay clave que copiar: el cliente te lleva a una pantalla de consentimiento donde inicias sesión en Caliu y apruebas el acceso. Los clientes aprobados aparecen en Apps conectadas en el menú de usuario de la app web, donde puedes revocarlos cuando quieras.
En Claude Code:
claude mcp add --transport http caliu https://api.caliuapp.com/mcp
En Cursor (~/.cursor/mcp.json) y otros clientes que leen una configuración mcpServers:
{
"mcpServers": {
"caliu": {
"url": "https://api.caliuapp.com/mcp"
}
}
}
En VS Code (.vscode/mcp.json):
{
"servers": {
"caliu": {
"type": "http",
"url": "https://api.caliuapp.com/mcp"
}
}
}
Opción 2: servidor local con una clave de API
Crea una clave de API (consulta el artículo sobre claves de API) y luego añade esto a la configuración de tu cliente MCP:
{
"mcpServers": {
"caliu": {
"command": "npx",
"args": ["-y", "@caliu-notes/mcp"],
"env": {
"CALIU_API_KEY": "caliu_your_api_key_here"
}
}
}
}
Los agentes solo escriben Markdown
No hay herramientas de gestión de etiquetas a propósito. Las etiquetas en Caliu derivan de las #hashtags del contenido de la nota, así que un agente que escribe #work/ideas en una nota ya la ha etiquetado. Lo mismo ocurre con los enlaces: escribe [[Note Title]] en una nota y Caliu lo convierte automáticamente en un enlace real a la nota. Ambas opciones ejecutan exactamente las mismas herramientas.