Riferimento strumenti MCP

atbridge mcp esegue un server Model Context Protocol su stdio, esponendo le tue email, i calendari, i contatti, le note e le attività di Thunderbird come strumenti che un client IA può richiamare. Il nome del server nella configurazione di un client è atbridge.ai.

// Nella configurazione del tuo client MCP (vedi le pagine di configurazione Connetti la tua IA)
{
  "mcpServers": {
    "atbridge.ai": { "command": "atbridge", "args": ["mcp"] }
  }
}

Strumenti per area

Ogni pagina elenca gli strumenti di lettura di quell’area (sempre attivi) e quelli di scrittura (da abilitare — vedi sotto).

mail Recupera, cerca, elenca, ottieni, conversazione, allegati — e invia, rispondi, inoltra, sposta, elimina, contrassegna, cartelle.

calendar Eventi, rilevamento conflitti, ricerca slot, impostazioni — e crea, aggiorna, elimina, RSVP.

contacts Contatti + liste di distribuzione in tutte le rubriche.

notes @bridge Notes — recupera un artefatto come contesto, o salvane uno.

tasks Attività da fare (VTODO) sui calendari che le supportano.

AI — Branded Email Genera @bridge Branded Email; elenca e salva modelli.

system — accounts, license, updates Scegli un'identità mittente; abbonamento, dispositivi, stato aggiornamenti.

Lettura vs scrittura

Gli strumenti di lettura sono sempre registrati; nessuna abilitazione. Gli id numerici e i Message-ID RFC sono intercambiabili ovunque sia accettato un identifier.

Paginazione e conteggio — ogni strumento di elenco/ricerca (mail_search/mail_list, contacts_list/contacts_search, calendar_events_search, tasks_list, notes_list) accetta offset (salta i primi N; abbinalo a limit per paginare — offset:20, limit:20 = risultati 21–40) e count: true (restituisce { total, approx } per gli stessi filtri invece degli elementi). I conteggi sono esatti per contatti/calendario/attività/note; approssimativi per la posta (restringi con folder/since/ until per un valore esatto — indicato da approx).

Risultati snelli e sintesi — mail_search e mail_list restituiscono righe snelle per impostazione predefinita: id, data, da/a, oggetto, letto/contrassegnato — abbastanza per scegliere un messaggio senza recuperare più del necessario. Aggiungi snippet: true per una sintesi in testo semplice di ~200 caratteri per risultato (ripulita dai marcatori di citazione e dal rumore dei separatori, così un riepilogo di una riga non richiede un successivo mail_get), oppure verbose: true per i metadati di instradamento completi (headerMessageId, folderLabel, accountName, conversationId). Tutto il resto dista un solo mail_get per id.

Gli strumenti di scrittura vengono registrati solo quando è impostato ATBRIDGE_ALLOW_WRITES=1 nell’env della voce MCP, così un agente non può inviare o distruggere nulla se non lo attivi tu. Abilitalo con atbridge mcp setup --client <id> --allow-writes, oppure con l’interruttore Allow writes nelle impostazioni Connetti la tua IA (MCP) dell’estensione, poi riavvia il client.

Strumenti di amministrazione — gli strumenti di account/sistema (fatturazione, dispositivi, versione, auto-aggiornamento) vengono registrati solo quando è impostato ATBRIDGE_ADMIN_TOOLS=1 (disattivato per impostazione predefinita). Non servono ~mai per il lavoro quotidiano con email/calendario, quindi lasciarli disattivati mantiene snella la superficie di strumenti predefinita; attivali nello stesso modo in cui abiliti le scritture quando vuoi che l’IA controlli il tuo abbonamento o avvii un aggiornamento.

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

Vedi anche

Connetti la tua IA — collegare un client MCP (Claude Desktop, Cursor)
Riferimento CLI — le stesse operazioni come comandi da terminale
Quando l’IA dice «nessuno strumento»

Was this page helpful?