Referenční příručka MCP nástrojů

atbridge mcp spouští server Model Context Protocol přes stdio a zpřístupňuje vaše e-maily, kalendáře, kontakty, poznámky a úkoly z Thunderbirdu jako nástroje, které může AI klient volat. Název serveru v konfiguraci klienta je atbridge.ai.

// V konfiguraci vašeho MCP klienta (viz stránky nastavení Připojte svou AI)
{
  "mcpServers": {
    "atbridge.ai": { "command": "atbridge", "args": ["mcp"] }
  }
}

Nástroje podle oblastí

Každá stránka uvádí čtecí nástroje dané oblasti (vždy zapnuté) a zapisovací nástroje (dobrovolně zapínané — viz níže).

mail Stažení, hledání, výpis, získání, vlákno, přílohy — a odeslání, odpověď, přeposlání, přesun, mazání, označení, složky.

calendar Události, kontrola kolizí, hledání termínů, nastavení — a vytvoření, úprava, mazání, RSVP.

contacts Kontakty a distribuční seznamy napříč všemi adresáři.

notes @bridge Poznámky — načtěte artefakt jako kontext, nebo jej uložte zpět.

tasks Úkoly (VTODO) ve vašich kalendářích s podporou úkolů.

AI — E-mail se značkou Vykreslete @bridge E-mail se značkou; vypište a uložte šablony.

systém — účty, licence, aktualizace Vyberte identitu odesílatele; předplatné, zařízení, stav aktualizací.

Čtení vs. zápis

Čtecí nástroje jsou vždy registrovány; bez nutnosti zapínat. Číselná id a RFC Message-ID jsou zaměnitelné všude, kde je přijímán identifier.

Stránkování a počítání — každý nástroj pro výpis/hledání (mail_search/mail_list, contacts_list/contacts_search, calendar_events_search, tasks_list, notes_list) přijímá offset (přeskočí prvních N; v páru s limit pro stránkování — offset:20, limit:20 = výsledky 21–40) a count: true (vrátí { total, approx } pro stejné filtry místo položek). Počty jsou přesné pro kontakty/kalendář/úkoly/poznámky; orientační pro poštu (pro přesné číslo omezte pomocí folder/since/until — signalizováno pomocí approx).

Úsporné výsledky a výtah — mail_search a mail_list vracejí ve výchozím nastavení úsporné řádky: id, datum, od/komu, předmět, přečteno/označeno — dost na to, abyste vybrali zprávu bez nadměrného načítání. Přidejte snippet: true pro ~200znakový výtah v prostém textu u každého výsledku (očištěný od značek citací a šumu oddělovačů, takže jednořádkové shrnutí nevyžaduje následné mail_get), nebo verbose: true pro úplná směrovací metadata (headerMessageId, folderLabel, accountName, conversationId). Cokoli dalšího získáte jediným voláním mail_get podle id.

Zapisovací nástroje se registrují pouze při nastavení ATBRIDGE_ALLOW_WRITES=1 v env MCP záznamu, takže agent nemůže nic odeslat ani smazat, dokud to nezapnete. Zapněte to pomocí atbridge mcp setup --client <id> --allow-writes nebo přepínačem Povolit zápisy v nastavení rozšíření Připojte svou AI (MCP) a poté restartujte klienta.

Nástroje pro správu — nástroje pro účty a systém (fakturace, zařízení, verze, automatické aktualizace) se registrují pouze při nastavení ATBRIDGE_ADMIN_TOOLS=1 (ve výchozím stavu vypnuto). Pro každodenní práci s poštou/kalendářem je téměř nikdy nepotřebujete, takže když je necháte vypnuté, zůstává výchozí sada nástrojů úsporná; zapněte je stejným způsobem, jako povolujete zápisy, když chcete, aby AI zkontrolovala vaše předplatné nebo spustila aktualizaci.

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

Viz také

Připojte svou AI — zapojení MCP klienta (Claude Desktop, Cursor)
Referenční příručka CLI — stejné operace jako příkazy v terminálu
Když AI říká „žádné nástroje“

Was this page helpful?