O Caliu traz um servidor MCP (Model Context Protocol), para que agentes de IA possam pesquisar, ler, criar e atualizar as tuas notas, enviar e reler imagens e ficheiros, e percorrer as tuas etiquetas. Expõe 13 ferramentas focadas em vez de espelhar todos os endpoints da API. Para ligar o Claude, o ChatGPT ou outro assistente de conversa, a secção Caliu com IA tem guias passo a passo. Este artigo trata das ferramentas para programadores.
Opção 1: servidor remoto com OAuth
O endpoint remoto é https://api.caliuapp.com/mcp (Streamable HTTP). Não há 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 Apps ligadas no menu de utilizador da aplicação web, onde os podes revogar a qualquer momento.
No Claude Code:
claude mcp add --transport http caliu https://api.caliuapp.com/mcp
No Cursor (~/.cursor/mcp.json) e noutros clientes que leem uma configuração mcpServers:
{
"mcpServers": {
"caliu": {
"url": "https://api.caliuapp.com/mcp"
}
}
}
No VS Code (.vscode/mcp.json):
{
"servers": {
"caliu": {
"type": "http",
"url": "https://api.caliuapp.com/mcp"
}
}
}
Opção 2: 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"
}
}
}
}
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. O mesmo acontece com as ligações: escreve [[Note Title]] numa nota e o Caliu converte-a automaticamente numa ligação real à nota. Ambas as opções executam exatamente as mesmas ferramentas.