Connettere agenti AI con MCP

Caliu include un server MCP (Model Context Protocol), così agenti AI come Claude Desktop, Claude Code, Cursor e Windsurf possono cercare, leggere, creare e aggiornare le tue note, gestire i promemoria, caricare e rileggere immagini e file, e sfogliare i tuoi tag. Espone 14 strumenti mirati invece di rispecchiare ogni endpoint dell'API.

Opzione 1: server locale con una chiave API

Crea una chiave API (vedi l'articolo sulle chiavi API), poi aggiungi questo alla configurazione del tuo client MCP:

{
  "mcpServers": {
    "caliu": {
      "command": "npx",
      "args": ["-y", "@caliu-notes/mcp"],
      "env": {
        "CALIU_API_KEY": "caliu_your_api_key_here"
      }
    }
  }
}

Opzione 2: server remoto con OAuth

I client basati sul web come i connettori di claude.ai possono usare l'endpoint remoto su https://api.caliuapp.com/mcp. Nessuna chiave da copiare: il client ti manda a una schermata di consenso dove accedi a Caliu e approvi l'accesso. I client approvati compaiono sotto App connesse nel menu utente dell'app web, dove puoi revocarli in qualsiasi momento.

Gli agenti scrivono solo Markdown

Non ci sono strumenti di gestione dei tag, di proposito. I tag in Caliu derivano dagli #hashtags nel contenuto delle note, quindi un agente che scrive #work/ideas in una nota l'ha già taggata. Lo stesso vale per i link: scrivi [[Note Title]] in una nota e Caliu lo converte automaticamente in un link reale alla nota. Entrambe le opzioni eseguono esattamente gli stessi strumenti.