Conectando assistentes de IA via MCP

O AB Projects expõe um servidor Model Context Protocol (MCP) para que assistentes de IA — Claude, ChatGPT, Cursor, Windsurf, Codex CLI, Antigravity e qualquer outro cliente MCP compatível com a especificação — possam ler e gerenciar suas tarefas, projetos e documentos em seu nome. Este artigo explica como conectar cada cliente.

O que você precisa antes de começar

Uma conta existente do AB Projects. Se você ainda não tiver uma, configure-a primeiro pelo Microsoft Teams (consulte Instalando o aplicativo AB Projects para Teams).
A URL do servidor MCP: https://mcp.actionbridge.io/mcp
Sua conta do Microsoft 365, ou seu e-mail e senha do AB Projects, para fazer login.

Importante: a URL é https://mcp.actionbridge.io/mcp — inclua o caminho /mcp. O host sem caminho (https://mcp.actionbridge.io) não é um endpoint MCP válido; informá-lo faz o cliente relatar uma falha de autorização mesmo tendo alcançado o servidor.

Conectando o Claude Desktop

Abra o Claude Desktop → Settings → Connectors.
Clique em Add Custom Connector.
Informe:
- Nome: AB Projects
- URL: https://mcp.actionbridge.io/mcp
Clique em Connect. Uma janela do navegador abre solicitando que você faça login.
Escolha Sign in with Microsoft ou informe seu e-mail e senha do AB Projects.
Após o login, o Claude Desktop se registra automaticamente e lista as ferramentas MCP do AB Projects.

Conectando o 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 OAuth do Claude Desktop.

Conectando o ChatGPT

Os conectores personalizados do ChatGPT exigem uma assinatura Plus, Pro, Business ou Enterprise.

Abra o ChatGPT → Settings → Connectors → Add custom connector.
Informe:
- Nome: AB Projects
- MCP Server URL: https://mcp.actionbridge.io/mcp (certifique-se de incluir o caminho /mcp)
Clique em Connect. Uma janela do navegador abre.
Faça login com a Microsoft ou com seu e-mail e senha do AB Projects.
Após a aprovação, o ChatGPT retorna à lista de conectores com o AB Projects exibido como conectado.

Conectando Cursor, Codex CLI, Windsurf e Antigravity

Esses editores usam um arquivo de configuração JSON para servidores MCP. Adicione esta entrada (o formato da configuração 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. Nenhum client ID ou secret é necessário — a autenticação é tratada por OAuth.

Gerenciando seu acesso via MCP

Quando você conecta um cliente, o AB Projects emite automaticamente uma chave de API nos bastidores, com escopo restrito à sua conta, de modo que o assistente atue somente como você e somente nos projetos dos quais você é membro.

Para desconectar um cliente: remova o conector do AB Projects nesse cliente de IA (por exemplo, exclua o conector personalizado no Claude/ChatGPT ou remova o bloco do servidor da configuração do editor). Ele precisará fazer login novamente na próxima vez que for readicionado.
Para revogar o acesso no lado do servidor (por exemplo, se um dispositivo for perdido), entre em contato com support@actionbridge.io — uma tela de autogerenciamento de chaves ainda não está disponível.
Toda alteração feita por um assistente é registrada no histórico de alterações do item e publicada no canal vinculado do Teams com divulgação clara de IA, de modo que a atividade via MCP é sempre auditável (consulte Referência de ferramentas MCP).

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.
Você digitou https://, não http://.
Não há barras finais, espaços ou caracteres extras.

“A autorização com o servidor MCP falhou”

Verifique novamente se a URL inclui /mcp. Apontado para o host sem caminho, o OAuth é bem-sucedido, mas a primeira chamada de ferramenta retorna a resposta de verificação de integridade e o cliente relata “authorization failed”.
Se você fez login com a Microsoft, certifique-se de que esse e-mail da Microsoft corresponde a uma conta existente do AB Projects. Novos usuários precisam configurar primeiro pelo Microsoft Teams.
Se persistir, remova e readicione o conector no seu cliente de IA para iniciar um novo login.

O cliente conecta, mas não mostra ferramentas

Atualize a lista de ferramentas do cliente. Se ainda estiver vazia, remova e readicione o conector — a primeira chamada initialize pode ter coincidido com a troca de token.

Ainda travado?

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; isso permite que a equipe extraia a sessão exata dos logs do servidor.

Conectando assistentes de IA via MCP