Collega atbridge.ai a Claude Desktop

In breve: Claude Desktop raggiunge atbridge.ai tramite MCP. Aggiungi una voce MCP atbridge alla configurazione di Claude Desktop — esegui atbridge mcp setup --client claude, o incolla lo snippet qui sotto — poi chiudi completamente e riavvia Claude Desktop. Circa due minuti.

Se non hai ancora installato atbridge.ai, inizia con Installa atbridge.ai.

Claude Desktop non può eseguire comandi da terminale da solo, quindi dialoga con atbridge.ai tramite una connessione MCP — è ciò che configurerai qui sotto. Nuovo a come funziona? Vedi Come si collega la tua IA per la panoramica di due minuti.

Claude Desktop che lavora la casella tramite atbridge.ai su MCP.

Una volta collegato puoi persino creare uno skill — come un’agenda giornaliera che riunisce la tua posta non letta e il calendario in un unico briefing. Vedi Dove puoi usare atbridge.ai per l’idea.

1. Apri il file delle impostazioni di Claude Desktop

In Claude Desktop, vai su Settings → Developer → Edit Config. Questo apre un file chiamato claude_desktop_config.json nel tuo editor.

2. Aggiungi atbridge.ai

Se il file è vuoto, incolla questo:

{
  "mcpServers": {
    "atbridge": {
      "command": "atbridge",
      "args": ["mcp"]
    }
  }
}

Se hai già altri strumenti configurati, aggiungi semplicemente la voce atbridge dentro il blocco mcpServers esistente:

{
  "mcpServers": {
    "filesystem": { /* ... */ },
    "atbridge": {
      "command": "atbridge",
      "args": ["mcp"]
    }
  }
}

3. Riavvia Claude Desktop

Chiudi completamente l’app — Cmd-Q su macOS, File → Quit su Windows. Chiudere solo la finestra non basta.

Riavviala. Vai su Settings → Developer → MCP Servers — dovresti vedere atbridge elencato con un pallino di stato verde.

4. Provalo

In una nuova chat:

Elenca le 5 email più recenti nella mia casella Thunderbird.

Se vedi un elenco, hai finito.

5. Lascia che atbridge.ai componga, invii e modifichi (opzionale)

Per impostazione predefinita l’MCP di atbridge.ai è di sola lettura — può cercare, leggere e riassumere, ma non può inviare, creare bozze, spostare o eliminare nulla. È un’impostazione di sicurezza deliberata: un’IA non dovrebbe poter inviare o distruggere posta a meno che tu non lo attivi esplicitamente. (Se chiedi a Claude di creare una bozza o inviare mentre questo è disattivato, ti dirà che gli strumenti di scrittura esistono ma sono disabilitati — e come abilitarli.)

Per sbloccare gli strumenti di scrittura — mail_send (comprese le bozze tramite mode), rispondi, inoltra, sposta, elimina, più le modifiche a contatti e calendario — aggiungi un blocco env:

{
  "mcpServers": {
    "atbridge": {
      "command": "atbridge",
      "args": ["mcp"],
      "env": { "ATBRIDGE_ALLOW_WRITES": "1" }
    }
  }
}

Chiudi completamente e riavvia Claude Desktop, poi prova:

Scrivi una bozza di risposta all’ultima email di Alex per ringraziarlo e proporre giovedì.

Quando non funziona

«Nessuno strumento atbridge.ai» o pallino di stato rosso

La causa più comune: Claude Desktop non trova il comando atbridge.ai. Risolvilo indicando il percorso assoluto:

Windows
macOS / Linux

Trova il percorso:

(Get-Command atbridge).Source

Poi usalo in claude_desktop_config.json:

"command": "C:\\Users\\you\\AppData\\Local\\Programs\\atbridge\\atbridge.exe"

Nota le barre rovesciate doppie — JSON lo richiede.

Trova il percorso:

which atbridge

Poi usalo:

"command": "/usr/local/bin/atbridge"

Salva, chiudi completamente Claude, riavvia.

«Bridge non raggiungibile» alla prima chiamata di strumento

Significa che Thunderbird non è in esecuzione. Aprilo, poi chiedi di nuovo.

«Hai raggiunto il limite mensile del tuo piano»

Controlla il tuo utilizzo:

atbridge license status --pretty

Fai l’upgrade o aspetta l’azzeramento del mese successivo (mostrato nello stesso output).

Dove andare dopo

Prova una ricetta — flussi di lavoro predefiniti

Was this page helpful?