O ActionBridge mantém um único servidor MCP (Model Context Protocol — um padrão aberto que permite que assistentes de IA se conectem a aplicativos) para toda a família AB: assistentes como Claude, ChatGPT, Cursor, Windsurf, Codex CLI e Antigravity podem ler e gerenciar suas tarefas e documentos do AB Projects e o seu funil do AB Sales. A configuração se resume a uma URL e um login — e a URL é a etapa em que as pessoas mais erram.
https://mcp.actionbridge.io/mcp — o caminho /mcp é obrigatório. O host sem caminho (https://mcp.actionbridge.io) não é um endpoint MCP válido; ao informá-lo, o cliente relata uma falha de autorização mesmo tendo alcançado o servidor. Esse único erro de digitação causa a maioria das configurações que falham.Antes de começar
- Uma conta AB existente. Se você ainda não tem uma, configure-a primeiro pelo Microsoft Teams (consulte Plataformas compatíveis).
- A URL do servidor:
https://mcp.actionbridge.io/mcp - Sua conta corporativa ou de estudante do Microsoft 365, ou seu e-mail e senha do AB, para fazer login.
A mesma configuração também está documentada em actionbridge.io/pt-BR/mcp.
Onde informar a URL, por cliente
| Cliente | Onde | Observações |
|---|---|---|
| Claude Desktop | Settings → Connectors → Add Custom Connector | O login abre numa janela do navegador |
| Claude Cowork | Configuração de MCP | Mesmo login OAuth do Claude Desktop |
| ChatGPT | Settings → Connectors → Add custom connector | Exige uma assinatura Plus, Pro, Business ou Enterprise |
| Cursor / Windsurf / Codex CLI / Antigravity | O arquivo de configuração JSON de MCP da ferramenta | Não é preciso client ID nem secret — o OAuth cuida disso |
Claude Desktop
- Abra a lista de conectores. Claude Desktop → Settings → Connectors → Add Custom Connector.
- Informe os dados. Nome:
ActionBridge· URL:https://mcp.actionbridge.io/mcp - Clique em Connect. Uma janela do navegador se abre pedindo que você faça login.
- Faça login com a Microsoft, ou com seu e-mail e senha do AB.
- Pronto. O Claude Desktop se registra automaticamente e lista as ferramentas do AB.
Claude Cowork
No Cowork, abra sua configuração de MCP e adicione:
URL: https://mcp.actionbridge.io/mcp
Auth: OAuth (automatic)O Cowork abre uma janela do navegador na primeira vez que se conecta, usando o mesmo login do Claude Desktop.
ChatGPT
- Abra os conectores. ChatGPT → Settings → Connectors → Add custom connector (exige um plano Plus, Pro, Business ou Enterprise).
- Informe os dados. Nome:
ActionBridge· MCP Server URL:https://mcp.actionbridge.io/mcp— confira se o caminho/mcpestá incluído. - Clique em Connect e faça login com a Microsoft ou com seu e-mail e senha do AB.
- Pronto. O ChatGPT volta à lista de conectores com o ActionBridge exibido como conectado.
Cursor, Codex CLI, Windsurf e Antigravity
Esses editores usam um arquivo de configuração JSON para servidores MCP. O formato ao redor varia conforme a ferramenta, mas o bloco do servidor é o mesmo:
{
"mcpServers": {
"actionbridge": {
"url": "https://mcp.actionbridge.io/mcp"
}
}
}Na primeira vez que o editor se conecta, ele abre uma janela do navegador para que você faça login. Não é preciso client ID nem secret.
O que você ganha depois de conectar
- Ferramentas — ferramentas
ab_*para o AB Projects (tarefas, agenda, Documentos) e ferramentasab_crm_*para o AB Sales (leads, oportunidades, atividades). A lista completa está na Referência de ferramentas MCP. - Prompts — comandos de barra prontos (como
ab-standuppara um resumo diário) que aparecem nos clientes compatíveis com prompts MCP. - Recursos — feeds somente leitura (suas tarefas de hoje, desta semana, seus projetos) que o cliente pode buscar como contexto de fundo.
Como gerenciar seu acesso via MCP
Quando você conecta um cliente, o ActionBridge emite automaticamente uma chave de API (um token de acesso privado) nos bastidores, restrita à sua conta — o assistente age somente como você e somente sobre dados que você já pode ver (consulte Quem pode ver o quê).
- Para desconectar um cliente: remova o conector do ActionBridge nesse cliente de IA (exclua o conector personalizado no Claude/ChatGPT, ou remova o bloco do servidor da configuração do editor). Se for adicionado de novo, ele precisará fazer login outra vez.
- Para revogar o acesso no servidor (por exemplo, se um dispositivo foi perdido): entre em contato com support@actionbridge.io — ainda não há uma tela de autogerenciamento de chaves.
- Tudo o que um assistente faz é auditável: cada alteração é registrada no histórico de alterações do item e publicada no canal do Teams vinculado, deixando claro que foi feita por IA.
Solução de problemas
“Não foi possível alcançar o servidor MCP”
Quase sempre é a URL errada. Confirme que você usou https://mcp.actionbridge.io/mcp (não o host sem caminho), digitou https:// (não http://) e que não há barras no final, espaços ou caracteres extras.
“A autorização com o servidor MCP falhou”
- Confira de novo se a URL inclui
/mcp. Apontado para o host sem caminho, o login funciona, mas a primeira chamada cai na página de verificação de integridade, e o cliente relata “authorization failed”. - Se você fez login com a Microsoft, esse e-mail da Microsoft precisa corresponder a uma conta AB existente — novos usuários devem se configurar primeiro pelo Microsoft Teams.
- Se o problema persistir, remova e adicione o conector de novo para começar um novo login.
Conectado, mas nenhuma ferramenta aparece
Atualize a lista de ferramentas do cliente. Continua vazia? Remova e adicione o conector de novo — o primeiro handshake pode ter coincidido com o login.
Ainda com problemas? Entre em contato com support@actionbridge.io. Se o seu cliente de IA mostrar um código de referência — por exemplo ofid_... do ChatGPT, ou qualquer ID de requisição — inclua-o: com ele, a equipe localiza a sessão exata nos logs do servidor.