Referência de ferramentas MCP
O AB Projects expõe ferramentas MCP que permitem que assistentes de IA (como o Claude) trabalhem com seus projetos, tarefas e documentos. Quando um assistente altera algo por meio dessas ferramentas, o processo segue o mesmo caminho do aplicativo: uma entrada no histórico de alterações com a nota que você fornece, uma entrada no log de auditoria e um Adaptive Card (cartão adaptável) publicado no canal do Microsoft Teams vinculado — com a atividade de IA claramente divulgada. As ferramentas somente leitura apenas retornam dados e não alteram nada.
Ferramentas de projeto
| Ferramenta | Descrição | Parâmetros |
|---|---|---|
ab_get_my_projects |
Lista todos os projetos dos quais você é membro, incluindo estatísticas como contagens de tarefas e taxas de conclusão. | Nenhum |
ab_get_project_members |
Lista todos os membros de um projeto com suas funções e IDs de associação. Use isto para obter o ID de associação necessário para atribuir uma tarefa. | project_id obrigatório |
ab_get_project_options |
Obtém os IDs válidos de status, tipo e ambiente de um projeto. Chame isto primeiro antes de passar um status, tipo ou ambiente para ab_create_task ou ab_update_task. |
project_id obrigatório |
Ferramentas de tarefa
| Ferramenta | Descrição | Parâmetros |
|---|---|---|
ab_get_my_tasks |
Obtém suas tarefas ativas — atrasadas, com vencimento hoje e em andamento. Retorna ID da tarefa, título, prioridade, status, data de vencimento e progresso. | project_id opcional — filtra para um projeto específico |
ab_search_tasks |
Pesquisa tarefas por palavra-chave em todos os seus projetos. | query obrigatório — palavra-chave de pesquisa project_id opcional — restringe a um projeto específico |
ab_get_task |
Obtém os detalhes completos de uma tarefa — descrição, datas, responsável, horas estimadas/reais, informações de subtarefas, ID da tarefa pai, branch do GitHub e os 50 comentários mais recentes inline. Status, tipo e ambiente são retornados como nomes legíveis. | project_id obrigatório task_id obrigatório |
ab_create_task |
Cria uma nova tarefa. Uma entrada no log de alterações é registrada e uma notificação é publicada no canal do Teams vinculado. | project_id obrigatório title obrigatório description opcional — suporta Markdown priority opcional — 1 = Alta, 2 = Média, 3 = Baixa (padrão: 2) assignee_id opcional — ID de associação do responsável due_date opcional — yyyy-MM-dd status / type / environment opcional — IDs de ab_get_project_optionsparent_task_id opcional — row key da tarefa pai; quando definido, esta se torna uma subtarefa e o sinalizador "tem subtarefas" da tarefa pai é atualizado automaticamente note opcional — motivo, exibido no log de alterações e no canal do Teams |
ab_update_task |
Atualiza as propriedades de uma tarefa — título, descrição, status, progresso, prioridade, responsável, tipo, ambiente ou tarefa pai. Cada alteração é registrada no histórico com a nota fornecida. | project_id obrigatório task_id obrigatório title / description opcional (Markdown) status opcional — novo ID de status progress opcional — 0 a 100 priority opcional — 1/2/3 assignee_id / type / environment opcional parent_task_id opcional — mover para outra tarefa pai; string vazia para desanexar note opcional — motivo, exibido no log de alterações e no canal do Teams |
ab_complete_task |
Marca uma tarefa como concluída. Define o progresso como 100% e registra uma entrada de conclusão no histórico de alterações. | project_id obrigatório task_id obrigatório note opcional — nota de conclusão, exibida no log de alterações e no canal do Teams |
ab_add_comment |
Adiciona um comentário a uma tarefa. O comentário aparece na thread da tarefa e é incluído inline por ab_get_task, então uma chamada subsequente pode lê-lo sem uma segunda chamada de ferramenta. |
project_id obrigatório task_id obrigatório content obrigatório — texto do comentário |
Ferramentas de agenda
| Ferramenta | Descrição | Parâmetros |
|---|---|---|
ab_get_schedule |
Obtém sua agenda da semana atual — agrupada em atrasadas, com vencimento hoje e com vencimento nesta semana. | project_id opcional — filtra para um projeto específico |
Ferramentas de Documentos (Wiki)
| Ferramenta | Descrição | Parâmetros |
|---|---|---|
ab_get_wiki_tree |
Obtém a árvore de navegação de Documentos (pastas e páginas) de um projeto. | project_id obrigatório |
ab_get_wiki_article |
Lê o conteúdo completo, os metadados e as informações de versão de um documento. | project_id obrigatório article_id obrigatório — de ab_get_wiki_tree ou ab_search_wiki |
ab_search_wiki |
Lista documentos sob um caminho de pasta específico. | project_id obrigatório parent_path opcional — pasta a listar (padrão: / para a raiz) |
ab_create_wiki_article |
Cria um novo documento em Markdown. Publica uma notificação no canal do Teams vinculado. | project_id obrigatório title obrigatório content obrigatório — Markdown parent_path opcional — pasta, ex. / ou /Engineering (padrão: /)tags opcional — separadas por vírgula |
ab_update_wiki_article |
Atualiza um documento existente. Cria uma nova versão com uma nota de edição e publica uma notificação no canal do Teams. | project_id obrigatório article_id obrigatório content obrigatório — Markdown atualizado edit_note obrigatório — o que mudou; exibido no histórico de versões tags opcional — tags atualizadas separadas por vírgula |
ab_add_wiki_comment |
Adiciona um comentário a um documento. | project_id obrigatório article_id obrigatório content obrigatório — texto do comentário |
Como as alterações de IA permanecem visíveis
Quando uma tarefa ou documento é criado, atualizado ou concluído por meio de uma ferramenta MCP, o AB Projects automaticamente:
- Registra a alteração no histórico de alterações do item com o nome do usuário e a nota fornecida
- Grava uma entrada no log de operações para fins de auditoria
- Publica ou atualiza um Adaptive Card (cartão adaptável) no canal do Microsoft Teams vinculado ao projeto, com a atividade claramente divulgada como gerada por IA
Assim, as alterações conduzidas por IA têm a mesma visibilidade e rastreabilidade das alterações feitas diretamente no aplicativo do AB Projects ou na guia do Teams. Para saber como conectar um assistente, consulte Conectando assistentes de IA via MCP.