Referência de ferramentas MCP

Referência de ferramentas MCP

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.

22
ferramentas do AB Projects
25
ferramentas do AB Sales (CRM)
8
ferramentas do AB Support
5
prompts de comando de barra
4
feeds de recursos sob demanda

Como ler as tabelas

Significado dos selos usados ao lado de cada nome de ferramenta MCP
SeloSignificado
leituraApenas retorna dados. Nada é alterado.
escritaAltera dados, salvos em seu nome.
cartão do TeamsTambé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.

AB ProjectsFerramentas 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.

Ferramentas MCP do AB Projects para listar projetos, membros e opções, gerenciar os status, tipos e ambientes de um projeto e verificar sua identidade
FerramentaO que fazEntradas principais
ab_get_my_projects
leitura
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_members
leitura
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_options
leitura
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_option
escrita
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_option
escrita
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_whoami
leitura
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

Ferramentas MCP do AB Projects para ler, criar, atualizar, concluir e comentar tarefas
FerramentaO que fazEntradas principais
ab_get_my_tasks
leitura
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_tasks
leitura
Pesquisa tarefas por palavra-chave em todos os seus projetos.query; opcionais project_id, limit
ab_get_task
leitura
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_schedule
leitura
Suas tarefas de hoje e desta semana, por data de vencimento.Opcionais project_id, limit
ab_create_task
escrita 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_task
escrita 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_task
escrita cartão do Teams
Marca uma tarefa como concluída, com uma nota de conclusão.project_id, task_id
ab_add_comment
escrita 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)

Ferramentas MCP do AB Projects para navegar, ler, escrever e vincular documentos do projeto
FerramentaO que fazEntradas principais
ab_get_wiki_tree
leitura
A árvore de navegação de Documentos (pastas e páginas) de um projeto.project_id
ab_get_wiki_article
leitura
Lê o conteúdo completo, os metadados e as informações de versão de um documento.project_id, article_id
ab_search_wiki
leitura
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_article
escrita cartão do Teams
Cria um documento em Markdown, opcionalmente em uma pasta e com tags.project_id, title, content
ab_update_wiki_article
escrita 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_comment
escrita
Adiciona um comentário a um documento. Fica salvo no documento; sem cartão do Teams.project_id, article_id, content
ab_link_task_wiki
escrita
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_wiki
escrita
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

AB SalesFerramentas 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

Ferramentas MCP do AB Sales para listar workspaces, o contexto de vendas e o pipeline
FerramentaO que fazEntradas principais
ab_crm_workspaces
leitura
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_context
leitura
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_pipeline
leitura
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_patterns
leitura
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

Ferramentas MCP do AB Sales para listar, ler, criar e atualizar leads
FerramentaO que fazEntradas principais
ab_crm_list_leads
leitura
Lista ou pesquisa leads (Leads), dos mais recentes para os mais antigos. Status: New InformationFilled Contacted Qualified Disqualifiedworkspace_id; opcionais status, label, source, query, limit
ab_crm_get_lead
leitura
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_lead
escrita
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_lead
escrita
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.

Ferramentas MCP do AB Sales para listar, criar, editar e arquivar rótulos de leads
FerramentaO que fazEntradas principais
ab_crm_list_labels
leitura
Lista os rótulos de leads do workspace, com ID, nome e cor.workspace_id; opcional include_archived
ab_crm_create_label
escrita
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_label
escrita
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_label
escrita
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

Ferramentas MCP do AB Sales para clientes, contatos e oportunidades
FerramentaO que fazEntradas principais
ab_crm_list_customers
leitura
Lista ou pesquisa clientes (Customers), dos mais recentes para os mais antigos.workspace_id; opcionais search, limit
ab_crm_create_customer
escrita
Cria um cliente — normalmente ao converter um lead qualificado.workspace_id, name
ab_crm_list_contacts
leitura
Lista os contatos (Contacts) que pertencem a um cliente.workspace_id, customer_id
ab_crm_list_opportunities
leitura
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_opportunity
escrita
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_opportunity
escrita
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

Ferramentas MCP do AB Sales para atividades, notas e e-mail
FerramentaO que fazEntradas principais
ab_crm_list_activities
leitura
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_activity
escrita
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_activity
escrita
Marca uma atividade como concluída, registrando o resultado se você quiser.workspace_id, activity_id
ab_crm_add_note
escrita
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_notes
leitura
Lista as notas de um registro, das mais recentes para as mais antigas.workspace_id, parent_type, parent_id
ab_crm_list_emails
leitura
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_lead
escrita
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.

AB SupportFerramentas 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.

Tickets

Ferramentas MCP do AB Support para listar desks, pesquisar tickets e ler um ticket
FerramentaO que fazEntradas principais
ab_support_desks
leitura
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_tickets
leitura
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_ticket
leitura
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

Ferramentas MCP do AB Support para status de ticket, triagem, notas internas e rascunhos de resposta
FerramentaO que fazEntradas principais
ab_support_ticket_statuses
leitura
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_ticket
escrita
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_note
escrita
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_reply
escrita
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 MCP do AB Support para ler um cliente e seus tickets anteriores
FerramentaO que fazEntradas principais
ab_support_get_customer
leitura
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.

Os cinco prompts MCP que o ActionBridge publica como comandos de barra
PromptO que produzArgumentos
ab-standupUm resumo de daily standup: atrasadas, com vencimento hoje e em andamento.project_id (opcional)
ab-weekly-reviewUma 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-taskCriaçã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-blockedTarefas que parecem bloqueadas, agrupadas por projeto, das bloqueadas há mais tempo primeiro.project_id (opcional)
ab-wiki-recapUm 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:

Os quatro feeds de recursos MCP e o que cada um contém
RecursoConteúdo
ab://me/todayTarefas com vencimento hoje em todos os projetos dos quais você é membro.
ab://me/weekTarefas com vencimento nos próximos 7 dias, mais as de hoje.
ab://me/projectsSeus projetos, com número de membros, progresso e suas funções.
ab://project/…/overviewUm 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:

Quais ferramentas MCP de escrita registram histórico de alterações, gravam uma entrada no log de operações e publicam um cartão do Teams
Ferramentas de escritaSalvo no registroLog 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.

Publicado em 2026-04-04
Última atualização em 2026-10-21
Versão 6