Dokumentacja narzędzi MCP

atbridge mcp uruchamia serwer Model Context Protocol przez stdio, udostępniając Twoje e-maile, kalendarze, kontakty, notatki i zadania z Thunderbirda jako narzędzia, które może wywołać klient AI. Nazwa serwera w konfiguracji klienta to atbridge.ai.

// W konfiguracji Twojego klienta MCP (zobacz strony konfiguracji Podłącz swoją AI)
{
  "mcpServers": {
    "atbridge.ai": { "command": "atbridge", "args": ["mcp"] }
  }
}

Narzędzia według obszarów

Każda strona wymienia narzędzia odczytu danego obszaru (zawsze włączone) oraz narzędzia zapisu (opcjonalne — zobacz poniżej).

mail Pobieranie, wyszukiwanie, lista, pobranie, wątek, załączniki — oraz wysyłanie, odpowiadanie, przekazywanie, przenoszenie, usuwanie, oznaczanie, foldery.

calendar Wydarzenia, wykrywanie kolizji, wyszukiwanie terminów, ustawienia — oraz tworzenie, aktualizacja, usuwanie, RSVP.

contacts Kontakty + listy mailingowe we wszystkich książkach adresowych.

notes @bridge Notatki — wciągnij artefakt jako kontekst lub zapisz go z powrotem.

tasks Zadania (VTODO) w kalendarzach obsługujących zadania.

AI — Branded Email Renderuj @bridge Branded Email; wyświetlaj i zapisuj szablony.

system — konta, licencja, aktualizacje Wybierz tożsamość nadawcy; subskrypcja, urządzenia, stan aktualizacji.

Odczyt kontra zapis

Narzędzia odczytu są zawsze zarejestrowane; bez opcji włączania. Identyfikatory numeryczne i Message-ID według RFC są wymienne wszędzie tam, gdzie akceptowany jest identifier.

Stronicowanie i zliczanie — każde narzędzie listujące/wyszukujące (mail_search/mail_list, contacts_list/contacts_search, calendar_events_search, tasks_list, notes_list) przyjmuje offset (pomiń pierwsze N; w parze z limit, aby stronicować — offset:20, limit:20 = wyniki 21–40) oraz count: true (zwraca { total, approx } dla tych samych filtrów zamiast elementów). Liczby są dokładne dla kontaktów/kalendarza/zadań/notatek; przybliżone dla poczty (zawęź przez folder/since/until, aby uzyskać dokładną liczbę — sygnalizowaną przez approx).

Oszczędne wyniki i sedno — mail_search i mail_list zwracają domyślnie oszczędne wiersze: id, data, od/do, temat, przeczytane/oflagowane — wystarczająco, aby wybrać wiadomość bez nadmiernego pobierania. Dodaj snippet: true, aby uzyskać ~200-znakowe sedno w postaci zwykłego tekstu dla każdego wyniku (oczyszczone ze znaczników cytowania i szumu separatorów, więc jednowierszowe podsumowanie nie wymaga kolejnego mail_get), albo verbose: true, aby uzyskać pełne metadane routingu (headerMessageId, folderLabel, accountName, conversationId). Wszystko inne to jeden mail_get po id.

Narzędzia zapisu są rejestrowane tylko wtedy, gdy w env wpisu MCP ustawiono ATBRIDGE_ALLOW_WRITES=1, więc agent nie może niczego wysłać ani zniszczyć, dopóki tego nie włączysz. Włącz to za pomocą atbridge mcp setup --client <id> --allow-writes albo przełącznika Zezwól na zapis w ustawieniach rozszerzenia Podłącz swoją AI (MCP), a następnie zrestartuj klienta.

Narzędzia administracyjne — narzędzia konta/systemu (rozliczenia, urządzenia, wersja, automatyczne aktualizacje) są rejestrowane tylko wtedy, gdy ustawiono ATBRIDGE_ADMIN_TOOLS=1 (domyślnie wyłączone). Niemal nigdy nie są potrzebne w codziennej pracy z pocztą/kalendarzem, więc pozostawienie ich wyłączonymi utrzymuje domyślny zestaw narzędzi oszczędnym; włącz je w ten sam sposób, w jaki włączasz zapis, gdy chcesz, aby AI sprawdziła Twoją subskrypcję lub uruchomiła aktualizację.

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

Zobacz też

Podłącz swoją AI — podłączanie klienta MCP (Claude Desktop, Cursor)
Dokumentacja CLI — te same operacje jako polecenia terminala
Gdy AI mówi „brak narzędzi”

Was this page helpful?