MCP-Tool-Referenz

atbridge mcp startet einen Model-Context-Protocol-Server über stdio und stellt deine Thunderbird-E-Mails, -Kalender, -Kontakte, -Notizen und -Aufgaben als Tools bereit, die ein KI-Client aufrufen kann. Der Servername in der Konfiguration eines Clients lautet atbridge.ai.

// In der Konfiguration deines MCP-Clients (siehe die Setup-Seiten „Verbinde deine KI")
{
  "mcpServers": {
    "atbridge.ai": { "command": "atbridge", "args": ["mcp"] }
  }
}

Tools nach Bereich

Jede Seite listet die Lese-Tools des jeweiligen Bereichs (immer aktiv) und die Schreib-Tools (zum Aktivieren — siehe unten) auf.

mail Abrufen, suchen, auflisten, holen, Thread, Anhänge — und senden, antworten, weiterleiten, verschieben, löschen, markieren, Ordner.

calendar Termine, Konfliktprüfung, freie Zeitfenster finden, Einstellungen — und erstellen, aktualisieren, löschen, Zu-/Absage.

contacts Kontakte + Verteilerlisten über jedes Adressbuch hinweg.

notes @bridge Notizen — eine Notiz als Kontext einbinden oder eine zurückspeichern.

tasks Aufgaben (VTODO) auf deinen aufgabenfähigen Kalendern.

AI — Branded Email @bridge Branded Email rendern; Vorlagen auflisten & speichern.

system — accounts, license, updates Eine Absenderidentität wählen; Abonnement, Geräte, Update-Status.

Lesen vs. Schreiben

Lese-Tools sind immer registriert; keine Aktivierung nötig. Numerische IDs und RFC-Message-IDs sind überall dort austauschbar, wo ein identifier akzeptiert wird.

Paginierung & Zählen — jedes Auflisten-/Such-Tool (mail_search/mail_list, contacts_list/contacts_search, calendar_events_search, tasks_list, notes_list) akzeptiert offset (überspringe die ersten N; kombiniere mit limit zum Blättern — offset:20, limit:20 = Ergebnisse 21–40) und count: true (gibt { total, approx } für dieselben Filter statt der Elemente zurück). Zählungen sind exakt für Kontakte/Kalender/Aufgaben/Notizen; nach bestem Bemühen für Mail (grenze mit folder/since/ until ein, um eine exakte Zahl zu erhalten — angezeigt durch approx).

Schlanke Ergebnisse & Kurzfassung — mail_search und mail_list geben standardmäßig schlanke Zeilen zurück: id, Datum, Von/An, Betreff, gelesen/markiert — genug, um eine Nachricht auszuwählen, ohne zu viel abzurufen. Ergänze snippet: true für eine ~200 Zeichen lange Klartext-Kurzfassung pro Ergebnis (bereinigt von Zitatmarkierungen und Trennzeichen-Rauschen, sodass eine einzeilige Zusammenfassung kein weiteres mail_get benötigt), oder verbose: true für die vollständigen Routing-Metadaten (headerMessageId, folderLabel, accountName, conversationId). Alles Weitere ist nur ein mail_get per id entfernt.

Schreib-Tools werden nur registriert, wenn ATBRIDGE_ALLOW_WRITES=1 im env des MCP-Eintrags gesetzt ist, sodass ein Agent nichts senden oder löschen kann, solange du es nicht aktivierst. Aktiviere es mit atbridge mcp setup --client <id> --allow-writes oder dem Schalter Allow writes in den Verbinde deine KI (MCP)-Einstellungen der Erweiterung und starte den Client dann neu.

Admin-Tools — die Konto-/System-Tools (Abrechnung, Geräte, Version, Auto-Update) werden nur registriert, wenn ATBRIDGE_ADMIN_TOOLS=1 gesetzt ist (standardmäßig aus). Sie werden für die alltägliche Mail-/Kalenderarbeit ~nie benötigt, sodass ihr Weglassen die Standard-Tool-Oberfläche schlank hält; aktiviere sie genauso, wie du Schreibzugriffe aktivierst, wenn die KI dein Abonnement prüfen oder ein Update auslösen soll.

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

Siehe auch

Verbinde deine KI — einen MCP-Client einrichten (Claude Desktop, Cursor)
CLI-Referenz — dieselben Vorgänge als Terminal-Befehle
Wenn die KI „keine Tools” sagt

Was this page helpful?