I tuoi appunti, dentro il tuo assistente IA

Collega Cosmonote a Claude, ChatGPT o a un altro assistente IA. Potrà leggere le tue registrazioni, trascrizioni, riassunti e azioni, e rispondere alle tue domande.

Comincia da qui ↓

A cosa serve

Una volta collegato, puoi chiedere al tuo assistente cose come «cosa abbiamo deciso alla riunione di lunedì?» e andrà a cercare la risposta nei tuoi appunti Cosmonote. Senza copia-incolla, senza esportare.

Può solo leggere. Il tuo assistente non può mai modificare, cancellare o registrare nulla, e vede soltanto gli appunti del tuo account.

MCP è lo standard aperto che rende tutto questo possibile. Non ti serve saperne altro per seguire i passaggi qui sotto. Se preferisci costruire qualcosa per conto tuo, usa l'API REST.

Prima di cominciare

Ti serve una cosa sola: una chiave API Cosmonote. Ci vogliono trenta secondi.

  1. Apri l'app Cosmonote sul telefono.
  2. Vai su Impostazioni → Chiavi API.
  3. Tocca Crea una chiave e copiala.

Tienila a portata di mano. Il tuo assistente te la chiede una volta, al momento dell'accesso, e mai più.

Collega il tuo assistente

Scegli quello che usi. Tutti i percorsi finiscono allo stesso modo: si apre una pagina di accesso Cosmonote, incolli la chiave e sei collegato.

https://nebula.cosmonote.ai/mcp
Vai a: Claude Claude Code ChatGPT Cursor, Windsurf, Zed…

Claude

Web, desktop e mobile
  1. Apri Claude e vai su Impostazioni → Connettori.
  2. Clicca su Aggiungi connettore personalizzato.
  3. Incolla l'indirizzo di Cosmonote nel campo URL: 
    https://nebula.cosmonote.ai/mcp
  4. Clicca su Collega. Si apre una pagina di accesso Cosmonote.
  5. Incolla la tua chiave API e conferma. Cosmonote compare ora nella tua lista di connettori.

Claude Code

Nel terminale
  1. Lancia questo comando: 
    claude mcp add --transport http cosmonote https://nebula.cosmonote.ai/mcp
  2. Scrivi /mcp dentro Claude Code e scegli Authenticate.
  3. Incolla la tua chiave API nella pagina che si apre.

ChatGPT

Web e desktop
  1. Apri ChatGPT e vai su Impostazioni → Connettori.
  2. Cerca Cosmonote nella directory. Se non c'è, scegli Aggiungi connettore personalizzato e incolla l'indirizzo qui sopra.
  3. Accedi con la tua chiave API quando te la chiede.

Cursor, Windsurf, Zed e gli altri

Qualsiasi app compatibile con MCP funziona allo stesso modo. Aggiungi Cosmonote al suo file di configurazione, poi aprila e completa l'accesso che ti propone.

{
  "mcpServers": {
    "cosmonote": {
      "url": "https://nebula.cosmonote.ai/mcp"
    }
  }
}

La connessione usa Streamable HTTP con OAuth 2.0 e PKCE. Nient'altro da configurare.

Provalo

Una volta collegato, chiedigli quello che vuoi su ciò che hai registrato.

Riassumi le mie ultime 3 riunioni
Quali decisioni sono state prese al punto di squadra di ieri?
Elenca tutte le mie azioni aperte con le scadenze
Cosa ha detto Sarah sul calendario di lancio?
Scrivi un'email di follow-up basata sulla riunione di oggi
Confronta i punti chiave delle mie ultime due lezioni

Cosa può vedere

Tre strumenti in sola lettura, tutti limitati al tuo account.

list_notes

I tuoi appunti, con titolo, data, durata, interlocutori, categoria e punti chiave.

read-only
get_note

Un appunto per intero, con la trascrizione e il riassunto se li chiedi.

read-only
list_action_items

Le azioni estratte dai tuoi appunti, per un appunto o per tutti.

read-only

Riferimento tecnico

Non ti serve nulla di tutto questo per collegarti. È qui per chi integra Cosmonote in un'app propria.

Endpoint https://nebula.cosmonote.ai/mcp
Trasporto Streamable HTTP (JSON-RPC)
Auth OAuth 2.0 + PKCE
Discovery /.well-known/oauth-authorization-server
Accesso Sola lettura, limitato all'utente

Se qualcosa non va

La connessione fallisce

Controlla l'indirizzo carattere per carattere. È https://nebula.cosmonote.ai/mcp, senza barra finale.

La pagina di accesso rifiuta la mia chiave

Le chiavi vanno copiate per intero, prefisso compreso. Nel dubbio, creane una nuova in Impostazioni → Chiavi API e incolla quella.

Si collega ma non trova appunti

Il tuo assistente vede solo gli appunti dell'account che ha emesso la chiave. Verifica di essere sullo stesso account Cosmonote e che contenga registrazioni.

Sei ancora bloccato

Scrivici a [email protected] dicendoci quale assistente stai collegando.