Server MCP per sviluppatori

Caliu include un server MCP (Model Context Protocol), così gli agenti IA possono cercare, leggere, creare e aggiornare le tue note, caricare e rileggere immagini e file, e sfogliare i tuoi tag. Espone 13 strumenti mirati invece di rispecchiare ogni endpoint dell'API. Per collegare Claude, ChatGPT o un altro assistente di chat, la sezione Caliu con l'IA ha guide passo passo. Questo articolo riguarda gli strumenti per sviluppatori.

Opzione 1: server remoto con OAuth

L'endpoint remoto è https://api.caliuapp.com/mcp (Streamable HTTP). 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.

In Claude Code:

claude mcp add --transport http caliu https://api.caliuapp.com/mcp

In Cursor (~/.cursor/mcp.json) e negli altri client che leggono una configurazione mcpServers:

{
  "mcpServers": {
    "caliu": {
      "url": "https://api.caliuapp.com/mcp"
    }
  }
}

In VS Code (.vscode/mcp.json):

{
  "servers": {
    "caliu": {
      "type": "http",
      "url": "https://api.caliuapp.com/mcp"
    }
  }
}

Opzione 2: 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"
      }
    }
  }
}

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.