O Caliu traz um servidor MCP (Model Context Protocol), para que agentes de IA como o Claude Desktop, o Claude Code, o Cursor e o Windsurf possam pesquisar, ler, criar e atualizar as tuas notas, gerir lembretes e percorrer as tuas etiquetas. Expõe 12 ferramentas focadas em vez de espelhar todos os endpoints da API.
Opção 1: servidor local com uma chave de API
Cria uma chave de API (consulta o artigo sobre chaves de API) e depois adiciona isto à configuração do teu cliente MCP:
{
"mcpServers": {
"caliu": {
"command": "npx",
"args": ["-y", "@caliu-notes/mcp"],
"env": {
"CALIU_API_KEY": "caliu_your_api_key_here"
}
}
}
}
Opção 2: servidor remoto com OAuth
Os clientes baseados na web, como os conectores do claude.ai, podem usar o endpoint remoto em https://api.caliuapp.com/mcp. Sem chave para copiar: o cliente envia-te para um ecrã de consentimento onde inicias sessão no Caliu e aprovas o acesso. Os clientes aprovados aparecem em Aplicações ligadas no menu de utilizador da aplicação web, onde os podes revogar a qualquer momento.
Os agentes só escrevem Markdown
Não há ferramentas de gestão de etiquetas de propósito. As etiquetas no Caliu derivam dos #hashtags no conteúdo da nota, por isso um agente que escreve #work/ideas numa nota já a etiquetou. Ambas as opções executam exatamente as mesmas ferramentas.