Integrazione MCP

Collegando ad Addness un'IA come Claude Code, Codex, ChatGPT, Cursor o Claude Desktop (integrazione MCP), l'IA può leggere e scrivere i tuoi obiettivi, ToDo, commenti e altro in Addness.

Se è la prima volta: Chi crea una nuova organizzazione e chi entra in un'organizzazione su invito trova "Configurare Addness" nella pagina degli obiettivi. Nella riga "1. Collega l'IA ad Addness" al suo interno, premi "Chiedi all'IA" → "Apri in Claude Code" (o "Apri in Codex"): l'IA procede in ordine, a partire dal collegamento ad Addness (→ pagina degli obiettivi). I passaggi a partire dall'installazione dell'app dell'IA sono in Installare un'app di IA e collegarla ad Addness. Questo articolo spiega solo la parte relativa all'integrazione MCP.

Invia la richiesta all'IA

Ti basta inviare questa richiesta all'IA che usi.

Configura Addness MCP (https://vt.api.addness.com/mcp).

L'IA procede con la configurazione dove può e ti guida solo nei passaggi che richiedono il tuo intervento. Devi solo autorizzare personalmente l'accesso nel browser quando l'IA ti indica di farlo.

Cosa potrà fare l'IA

Da qualunque IA ti colleghi, legge e scrive lo stesso albero degli obiettivi della stessa organizzazione.

Se la configurazione si blocca: istruzioni per ogni strumento

Se la configurazione si blocca per problemi di autorizzazioni o autenticazione, mostra all'IA i passaggi qui sotto oppure prosegui tu.

ChatGPT (plugin ufficiale)

Digita «@Addness» in ChatGPT o seleziona Addness dall’elenco delle app. Premi «Connetti», accedi ad Addness e premi «Consenti». Disponibile con il piano Free. Le operazioni di scrittura richiedono una conferma. Puoi collegare solo un account Addness già esistente (da ChatGPT non è possibile registrarsi).

Claude Code (terminale)

1. Aggiungi Addness MCP (con --scope user puoi usarlo da qualsiasi progetto)

claude mcp add --transport http --scope user addness https://vt.api.addness.com/mcp

1. Accedi ad Addness (quando si apre il browser, autorizza l'accesso con il tuo account Addness)

claude mcp login addness

1. Verifica la connessione (se addness compare nell'elenco, hai finito. Puoi verificarlo anche tramite /mcp in Claude Code)

claude mcp list

Codex (CLI)

Ti basta accedere ad Addness nel browser per usarlo. Non serve creare una chiave API (le versioni precedenti di Codex non supportano OAuth, quindi aggiorna all'ultima versione prima di procedere).

1. Aggiungi Addness MCP (il browser si apre automaticamente: autorizza l'accesso con il tuo account Addness. Le impostazioni vengono salvate in ~/.codex/config.toml)

codex mcp add addness --url https://vt.api.addness.com/mcp

1. Verifica la connessione (se Auth indica OAuth, hai finito. Se l'accesso non è stato avviato, esegui codex mcp login addness)

codex mcp list

Cursor

1. Apri ~/.cursor/mcp.json e aggiungi la seguente configurazione (se sono già presenti altri server, aggiungi solo la voce addness)

{
  "mcpServers": {
    "addness": {
      "url": "https://vt.api.addness.com/mcp"
    }
  }
}

1. In Settings → Tools & MCP di Cursor, premi Connect per addness e autorizza l'accesso con il tuo account Addness nel browser

Claude Desktop

Aggiungi il server MCP remoto come connettore personalizzato, anziché tramite un file di configurazione.

1. Apri Customize → Connectors e scegli + → Add custom connector
2. Imposta il nome su Addness e l'URL su https://vt.api.addness.com/mcp, poi salva (per Team / Enterprise è necessaria la configurazione dell'organizzazione da parte dell'Owner)
3. Premi Connect per Addness e autorizza l'accesso nel browser (puoi attivarlo per ogni conversazione da Connectors)

Altri client compatibili con MCP

Puoi collegarti con qualsiasi client MCP che supporti Streamable HTTP e OAuth.

1. Imposta il nome del server su addness e il trasporto su Streamable HTTP
2. Specifica https://vt.api.addness.com/mcp come indirizzo di connessione
3. Accedi ad Addness dal pulsante di autenticazione del client: quando viene recuperato l'elenco degli strumenti, hai finito

Verifica la connessione

Chiedi alla tua IA: "Mostrami l'elenco delle mie organizzazioni in Addness". Se risponde con i nomi delle organizzazioni di cui fai parte, la connessione funziona. Puoi anche chiedere "Mostrami i miei ToDo in Addness" e controllare che restituisca i tuoi ToDo.

Se fai parte di più organizzazioni, prima di iniziare a lavorare chiedi all'IA: "Passa all'organizzazione 〈nome dell'organizzazione〉 in Addness". L'IA cambia l'organizzazione in cui lavora (switch_organization). Se è già collegata a quell'organizzazione, non cambia nulla. L'organizzazione scelta resta attiva anche nelle conversazioni successive con la stessa IA.

Se risponde che non ci sono strumenti di Addness o che serve l'autenticazione, consulta Se la connessione non funziona.

Per passare un obiettivo all'IA dalla schermata: "Chiedi all'IA"

Invece di formulare una richiesta a parole, puoi passare un obiettivo all'IA anche con il ✦ ("Chiedi all'IA") a destra della riga dell'obiettivo (su schermi delle dimensioni di uno smartphone, apri "…" → "Chiedi all'IA" nella riga).

• Procedi: L'IA legge il contesto dell'obiettivo e lo porta avanti direttamente
• Confronta le idee: L'IA mette ordine parlando con te e propone dei sotto-obiettivi. Vengono creati solo quelli che approvi
• Chiedi: Scrivi cosa vuoi sapere e invialo: l'IA legge l'obiettivo e risponde. L'obiettivo non viene modificato

Premi "Apri in Claude Code", "Apri in Codex" o "Apri in ChatGPT" per aprire l'IA con un'istruzione che include l'URL dell'obiettivo e le indicazioni su come procedere. Con "Copia istruzioni" puoi incollarla in un'altra IA, come Cursor. Se imposti la "Destinazione delle istruzioni" nella sezione "AI" delle impostazioni personali, l'IA si apre con un clic, senza dover scegliere ogni volta. Per una spiegazione dettagliata di cosa succede, consulta la pagina degli obiettivi.

Differenza con l’API delle integrazioni esterne

Con l’integrazione MCP la tua IA legge e scrive in Addness con il tuo account. Se ai tuoi sistemi basta leggere i membri e le attività di oggi della tua organizzazione, usa l’API delle integrazioni esterne (sola lettura), che si chiama con una chiave legata all’organizzazione. Le chiavi di integrazione esterna non funzionano con MCP. Questa API è disponibile solo per le organizzazioni abilitate da Addness.

Se la connessione non funziona

Ecco i problemi più comuni e come risolverli. Come installare l'app dell'IA e collegarla è spiegato in Installare un'app di IA e collegarla ad Addness.

Gli strumenti di Addness non sono disponibili

• Hai collegato l'IA, ma dice che non ci sono strumenti di Addness: Su un computer, in Claude Code o Codex, Subito dopo il collegamento, gli strumenti non compaiono finché non riapri l'app dell'IA. Esci dall'app, riaprila, seleziona la stessa conversazione e scrivi "continua". Chiudere la finestra non basta per uscire dall'app. Su Mac, esci con Command + Q. Su Windows, chiudi l'app con Alt + F4; se la sua icona resta in basso a destra dello schermo, fai clic destro sull'icona e scegli "Esci". Nel terminale, premi due volte Ctrl + C per uscire, poi torna alla stessa conversazione con claude --resume (per Codex, codex resume)
• Anche dopo averla riaperta, dice che non ci sono: A volte Claude Code carica gli strumenti di Addness solo quando deve usarli. Di' all'IA: "Cerca gli strumenti di Addness e usali"
• Chiede il permesso ogni volta che usa uno strumento e si ferma: Chiedi all'IA: "Imposta tutto in modo da poter usare gli strumenti di Addness senza chiedermi conferma ogni volta". In Claude Code, mcp__addness viene aggiunto all'elenco dei permessi nel file delle impostazioni (~/.claude/settings.json)
• Avevi rimosso gli strumenti di Addness per liberare contesto: Finché sono rimossi, l'IA non può leggere né gli obiettivi né i ToDo di Addness. Quando lavori con Addness, tienili collegati. Se li hai rimossi, chiedi all'IA "Riattiva gli strumenti di Addness" e riapri l'app
• Addness non compare in Claude o ChatGPT nel browser: Collega Addness tramite il plugin ufficiale in ChatGPT o tramite un connettore personalizzato in Claude dal browser. Vedi Usare Addness solo da telefono.

L'accesso non va avanti o la connessione si interrompe

• La schermata di accesso non si apre: Chiedi all'IA: "Avvia l'accesso ad Addness e mostrami l'URL". Incolla nel browser l'URL che compare, aprilo e premi "Consenti". Se la schermata con "Consenti" non compare o si apre un altro browser, consulta "Se qualcosa non funziona" in Installare un'app di IA e collegarla ad Addness
• Hai premuto "Consenti", ma compare un errore: Se la schermata di accesso resta aperta per un po', compare un errore come "Impossibile generare il codice di autorizzazione." Chiedi all'IA di avviare di nuovo l'accesso e premi subito "Consenti" nella schermata che si apre
• Prima funzionava, ma ora chiede di accedere o lo chiede di continuo: Il collegamento ad Addness scade dopo 90 giorni. Si interrompe prima dei 90 giorni nei casi seguenti. Se ti ricolleghi dalla stessa app di IA, il collegamento precedente di quell'app si interrompe. Ogni persona può avere fino a 20 collegamenti; oltre questo limite, si interrompe per primo quello inutilizzato da più tempo (se usi più computer o più IA, i collegamenti vecchi possono interrompersi per questo motivo). Chiedi all'IA "Accedi di nuovo ad Addness" e premi "Consenti" nel browser
• Hai confuso l'account di lavoro con quello personale: L'IA si collega all'account indicato con "Accesso effettuato come …" nella schermata "Connettiti ad Addness MCP". Controlla l'indirizzo email prima di premere "Consenti". Se hai collegato l'account sbagliato, accedi di nuovo ad Addness nel browser con l'account giusto, poi chiedi all'IA "Accedi di nuovo ad Addness"

L'IA è collegata a un'altra organizzazione

• L'IA dice "non trovato", oppure legge gli obiettivi di un'altra organizzazione: L'IA si collega all'organizzazione che avevi selezionato in Addness nel browser quando hai premuto "Consenti". Se fai parte di più organizzazioni, chiedi all'IA: "Passa all'organizzazione 〈nome dell'organizzazione〉 in Addness". Anche quando le dai l'URL di un obiettivo, falle prima cambiare organizzazione e passare a quella in cui si trova l'obiettivo

Si blocca su Windows

• Il collegamento con Codex o le richieste dallo smartphone si bloccano: A volte, se installi solo l'app Codex, sul computer non puoi usare il comando codex. Su Windows, in alcuni casi la causa era questa. Chiedi all'IA: "Controlla se il comando codex funziona e, se non funziona, installalo". Se premendo "Apri in Codex" Codex non si apre, premi "Copia istruzione", incollala in Codex e inviala
• Con Codex per Windows l'accesso ad Addness non si completa: Aggiorna Codex all'ultima versione e accedi di nuovo. Se ancora non si completa, puoi collegarti anche con Claude Code

<a id="mobile-only"></a>

Usare Addness solo da telefono

• App ChatGPT: Digita «@Addness» in ChatGPT o seleziona Addness dall’elenco delle app. Premi «Connetti», accedi ad Addness e premi «Consenti».
• App Claude: In Safari, apri claude.ai → Personalizza → Connettori → ＋Aggiungi → Aggiungi connettore personalizzato → nome Addness e URL https://vt.api.addness.com/mcp → Connetti e consenti. Attiva Addness nell’app Claude, incolla le istruzioni e inviale.
• Continua su un computer: Segui Le richieste dal telefono non arrivano per inviare lavoro all’IA sul tuo computer.

<a id="phone-pc-relay"></a>

Non riesci a fare richieste dallo smartphone

«Le richieste dal telefono non arrivano» spiega come inviare lavoro all’IA su un computer. Se usi solo il telefono, vedi «Usare Addness solo da telefono».

"Chiedi all'IA" nell'app Addness per smartphone invia la richiesta a Claude Code o Codex sul tuo computer. Sul computer deve essere installata l'app desktop di Addness (→ Versione web e app desktop), che deve restare aperta con l'accesso effettuato con lo stesso account Addness, e il computer non deve essere in sospensione. Usa anche la stessa organizzazione sullo smartphone e nell'app desktop. Per prepararlo, sul computer affida all'IA l'obiettivo "Affida compiti all'IA dal telefono": se ne occupa l'IA. Sui computer Windows aziendali, a volte non è possibile eseguire l'app desktop.

• Compare "L'IA del tuo computer non è ancora collegata": La preparazione del computer non è terminata. Apri Addness sul computer, premi "Chiedi all'IA" (✦) su "Affida compiti all'IA dal telefono" e completa i passaggi
• Resta "Partirà quando il PC si sveglia" e non succede nulla: Il computer è in sospensione, oppure l'app desktop è chiusa. Riattiva il computer e apri l'app: la richiesta parte. Dopo 24 ore, la richiesta viene annullata
• Compare "Codex non trovato sul PC": Il comando codex non è installato sul computer. Chiedi all'IA del computer "Installa il comando codex", poi riapri l'app desktop
• Usi il Codex incluso nell'app ChatGPT su Mac: L'app desktop non trova il Codex incluso nell'app ChatGPT. Chiedi all'IA del computer "Installa il comando codex", poi riapri l'app desktop (l'app desktop cerca Codex solo in .local/bin nella tua cartella Inizio e nei percorsi in cui il terminale cerca i comandi)
• Compare "Scegli una cartella di lavoro in Addness sul PC" o "Nessuna cartella di lavoro scelta in Addness sul PC": Apri "リモート操作" (Controllo remoto) nelle impostazioni dell'app desktop sul computer e scegli in alto, in "作業フォルダ" (Cartella di lavoro), la cartella in cui l'IA deve lavorare. Finché non la scegli, le richieste non arrivano né a Claude Code né a Codex
• Compare "Aggiorna Addness sul PC": L'app desktop sul computer è una versione vecchia. Aggiornala all'ultima versione e invia di nuovo
• Compare "“Accetta dal telefono” per Codex è disattivato in Addness sul PC": Apri "リモート操作" (Controllo remoto) nelle impostazioni dell'app desktop sul computer e attiva "スマホから受け付ける" (Accetta dal telefono) nella sezione "Codex" (scegli prima una "作業フォルダ" (Cartella di lavoro))
• La richiesta non arriva a Claude Code: Controlla di aver effettuato l'accesso all'app Claude dello smartphone con lo stesso account Claude del computer

Ancora nessuna connessione

• Nessun passaggio permette di collegarsi: Un antivirus o la rete aziendale potrebbero bloccare la comunicazione con Addness. In alcuni casi il collegamento ha funzionato dopo aver escluso vt.api.addness.com dalla scansione nelle impostazioni del software. Se usi un computer aziendale, rivolgiti al reparto IT
• Anche così non vai avanti: Allega uno screenshot della schermata in cui si è bloccato e contattaci da "Domande su Addness" nella pagina iniziale della guida