Pular para o conteúdo
Área do cliente
  • Não há sugestões porque o campo de pesquisa está em branco.

Integração | Configurando o MCP do AltoQi Visus Workflow para consulta de dados do projeto em ferramenta de Inteligencia artificial

O MCP (Model Context Protocol) é um protocolo que permite integrar aplicações a plataformas de inteligência artificial, como o ChatGPT ou Claude, fornecendo acesso controlado às informações de um projeto.

Com a integração do MCP do AltoQi Visus Cost Management, é possível consultar dados do projeto diretamente em ferramentas de IA, utilizando linguagem natural. Dessa forma, o assistente pode responder perguntas sobre as informações disponibilizadas pelo servidor MCP, tornando a análise dos projetos mais rápida e intuitiva.

Assuntos tratados neste artigo:

Como obter o endereço MCP do AltoQi Visus Workflow

O endereço do servidor MCP do AltoQi Visus Workflow é:

https://workflow-api.altoqivisus.com.br/mcp

Esse endereço deverá ser utilizado durante a configuração da integração na ferramenta de inteligência artificial.

Antes de iniciar, certifique-se de que:

  • Possui uma conta ativa no AltoQi Visus Workflow;
  • Possui acesso à internet;
  • Está utilizando uma ferramenta de IA compatível com servidores MCP, como ChatGPT ou Claude.

Como configurar o MCP do Visus Workflow no ChatGPT

Habilitando o Modo desenvolvedor no ChatGPT

Para permitir a integração com o servidor MCP, é necessário habilitar o Modo desenvolvedor no ChatGPT.

Siga os passos abaixo:

  1. Acesse Configurações, clicando no seu nome ou foto de perfil.
  2. Selecione Segurança e login.
  3. Habilite a opção Modo desenvolvedor.

Em espaços de trabalho de Equipe, Empresarial ou Educacional, somente proprietários e administradores podem configurar servidores MCP.

Criando o plugin no ChatGPT

Após habilitar o Modo desenvolvedor, siga os passos abaixo:

  1. Ainda em Configurações, acesse Plugins
  2. Clique em Novo plugins.
  3. No campo Nome, informe um nome para o aplicativo, como MCP Workflow.
  4. No campo Conexão, informe o endereço:

https://workflow-api.altoqivisus.com.br/mcp

  1. Em Autenticação, selecione OAuth.
  2. Marque a opção Entendi e quero continuar.
  3. Clique em Criar para concluir a configuração.

Conectando-se ao plugin criado

Após criar o aplicativo, siga os passos abaixo:

  1. Faça login utilizando sua conta AltoQi.
  2. Selecione a conta do AltoQi Visus Workflow que deseja utilizar.
  3. Autorize o acesso ao servidor MCP.
  4. Inicie uma nova conversa no ChatGPT.

Reconectando ou desconectando o aplicativo

Para reconectar ou desconectar o AltoQi Visus Workflow:

  1. Acesse Configurações.
  2. Selecione Plugins.
  3. Localize o plugin do Workflow.
  4. Clique sobre o plugin e, em seguida, no ícone de reticências.
  5. Selecione Reconectar ou Desconectar, conforme necessário.

Como configurar o MCP do Visus Workflow no Claude

Criando o conector no Claude

Para configurar o MCP no Claude:

  1. Acesse Personalizar na barra lateral.
  2. Clique em Conectores.
  3. Clique em Adicionar > Adicionar conector personalizado.

  4. No campo Nome, informe MCP Workflow.
  5. No campo de URL do servidor MCP remoto, informe:

https://workflow-api.altoqivisus.com.br/mcp

  1. Clique em Adicionar.
  2. Faça login utilizando sua conta do AltoQi Visus Workflow.
  3. Selecione a conta que deseja utilizar.

Após concluir a configuração, o Claude poderá consultar as informações disponíveis no Workflow.

Reconectando ou desconectando o conector

Para reconectar ou desconectar o Workflow no Claude:

  1. Acesse a seção Conectores.
  2. Localize o conector do Workflow.
  3. Clique no ícone de reticências.
  4. Selecione Atualizar lista de ferramentas para atualizar a conexão.
  5. Para remover a conexão, clique em Excluir.

Tools (funções) contempladas pelo MCP Visus Workflow

As Tools podem ser entendidas como funções ou comandos disponíveis no MCP. Cada função permite realizar uma consulta específica nas informações do AltoQi Visus Workflow.

Tarefas

Tool Função
workflow_tasks_search Busca e filtra tarefas por responsável, empreendimento, entrega, estágio, prazo e status de atraso.  Suporta análises de alocação, cálculo de horas registradas e detecção de gargalos. Retorna resultados paginados. 
get_task Retorna todos os detalhes de uma tarefa específica: descrição completa, responsáveis, histórico de mudanças de estágio, comentários e prioridade. Ideal para investigar o contexto por trás de uma tarefa. 

Empreendimentos

Tool Função
workflow_buildings_search  Lista e filtra empreendimentos por nome, cliente ou status. Ponto de entrada para análises de portfólio. Retorna os IDs necessários para cruzar com tarefas, entregas e horas registradas em cada projeto. 

Entregas

Tool Função
workflow_deliveries_search Busca entregas e planejadores associados a um empreendimento, retornando fases, datas de início e término e tipo de entrega. Essencial para análises de cronograma e relatórios de planejamento integrado. 

Colaboradores

Tool Função
workflow_users_search Busca colaboradores cadastrados na plataforma por nome (parcial) ou e-mail, retornando dados de contato, nível de acesso e custo por hora cadastrado (price). Base para cálculo de custo por colaborador quando cruzada com horas registradas. 

Exemplos de perguntas que podem ser realizadas

Após configurar o MCP, é possível realizar perguntas como:

  • Quais tarefas estão atrasadas?
  • Quais tarefas a Ana precisa concluir esta semana?
  • Quantas horas foram registradas no empreendimento X neste mês?
  • Quais empreendimentos estão ativos para o cliente X?
  • Quais entregas possuem prazo neste trimestre?
  • Qual é o histórico da tarefa 68529?
  • Quais tarefas estão paradas na etapa de revisão?
  • Qual é o custo por hora cadastrado para determinado colaborador?
  • Quais colaboradores estão com maior carga de trabalho?
  • Em qual etapa do fluxo as tarefas estão acumuladas?

As respostas serão geradas considerando os dados disponíveis na conta e as permissões do usuário autenticado.

Exemplos de Skills para utilizar com o Visus Workflow

As Skills são conjuntos de instruções que tornam o assistente de IA especialista em determinado assunto ou processo.

Elas definem como o assistente deve interpretar as solicitações, quais Tools utilizar, em qual sequência realizar as consultas, como calcular os indicadores e em qual formato apresentar o resultado.

As skills funcionam apenas no Claude, seja no aplicativo para desktop ou navegador.

Para utilizar:

  1. Acesse as Configurações.
  2. Clique em Habilidades.
  3. Clique em Adicionar > Fazer upload de uma habilidade.

💡Dica de suporte: Não há comando para decorar. Pergunte naturalmente, "monta meu planning da semana", "quem está sobrecarregado em julho?", "fechamento de horas de junho" e a skill certa assume. 

Rotina e cobrança

Skill O que faz Exemplos de pedido
to-do-diario Mostra o que a equipe precisa entregar hoje e amanhã, além das tarefas já em atraso, organizadas por responsável. Serve como insumo direto para a abertura da daily e pode ser agendado para envio automático em dias úteis às 8h. Saída: Resumo no chat. • "O que minha equipe entrega hoje?"
• "Prepara o briefing da daily."
to-do-semanal Lista as tarefas com prazo dentro da semana, suas, de uma pessoa ou do time todo, agrupadas por dia, com horas estimadas e destaque para o que já entra a semana atrasado. Ideal para plannings. Saída: Tabela no chat. • "Monta meu planning da semana."
• "O que a Lara tem até sexta?"
tarefas-por-responsavel Exibe todas as tarefas de um colaborador em qualquer período, agrupadas por empreendimento, incluindo prazos, horas estimadas e links diretos. É uma das consultas operacionais mais utilizadas por coordenadores e gerentes. Saída: Tabela no chat. • "Quais tarefas o David tem em janeiro?"
• "Lista as pendências da Bruna neste mês."
tarefas-em-atraso Consolida todas as tarefas vencidas e não concluídas, agrupando por responsável, com dias de atraso, destaque para tarefas críticas (>30 dias) e para itens sem responsável. Também pode gerar mensagens de cobrança. Saída: Tabela no chat. • "Quem está com tarefas em atraso?"
• "Lista as tarefas vencidas agrupadas por pessoa."
tarefas-paradas-em-revisao  Encontra as tarefas presas no estágio de Revisão há mais de X dias (padrão 5), com os responsáveis que concentram a fila. Aciona o desbloqueio de uma etapa que costuma acumular silenciosamente. Saída: Tabela no chat. • "O que está parado em revisão há mais de 5 dias?"
• "Qual a fila de revisão acumulada?"

Equipe e capacidade

Skill O que faz Exemplos de pedido
alocacao-de-recursos Gera um painel interativo de carga de trabalho (estilo ClickUp): calendário semanal por colaborador, status de ociosidade/sobrecarga, kanban e simulação de realocação arrastando tarefas entre pessoas. Saída: Painel HTML interativo. • "Monta o painel de alocação de julho."
• "Quero visualizar quem está sobrecarregado num board."
retrabalho-ranking Ranking de retrabalho e correções por colaborador num período, mostrando onde o retrabalho se concentra (entrega, estágio). Dado objetivo para decisões de treinamento e desenvolvimento. Saída: Planilha (.xlsx). • "Quem teve mais retrabalho nos últimos 90 dias?"
• "Ranking de correções por pessoa."
projetos-sem-gestao Detecta empreendimentos com tarefas atrasadas e sem nenhum responsável, o padrão clássico de projeto que perdeu o dono. Sugere quem deveria assumir cada caso, com base em quem mais atua na entrega afetada.  Saída: Tabela no chat. • "Quais projetos estão sem gestão ativa?"
• "Tem tarefa atrasada sem responsável em alguma obra?"

Portfólio e risco

Skill O que faz Exemplos de pedido
risco-de-portfolio Foto do risco hoje: classifica cada empreendimento ativo em Crítico / Alto / Moderado / Saudável, combinando % de atraso, tarefas sem responsável, pressão de entregas nos próximos 30 dias e saldo de horas. Painel com filtros + resumo executivo.  Saída: Painel interativo. • "Quais empreendimentos estão em risco?"
• "Mapa de calor do portfólio."
tendencia-de-atraso Análise preditiva: detecta os empreendimentos cujo cronograma está piorando — queda de velocidade, deadlines adiados, revisão crescendo, estimativas estourando — e gera um score de tendência com os fatores de risco de cada um.  Saída: Painel interativo. • "Quais projetos vão atrasar?"
• "O que está piorando no portfólio?"
analise-de-gargalo  Diagnóstico de causa raiz: mede quanto tempo as tarefas de um empreendimento ou processo passam em cada estágio (Fila / Em execução / Revisão) e aponta onde o fluxo trava, quem concentra o gargalo e qual ação tomar. Saída: Diagnóstico no chat. • "Onde o fluxo do 001-Sede AltoQi está travando?"
• "Em que etapa as tarefas mais empacam?"

Horas, fechamento e relatórios

Skill O que faz Exemplos de pedido
horas-por-colaborador Quanto cada colaborador trabalhou em cada empreendimento num período, com matriz pessoa × projeto, lançamentos detalhados dia a dia e custo estimado (quando há valor/hora cadastrado). Base do fechamento mensal.  Saída: Planilha (.xlsx). • "Quanto cada um trabalhou em junho?"
• "Fechamento de horas do mês por empreendimento."
horas-por-cliente Horas investidas em um cliente num período, detalhadas por colaborador e por tipo de entrega (planejador / processo / central), com custo estimado. Suporta cobrança, discussão de escopo e análise de rentabilidade. Saída: Planilha (.xlsx). • "Quantas horas investimos no cliente AltoQi em janeiro?"
• "Detalha as horas do cliente X por tipo de entrega."
relatorio-empreendimento Relatório consolidado por empreendimento: % concluído, % em atraso, % sem responsável, horas trabalhadas e horas estimadas pendentes, com formatação condicional e lista de tarefas críticas. Substitui o cruzamento manual de exportações. Saída: Planilha (.xlsx). • "Como está o empreendimento Village Brun?"
• "Relatório mensal dos contratos ativos."
relatorio-planejadores Visão integrada de cronograma: todos os planejadores ativos do portfólio com suas fases, datas de início e fim, % concluído e fases atrasadas, incluindo um Gantt por fase. Consolidação multi-projeto que hoje é montada na mão. Saída: Planilha (.xlsx). • "Lista os planejadores ativos com fases e datas."
• "Cronograma integrado dos planejadores."

Baixar Skills