Ligar o atbridge.ai ao Claude Desktop

Em resumo: o Claude Desktop contacta o atbridge.ai por MCP. Adicione uma entrada MCP atbridge à configuração do Claude Desktop — execute atbridge mcp setup --client claude, ou cole o excerto abaixo — depois encerre totalmente e reinicie o Claude Desktop. Cerca de dois minutos.

Se ainda não instalou o atbridge.ai, comece por Instalar o atbridge.ai.

O Claude Desktop não consegue executar comandos de terminal por si só, por isso comunica com o atbridge.ai por uma ligação MCP — é isso que vai configurar abaixo. Novo nisto? Consulte Como a sua IA se liga para a visão geral de dois minutos.

O Claude Desktop a trabalhar a caixa de entrada através do atbridge.ai por MCP.

Uma vez ligado, pode até criar uma skill — como uma agenda diária que reúne o seu correio não lido e o calendário num único resumo. Consulte Onde pode usar o atbridge.ai para a ideia.

1. Abrir o ficheiro de definições do Claude Desktop

No Claude Desktop, vá a Definições → Programador → Editar Configuração. Isso abre um ficheiro chamado claude_desktop_config.json no seu editor.

2. Adicionar o atbridge.ai

Se o ficheiro estiver vazio, cole isto:

{
  "mcpServers": {
    "atbridge": {
      "command": "atbridge",
      "args": ["mcp"]
    }
  }
}

Se já tiver outras ferramentas configuradas, basta adicionar a entrada atbridge dentro do bloco mcpServers existente:

{
  "mcpServers": {
    "filesystem": { /* ... */ },
    "atbridge": {
      "command": "atbridge",
      "args": ["mcp"]
    }
  }
}

3. Reiniciar o Claude Desktop

Encerre totalmente a aplicação — Cmd-Q no macOS, Ficheiro → Sair no Windows. Fechar apenas a janela não chega.

Reabra-a. Vá a Definições → Programador → Servidores MCP — deverá ver o atbridge listado com um ponto de estado verde.

4. Experimentar

Num novo chat:

Lista os 5 e-mails mais recentes na minha caixa de entrada do Thunderbird.

Se vir uma lista, está pronto.

5. Deixar o atbridge.ai redigir, enviar e editar (opcional)

Por defeito, o MCP do atbridge.ai é apenas de leitura — pode pesquisar, ler e resumir, mas não pode enviar, redigir, mover ou eliminar nada. É um padrão de segurança deliberado: uma IA não deve poder enviar ou destruir correio a menos que o ative explicitamente. (Se pedir ao Claude para redigir ou enviar enquanto isto está desativado, ele dir-lhe-á que as ferramentas de escrita existem mas estão desativadas — e como as ativar.)

Para desbloquear as ferramentas de escrita — mail_send (incluindo rascunhos via mode), responder, reencaminhar, mover, eliminar, além de edições de contactos e calendário — adicione um bloco env:

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

Encerre totalmente e reinicie o Claude Desktop, depois experimente:

Redige uma resposta ao último e-mail do Alex a agradecer-lhe e a propor quinta-feira.

Quando não funciona

”Sem ferramentas do atbridge.ai” ou ponto de estado vermelho

A causa mais comum: o Claude Desktop não consegue encontrar o comando atbridge.ai. Resolva indicando o caminho absoluto:

Windows
macOS / Linux

Encontre o caminho:

(Get-Command atbridge).Source

Depois use-o no claude_desktop_config.json:

"command": "C:\\Users\\you\\AppData\\Local\\Programs\\atbridge\\atbridge.exe"

Repare nas barras invertidas duplicadas — o JSON exige-o.

Encontre o caminho:

which atbridge

Depois use-o:

"command": "/usr/local/bin/atbridge"

Guarde, encerre totalmente o Claude e reinicie.

”Bridge inacessível” na primeira chamada de ferramenta

Isso significa que o Thunderbird não está a correr. Abra-o e depois volte a pedir.

”Atingiu o limite mensal do seu plano”

Verifique o seu uso:

atbridge license status --pretty

Atualize o plano ou aguarde pela reposição do mês seguinte (indicada no mesmo resultado).

Para onde ir a seguir

Experimente uma receita — fluxos de trabalho prontos a usar

Was this page helpful?