O ActionBridge oferece aos assistentes de IA 55 ferramentas MCP (Model Context Protocol — o padrão aberto que os assistentes usam para se conectar a aplicativos): 22 ferramentas ab_* para o AB Projects, 25 ferramentas ab_crm_* para o AB Sales e 8 ferramentas ab_support_* para o AB Support. As ferramentas de leitura apenas retornam dados e não alteram nada. As ferramentas de escrita alteram dados como você, registradas em seu nome — e as seis ferramentas de tarefa e documento que sua equipe mais acompanha também publicam um cartão no canal do Microsoft Teams vinculado.
ab_crm_* são controladas de outra forma: a chave é você ser membro de um workspace do AB Sales. Se você consegue abrir o workspace no AB Sales, as ferramentas de CRM dele funcionam para você, tanto de leitura quanto de escrita — a regra de licença do AB Projects não se aplica a elas. As ferramentas ab_support_* funcionam do mesmo jeito: a chave é você ser membro do desk de suporte. Consulte Gerenciamento de assinaturas, faturamento & licenças.Como ler as tabelas
| Selo | Significado |
|---|---|
| leitura | Apenas retorna dados. Nada é alterado. |
| escrita | Altera dados, salvos em seu nome. |
| cartão do Teams | Também publica ou atualiza um cartão no canal do Microsoft Teams vinculado, divulgado como atividade de IA. |
Para configurar a conexão em si, consulte Conectando assistentes de IA via MCP.
Ferramentas MCP do AB Projects
Elas trabalham com projetos, tarefas, a agenda e os Documentos (wiki) do projeto. A maioria exige um project_id — obtenha-o com ab_get_my_projects.
Projetos e identidade
Os status, tipos e ambientes de um projeto são os rótulos pelos quais o quadro organiza as tarefas — por exemplo In Progress, Bug ou Production. Juntos, eles são chamados de opções do projeto.
| Ferramenta | O que faz | Entradas principais |
|---|---|---|
ab_get_my_projectsleitura | Lista todos os projetos dos quais você é membro, com o número de membros, o progresso geral, suas funções nele e a data de criação. | Nenhuma |
ab_get_project_membersleitura | Lista os membros de um projeto com suas funções e os IDs de associação — o ID necessário para atribuir uma tarefa. | project_id |
ab_get_project_optionsleitura | Retorna os IDs válidos de status, tipo e ambiente de um projeto, além dos números fixos de prioridade. Os assistentes devem chamá-la antes de definir qualquer um desses valores em uma tarefa. | project_id |
ab_create_task_optionescrita | Adiciona um status, tipo ou ambiente a um projeto — as mesmas listas que as páginas de configuração Status, Types e Environments do projeto editam. A lista é compartilhada pelo quadro da equipe inteira, então um nome que já está em uso é recusado; a nova opção vai para o fim da lista. Um status também pode ser configurado para marcar as tarefas como concluídas, ou para definir o progresso delas, quando elas entram nele. Uma note é obrigatória e fica registrada no log de alterações do projeto. Sem cartão do Teams. | project_id, kind (status/type/environment), name, note; opcionais descrição, cores, locale |
ab_update_task_optionescrita | Renomeia, muda a cor, descreve ou reordena um status, tipo ou ambiente existente, ou altera se um status conclui as tarefas e qual progresso ele define. Toda tarefa que usa a opção mostra a mudança na hora. As opções não podem ser excluídas aqui — as tarefas ficariam apontando para o nada. Uma note é obrigatória. Sem cartão do Teams. | project_id, kind, option_id, note; opcionais nome, descrição, cores, position |
ab_whoamileitura | Verificação de identidade: o e-mail que o servidor resolveu para esta sessão, seu ID de usuário AB, o nome de exibição, o locatário (tenant), como você está autenticado e a versão do servidor. Útil quando a autenticação ou a associação parece errada. | Nenhuma |
Tarefas e agenda
| Ferramenta | O que faz | Entradas principais |
|---|---|---|
ab_get_my_tasksleitura | Suas tarefas ativas — atrasadas, com vencimento hoje e em andamento — com ID, título, prioridade, status, data de vencimento e progresso. | project_id (filtro opcional); opcional limit |
ab_search_tasksleitura | Pesquisa tarefas por palavra-chave em todos os seus projetos. | query; opcionais project_id, limit |
ab_get_taskleitura | Todos os detalhes de uma tarefa, incluindo os comentários, as tarefas predecessoras e sucessoras e os documentos vinculados. | project_id, task_id |
ab_get_scheduleleitura | Suas tarefas de hoje e desta semana, por data de vencimento. | Opcionais project_id, limit |
ab_create_taskescrita cartão do Teams | Cria uma tarefa. Aceita descrição (Markdown), prioridade (1 = Alta, 2 = Média, 3 = Baixa), responsável, data de vencimento, IDs de status/tipo/ambiente, parent_task_id (transforma a tarefa em subtarefa) e depends_on_task_ids (dependências do tipo terminar-antes-de-começar; ciclos são recusados). A note explica o motivo — ela aparece no log de alterações e no cartão do Teams. | project_id, title |
ab_update_taskescrita cartão do Teams | Atualiza o título, a descrição, o status, o progresso (0–100), a prioridade, o responsável, o tipo, o ambiente, a tarefa pai, as datas de início/vencimento, as horas estimadas ou as dependências de uma tarefa (add_predecessors / remove_predecessors). Cada alteração é registrada com a nota fornecida. | project_id, task_id |
ab_complete_taskescrita cartão do Teams | Marca uma tarefa como concluída, com uma nota de conclusão. | project_id, task_id |
ab_add_commentescrita cartão do Teams | Adiciona um comentário à thread da tarefa; ele também é publicado na conversa da tarefa no Teams. | project_id, task_id, content |
Documentos (wiki)
| Ferramenta | O que faz | Entradas principais |
|---|---|---|
ab_get_wiki_treeleitura | A árvore de navegação de Documentos (pastas e páginas) de um projeto. | project_id |
ab_get_wiki_articleleitura | Lê o conteúdo completo, os metadados e as informações de versão de um documento. | project_id, article_id |
ab_search_wikileitura | Lista os documentos sob um caminho de pasta (apesar do nome, ela percorre uma pasta em vez de pesquisar por palavra-chave). | project_id; parent_path (padrão /) |
ab_create_wiki_articleescrita cartão do Teams | Cria um documento em Markdown, opcionalmente em uma pasta e com tags. | project_id, title, content |
ab_update_wiki_articleescrita cartão do Teams | Atualiza um documento, criando uma nova versão. O edit_note obrigatório aparece no histórico de versões. | project_id, article_id, content, edit_note |
ab_add_wiki_commentescrita | Adiciona um comentário a um documento. Fica salvo no documento; sem cartão do Teams. | project_id, article_id, content |
ab_link_task_wikiescrita | Vincula uma tarefa a um documento. O vínculo é bidirecional — aparece nos dois — e chamar a ferramenta duas vezes é inofensivo. Sem cartão do Teams. | project_id, task_id, wiki_article_id |
ab_unlink_task_wikiescrita | Remove o vínculo entre tarefa e documento; não faz nada se eles não estavam vinculados. Sem cartão do Teams. | project_id, task_id, wiki_article_id |
Ferramentas MCP do AB Sales (CRM)
Elas trabalham com o seu funil de vendas — o funil Lead → Contato (Contact) → Oportunidade (Opportunity) → Cliente (Customer). Quase todas exigem um workspace_id — chame ab_crm_workspaces primeiro para obtê-lo. Todas as escritas do CRM são carimbadas com o seu nome e o horário e ficam visíveis no aplicativo AB Sales, mas nenhuma delas publica um cartão do Teams.
Descobrir
| Ferramenta | O que faz | Entradas principais |
|---|---|---|
ab_crm_workspacesleitura | Lista os workspaces de CRM que você pode usar, com a contagem de leads, contatos, oportunidades e clientes. Chame esta primeiro — todas as outras ferramentas de CRM precisam dos IDs de workspace. | Nenhuma |
ab_crm_get_sales_contextleitura | O contexto de vendas do workspace, para redigir abordagens alinhadas à marca: produtos com preços, metas de vendas, propostas de valor e se o envio de e-mail está configurado. | workspace_id |
ab_crm_get_pipelineleitura | Resumo do pipeline: oportunidades abertas por estágio (quantidade, total, valor ponderado), totais do workspace e negócios que fecham em até 30 dias. | workspace_id |
ab_crm_get_win_patternsleitura | Analisa seus negócios fechados em busca do que as vitórias têm em comum — tempo de ciclo, tamanho do negócio, cadência de atividades, setor, origem do lead e os motivos registrados para as perdas. Ela precisa de pelo menos 5 negócios Closed-Won (fechados e ganhos) antes de dizer qualquer coisa — e de 5 Closed-Lost (fechados e perdidos) para comparar o lado das perdas. Abaixo disso, ela avisa que ainda não há histórico suficiente, em vez de tirar conclusões de um punhado de negócios. | workspace_id |
Leads
| Ferramenta | O que faz | Entradas principais |
|---|---|---|
ab_crm_list_leadsleitura | Lista ou pesquisa leads (Leads), dos mais recentes para os mais antigos. Status: New InformationFilled Contacted Qualified Disqualified | workspace_id; opcionais status, label, source, query, limit |
ab_crm_get_leadleitura | Um lead por inteiro: perfil, pesquisa da empresa feita por IA, notas recentes, e-mails recentes e as oportunidades dele. Os assistentes a chamam antes de atualizar um lead ou enviar um e-mail para ele. | workspace_id, lead_id |
ab_crm_create_leadescrita | Cria um lead — apenas o nome é obrigatório. Os leads começam em New (novo) e são promovidos automaticamente para InformationFilled (dados preenchidos) assim que nome, site e e-mail estão todos presentes. Cada novo lead consome uma unidade da cota mensal de novos leads do workspace; quando ela se esgota, a ferramenta recusa a criação e avisa. | workspace_id, name; opcionais e-mail, site, contato, telefone, setor, origem, notas |
ab_crm_update_leadescrita | Atualiza os campos, o status e/ou os rótulos de um lead. Os rótulos são adicionados ou removidos um a um (add_labels / remove_labels); os demais rótulos do lead são mantidos. Definir automation_opt_out=true exclui o lead de toda abordagem automatizada. | workspace_id, lead_id |
Rótulos
Os rótulos (labels, chamados de tags em alguns lugares) são os marcadores coloridos que um workspace coloca nos leads para agrupá-los. Eles formam uma única lista compartilhada por workspace, então os assistentes reaproveitam um rótulo existente em vez de criar uma quase-cópia.
| Ferramenta | O que faz | Entradas principais |
|---|---|---|
ab_crm_list_labelsleitura | Lista os rótulos de leads do workspace, com ID, nome e cor. | workspace_id; opcional include_archived |
ab_crm_create_labelescrita | Cria um rótulo. É recusado quando já existe um rótulo com o mesmo nome — a ferramenta aponta para esse existente. | workspace_id, name; opcional cor |
ab_crm_update_labelescrita | Renomeia um rótulo ou muda a cor dele. A mudança aparece em todo lead que o carrega. | workspace_id, label_id; name e/ou color |
ab_crm_archive_labelescrita | Arquiva (remove) um rótulo. Ele some de todos os leads e filtros de uma vez; os leads em si não são alterados. Como isso muda a visão da equipe inteira, o assistente deve confirmar com você antes. | workspace_id, label_id |
Clientes, contatos e oportunidades
| Ferramenta | O que faz | Entradas principais |
|---|---|---|
ab_crm_list_customersleitura | Lista ou pesquisa clientes (Customers), dos mais recentes para os mais antigos. | workspace_id; opcionais search, limit |
ab_crm_create_customerescrita | Cria um cliente — normalmente ao converter um lead qualificado. | workspace_id, name |
ab_crm_list_contactsleitura | Lista os contatos (Contacts) que pertencem a um cliente. | workspace_id, customer_id |
ab_crm_list_opportunitiesleitura | Lista oportunidades (Opportunities), com o fechamento previsto mais próximo primeiro. Status: Open (aberta), Closed-Won (fechada e ganha), Closed-Lost (fechada e perdida). | workspace_id; opcionais status, limit |
ab_crm_create_opportunityescrita | Cria uma oportunidade sob um cliente ou um lead (o registro pai já precisa existir). | workspace_id, parent_type (Customer/Lead), parent_id, name; opcionais valor, moeda, fechamento previsto |
ab_crm_update_opportunityescrita | Move o estágio, altera valor / fechamento previsto / próximo passo, ou fecha o negócio com close='won' ou close='lost' (um motivo é obrigatório ao registrar uma perda). | workspace_id, opportunity_id |
Atividades, notas e e-mail
| Ferramenta | O que faz | Entradas principais |
|---|---|---|
ab_crm_list_activitiesleitura | Lista atividades (ligações, reuniões, tarefas de acompanhamento) — as atividades de um registro ou a janela planejada em torno de hoje. | workspace_id; opcionais related_type+related_id, days_back/days_ahead |
ab_crm_create_activityescrita | Agenda um acompanhamento (Call, Email, Meeting, Note ou Task) em um lead, cliente, oportunidade ou contato. Aparece nos itens de ação da equipe. | workspace_id, related_type, related_id, subject |
ab_crm_complete_activityescrita | Marca uma atividade como concluída, registrando o resultado se você quiser. | workspace_id, activity_id |
ab_crm_add_noteescrita | Adiciona uma nota (com suporte a Markdown) a um lead, cliente, oportunidade ou contato — é assim que ligações, decisões e ações de IA ficam registradas para a equipe. | workspace_id, parent_type, parent_id, text |
ab_crm_list_notesleitura | Lista as notas de um registro, das mais recentes para as mais antigas. | workspace_id, parent_type, parent_id |
ab_crm_list_emailsleitura | A thread de e-mail de um lead, cliente ou contato (recebidos e enviados), dos mais recentes para os mais antigos, com prévias. | workspace_id, parent_type, parent_id |
ab_crm_send_email_to_leadescrita | Envia um e-mail em texto simples para um lead, a partir da caixa de correio configurada no workspace; depois arquiva o e-mail na thread do lead e adiciona uma nota dizendo que ele foi enviado via MCP. O assistente precisa confirmar destinatário, assunto e corpo com você antes, e o envio é recusado quando o lead optou por sair da automação, quando a automação do workspace está pausada ou quando nenhuma caixa de correio está configurada. | workspace_id, lead_id, subject, body |
O esquema exato de parâmetros de cada ferramenta está sempre disponível na própria ferramenta; as entradas acima são um guia, não um contrato exaustivo.
Ferramentas MCP do AB Support
Elas trabalham com seus desks (centrais de atendimento) e os tickets que estão neles. Todas exigem um desk_id — chame ab_support_desks primeiro para obtê-lo. Como as ferramentas de CRM, elas são controladas pela participação no desk, e não por uma licença do AB Projects, e nenhuma delas publica um cartão do Teams. Observação: o aplicativo AB Support não é traduzido, então os rótulos da interface aparecem em inglês.
ab_support_draft_reply pode deixar um rascunho de resposta no ticket, mas o cliente não vê nada até que uma pessoa do seu desk o revise e o envie com Use this. ab_support_add_note escreve uma nota interna que somente o seu desk vê.Tickets
| Ferramenta | O que faz | Entradas principais |
|---|---|---|
ab_support_desksleitura | Lista os desks de suporte que você pode usar, com a contagem de tickets abertos e o total. Chame esta primeiro — todas as outras ferramentas do AB Support precisam do ID do desk. | Nenhuma |
ab_support_list_ticketsleitura | Lista ou pesquisa os tickets de um desk, com os de atividade mais recente primeiro, mostrando o cliente, o responsável, o status, a prioridade e se é a IA ou uma pessoa que está cuidando dele no momento. Enquanto a IA está respondendo um ticket, o responsável aparece como “AI” (a IA). | desk_id; opcionais status, search, limit |
ab_support_get_ticketleitura | Um ticket por inteiro: a conversa que o cliente vê, as notas internas do desk (mantidas separadas para que não sejam confundidas com algo que o cliente disse), o histórico de alterações e a resposta sugerida pela IA — que é um rascunho e não foi enviada. | desk_id, ticket_id |
Triagem
| Ferramenta | O que faz | Entradas principais |
|---|---|---|
ab_support_ticket_statusesleitura | Os status do próprio desk e seus IDs. Os status pertencem a um desk e podem ser renomeados e reordenados, então o assistente precisa lê-los em vez de supor que existe um status chamado “Open”. | desk_id |
ab_support_update_ticketescrita | Faz a triagem de um ticket: status, responsável e/ou prioridade. Um reason (motivo) é obrigatório — ele é gravado no histórico do ticket para que o desk veja por que o ticket mudou, e não apenas que ele mudou. Não altera nada que o cliente veja. Atribuir uma pessoa a um ticket que está com a IA tira o ticket dela: a IA para de responder a esse cliente, e o histórico mostra “AI → nome”. | desk_id, ticket_id, reason; opcionais status_id, assignee_user_id, priority |
ab_support_add_noteescrita | Adiciona uma nota interna para o desk — o cliente nunca a vê, e ela não muda o status do ticket, porque uma nota não é uma resposta. | desk_id, ticket_id, note |
ab_support_draft_replyescrita | Deixa um rascunho de resposta ao cliente como a resposta sugerida do ticket — o mesmo lugar onde aparece a sugestão da própria IA, substituindo qualquer uma anterior. Ela nunca envia nada: uma pessoa do desk abre o ticket, revisa o rascunho e o envia com Use this. O destinatário é sempre o cliente do ticket, nunca alguém escolhido pelo assistente. É recusada num ticket fechado, e avisa quando o desk ainda não conseguiria enviar o rascunho (respostas pausadas porque a cota de uso se esgotou, ou o cliente optou por não receber mensagens pelo canal do ticket). | desk_id, ticket_id, body |
Pessoas
| Ferramenta | O que faz | Entradas principais |
|---|---|---|
ab_support_get_customerleitura | Os dados de um cliente e os tickets anteriores dele — se essa pessoa já procurou você antes, e sobre o quê. O customer_id está no ticket. Também mostra quando alguém optou por não receber SMS e WhatsApp. | desk_id, customer_id; opcional limit |
O esquema exato de parâmetros de cada ferramenta está sempre disponível na própria ferramenta; as entradas acima são um guia, não um contrato exaustivo.
Prompts MCP — comandos de barra prontos
Além das ferramentas, o servidor publica prompts MCP: modelos que aparecem como comandos de barra nos clientes compatíveis (Claude, ChatGPT, Cursor, …). Cada um se expande em instruções que acionam as ferramentas acima — você obtém um resultado pronto sem precisar escrever o pedido.
| Prompt | O que produz | Argumentos |
|---|---|---|
ab-standup | Um resumo de daily standup: atrasadas, com vencimento hoje e em andamento. | project_id (opcional) |
ab-weekly-review | Uma revisão semanal: o que foi entregue, o que atrasou e o que está em risco na próxima semana. | project_id (opcional) |
ab-create-task | Criação guiada de tarefa a partir de uma intenção em linguagem natural — busca as opções válidas, propõe título, prioridade e data de vencimento e então cria a tarefa. | project_id, intent (ambos obrigatórios) |
ab-find-blocked | Tarefas que parecem bloqueadas, agrupadas por projeto, das bloqueadas há mais tempo primeiro. | project_id (opcional) |
ab-wiki-recap | Um resumo dos Documentos editados mais recentemente em um projeto. | project_id (obrigatório) |
Recursos MCP — feeds sob demanda
Os recursos MCP são feeds somente leitura que um cliente pode anexar como contexto de fundo, sem chamar nenhuma ferramenta. Todos os quatro tratam do seu trabalho, não do trabalho da equipe inteira:
| Recurso | Conteúdo |
|---|---|
ab://me/today | Tarefas com vencimento hoje em todos os projetos dos quais você é membro. |
ab://me/week | Tarefas com vencimento nos próximos 7 dias, mais as de hoje. |
ab://me/projects | Seus projetos, com número de membros, progresso e suas funções. |
ab://project/…/overview | Um por projeto: suas tarefas abertas nele, mais a lista de membros do projeto. |
O que acontece quando uma IA escreve
Toda escrita passa pelo mesmo caminho de código do aplicativo e é salva em seu nome — não existe um autor anônimo “robô”. O quanto ela se anuncia depende da ferramenta:
| Ferramentas de escrita | Salvo no registro | Log de operações (auditoria) | Cartão do Teams |
|---|---|---|---|
ab_create_task, ab_update_task, ab_complete_task, ab_add_comment |
Histórico de alterações, com a sua note |
Sim | Sim, divulgado como atividade de IA |
ab_create_wiki_article, ab_update_wiki_article |
Nova versão, com o seu edit_note |
Sim | Sim, divulgado como atividade de IA |
ab_create_task_option, ab_update_task_option |
Sim — o log de alterações do projeto registra a mudança, o antes e o depois, e a sua note |
Sim | Não |
ab_add_wiki_comment, ab_link_task_wiki, ab_unlink_task_wiki |
Sim, em seu nome | Não | Não |
Todas as doze ferramentas de escrita ab_crm_* |
Sim, carimbadas com o seu nome e o horário; notas e atividades aparecem no histórico do registro | Para leads, oportunidades, notas, novas atividades e e-mails enviados; não para clientes, atividades concluídas ou rótulos | Não |
ab_support_update_ticket, ab_support_add_note, ab_support_draft_reply |
Sim — o histórico do ticket registra a alteração e o motivo que você deu | Sim | Não |
Ou seja, uma tarefa que um assistente cria ou fecha é tão visível quanto uma em que você mesmo clicou — mesmo histórico de alterações, mesma entrada de auditoria, mesmo cartão no canal. As escritas mais silenciosas (comentários em documentos, vínculos entre tarefa e documento, alterações nas opções do projeto, registros de CRM e tickets de suporte) continuam atribuídas a você e continuam visíveis no aplicativo; elas apenas não interrompem o canal.
Perguntas frequentes
Preciso de uma licença só para o meu assistente ler?
Não. Toda ferramenta de leitura funciona para qualquer membro do projeto, com ou sem licença. Somente as onze ferramentas de escrita do AB Projects verificam a licença, e apenas depois que sua organização passa dos 10 usuários gratuitos.
Por que meu assistente enxerga apenas alguns dos meus projetos?
As ferramentas só enxergam projetos e workspaces dos quais você é membro aceito. Execute ab_whoami para confirmar qual conta o servidor resolveu para a sua conexão — uma divergência aí explica a maioria dos relatos de “a ferramenta não encontra”.
Uma IA pode enviar e-mail a um cliente sem eu saber?
ab_crm_send_email_to_lead é a única ferramenta que envia e-mail, ela exige que você confirme destinatário, assunto e corpo antes, e recusa o envio se o lead optou por sair da automação, se a automação do workspace está pausada ou se nenhuma caixa de correio está configurada. Todo envio é arquivado na thread de e-mail do lead, com uma nota.
Um assistente pode responder a um cliente do suporte?
Não diretamente. Nada no conjunto ab_support_* envia uma resposta, então nenhuma ação do assistente chega à pessoa que abriu o ticket. Ele pode ler a conversa, mudar o status, atribuir, definir a prioridade, adicionar uma nota interna que fica no seu desk e redigir uma resposta com ab_support_draft_reply. Esse rascunho espera no ticket como resposta sugerida até que uma pessoa do seu desk o revise e o envie com Use this — ou o ignore.
Por que meu assistente pergunta por que estou mudando um ticket?
Porque ab_support_update_ticket recusa a operação sem um reason. Toda mudança de status, responsável e prioridade cai no histórico do ticket com esse motivo anexado, para que um colega que pegue o ticket depois veja por que ele mudou, em vez de adivinhar.
O ab_search_wiki pesquisa dentro dos meus documentos?
Não — apesar do nome, ela lista os documentos sob um caminho de pasta. Para encontrar um documento pelo conteúdo, obtenha a árvore com ab_get_wiki_tree e leia os candidatos com ab_get_wiki_article.
Verificado no servidor MCP em produção em 2 de outubro de 2026: 55 ferramentas, 5 prompts e 4 feeds de recursos.