Referência de ferramentas MCP

O atbridge mcp executa um servidor Model Context Protocol via stdio, expondo os seus e-mails, calendários, contactos, notas e tarefas do Thunderbird como ferramentas que um cliente de IA pode invocar. O nome do servidor na configuração de um cliente é atbridge.ai.

// Na configuração do seu cliente MCP (ver as páginas de configuração Ligue a sua IA)
{
  "mcpServers": {
    "atbridge.ai": { "command": "atbridge", "args": ["mcp"] }
  }
}

Ferramentas por área

Cada página lista as ferramentas de leitura dessa área (sempre ativas) e as de escrita (opcionais — ver abaixo).

mail Obter, pesquisar, listar, ler, conversa, anexos — e enviar, responder, reencaminhar, mover, eliminar, marcar, pastas.

calendar Eventos, verificação de conflitos, procura de horários, definições — e criar, atualizar, eliminar, RSVP.

contacts Contactos + listas de distribuição em todos os livros de endereços.

notes @bridge Notes — traga um artefacto como contexto, ou guarde um de volta.

tasks Tarefas (VTODO) nos seus calendários com suporte para tarefas.

AI — Branded Email Renderize @bridge Branded Email; liste & guarde modelos.

system — accounts, license, updates Escolha uma identidade de remetente; subscrição, dispositivos, estado das atualizações.

Leitura vs. escrita

As ferramentas de leitura estão sempre registadas; sem opção. IDs numéricos e Message-IDs RFC são intercambiáveis sempre que um identifier é aceite.

Paginação & contagem — cada ferramenta de listagem/pesquisa (mail_search/mail_list, contacts_list/contacts_search, calendar_events_search, tasks_list, notes_list) aceita offset (salta os primeiros N; combine com limit para paginar — offset:20, limit:20 = resultados 21–40) e count: true (devolve { total, approx } para os mesmos filtros em vez dos itens). As contagens são exatas para contactos/calendário/tarefas/notas; melhor-esforço para o correio (delimite com folder/since/ until para um valor exato — indicado por approx).

Resultados enxutos & essência — o mail_search e o mail_list devolvem linhas enxutas por defeito: id, data, de/para, assunto, lido/sinalizado — o suficiente para escolher uma mensagem sem obter dados a mais. Adicione snippet: true para uma essência em texto simples de ~200 caracteres por resultado (limpa de marcas de citação e ruído de separadores, para que um resumo de uma linha dispense um mail_get de seguimento), ou verbose: true para os metadados de encaminhamento completos (headerMessageId, folderLabel, accountName, conversationId). Tudo o resto está a um mail_get por id de distância.

As ferramentas de escrita só são registadas quando ATBRIDGE_ALLOW_WRITES=1 está definido no env da entrada MCP, para que um agente não possa enviar nem destruir nada a menos que o ative. Ative-o com atbridge mcp setup --client <id> --allow-writes, ou com o interruptor Allow writes nas definições Ligue a sua IA (MCP) da extensão, e depois reinicie o cliente.

Ferramentas de administração — as ferramentas de conta/sistema (faturação, dispositivos, versão, autoatualização) são registadas apenas quando ATBRIDGE_ADMIN_TOOLS=1 está definido (desativado por defeito). Quase nunca são necessárias para o trabalho diário de correio/calendário, por isso deixá-las desativadas mantém o conjunto de ferramentas por defeito enxuto; ative-as da mesma forma que ativa as escritas quando quiser que a IA verifique a sua subscrição ou acione uma atualização.

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

Ver também

Ligue a sua IA — ligar um cliente MCP (Claude Desktop, Cursor)
Referência da CLI — as mesmas operações como comandos de terminal
Quando a IA diz «sem ferramentas»

Was this page helpful?