Guia para usuários |
1. O que é o Stratws MCP?
O Stratws MCP (Model Context Protocol) é uma ponte que conecta assistentes de inteligência artificial - como o Claude, da Anthropic - diretamente ao seu ambiente do Stratws One. Com ele, você pode pedir ao assistente de IA que consulte indicadores, verifique tarefas, liste usuários, cheque programas de resultados e muito mais - tudo em linguagem natural, sem precisar abrir o sistema manualmente.
Pense no MCP como um "tradutor inteligente": você faz uma pergunta em português, e o assistente sabe exatamente onde buscar a informação dentro do Stratws One para te responder.
💡
Analogia simples: É como ter um assistente pessoal que conhece o Stratws One de cor e pode consultar qualquer dado para você em segundos, sem que você precise navegar pelas telas do sistema.
2. O que você pode fazer com ele
O Stratws MCP cobre os principais módulos da plataforma. Veja abaixo as grandes áreas de atuação:
3. Capacidades detalhadas por módulo
A tabela abaixo detalha o que o assistente pode fazer em cada módulo, separando as ações de Consulta (somente leitura) das ações de Escrita (que alteram dados no sistema).
| Módulo | O que o assistente pode fazer | Tipo |
|---|---|---|
| Indicadores | Listar indicadores com nome, código, frequência, unidade de medida, tolerâncias de farol e área de resultados | Consulta |
| Consultar fórmulas de cálculo e desdobramentos (de onde vem o número de um indicador) | Consulta | |
| Buscar valores realizados, metas, projetados e programados em um período específico | Consulta | |
| Importar ou atualizar valores de indicadores (real, meta, projetado, programado) | Escrita | |
| Planos de Ação | Listar todos os planos de ação e cronogramas em execução com tipo e entidade dona | Consulta |
| Consultar detalhes de um plano específico (tipo, status, quantidade de tarefas) | Consulta | |
| Tarefas | Listar tarefas por plano, filtrar por status (não iniciada / em andamento / concluída) ou por atraso | Consulta |
| Criar novas tarefas em um plano de ação ou cronograma | Escrita | |
| Atualizar uma ou várias tarefas de uma vez (campos, datas, status) | Escrita | |
| Projetos | Buscar projetos por nome/descrição, ver fase, líder, % previsto x realizado | Consulta |
| Soluções de Problema | Listar e consultar o detalhamento de soluções de problema (por número ou identificador) | Consulta |
| Prog. de Resultados | Listar programas de RV ativos e seus painéis com blocos, pesos e itens | Consulta |
| Reuniões 1:1 | Listar, criar e editar reuniões 1:1 com subordinados diretos ou chefe | Escrita |
| Ler, registrar tópicos de pauta e notas privadas de reuniões | Escrita | |
| Estrutura Org. | Listar usuários, UGs, planos de gestão e empresas (conforme sua permissão) | Consulta |
4. Exemplos de uso no dia a dia
Veja como ficam conversas reais com o assistente conectado ao Stratws MCP. Você não precisa usar termos técnicos - fale naturalmente.
📊 Consultando indicadores
✅ Verificando tarefas atrasadas
1. "Revisar planilha de metas" - responsável: João Silva - prazo: 10/07
2. "Reunião com fornecedor" - responsável: Maria Souza - prazo: 15/07
3. "Atualizar painel de indicadores" - responsável: Pedro Lima - prazo: 20/07
📁 Buscando um projeto
🗓️ Criando uma reunião 1:1
🏆 Consultando programa de resultados
5. Boas práticas
✍️ Como perguntar bem
- Economize tokens. Evite prompts amplos que façam o assistena buscar muitos dados. Informe sempre nomes, períodos, módulo, IDs específicos para reduzir o volume de informação processada. Por exemplo: Em vez de "me mostre os indicadores de 2026", prefira "me mostre os indicadores da minha UG, área de trabalho Y, no ano de 2026".
- Mencione o módulo e detalhes do que quer saber souber. "Me liste as tarefas do plano de ação da Solução de Problema 125/2026" é mais eficiente do que "o que tem pendente na Solução de Problema da UG X"
- Confirme antes de alterar dados. Para ações de escrita (atualizar valores, criar tarefas), revise o que o assistente mostrará antes de confirmar.
- Use o número do Projeto e Solução de Problemas quando tiver. Por exemplo: "Resuma o Projeto 1234/2026" resolve mais rápido do que "Resuma o Projeto Evolução de Barragens")
✅
Dica de ouro: O assistente respeita exatamente as suas permissões no Stratws One. Você só verá dados que teria acesso normalmente pela plataforma - nada mais, nada menos.
🔄 Ações de escrita - cuidados essenciais
⚠️
Atenção: Ações como importar valores de indicadores, criar tarefas ou atualizar informações são executadas de verdade no Stratws One. Sempre revise o que o assistente vai fazer antes de confirmar uma ação de escrita.
- Antes de importar valores, confirme: indicador, período, frequência e o próprio valor numérico.
- Ao criar tarefas, verifique o plano de ação correto - uma mesma entidade pode ter vários planos.
- Se errar um valor importado, é possível corrigi-lo pedindo ao assistente para sobrescrever com o valor correto.
🌐 Acesso a múltiplas empresas
Se você tiver acesso a mais de uma empresa (tenant) no Stratws One, sempre informe ao assistente com qual empresa deseja trabalhar no início da conversa. O token de acesso é vinculado a um tenant por vez.
6. Limitações importantes
🚫
O MCP não substitui o Stratws One. Ele é uma camada de consulta e automação - funcionalidades de configuração avançada, criação de indicadores, upload de arquivos em lote e relatórios visuais continuam sendo realizadas diretamente na plataforma.
- Permissões são respeitadas: o assistente não consegue acessar dados fora do seu escopo de permissão no sistema.
- Sem dados em tempo real absoluto: os dados refletem o estado do Stratws One no momento da consulta; alterações feitas simultaneamente por outras pessoas podem não aparecer imediatamente.
- Hierarquia de desdobramento: ao consultar fórmulas de indicadores, o assistente retorna um nível de hierarquia por vez. Para indicadores muito complexos, pode ser necessário aprofundar em etapas.
- Relatórios visuais e dashboards: o MCP retorna dados em texto e números - não gera gráficos ou painéis visuais nativos do Stratws One.
- Feedbacks: o envio de feedbacks entre colegas pelo assistente requer o uso do template de mensagem correto configurado na plataforma.
7. Perguntas frequentes
O MCP é seguro? Meus dados ficam protegidos?
Sim. O MCP utiliza o mesmo sistema de autenticação e permissões do Stratws One. O assistente só acessa dados que você já teria permissão de ver normalmente na plataforma. Nenhum dado é compartilhado fora do ambiente autorizado.
Preciso saber programar para usar?
Não. O MCP foi desenvolvido para ser usado em linguagem natural. Basta conversar com o assistente de IA como você conversaria com um colega de trabalho.
O assistente pode errar?
O assistente busca os dados diretamente do Stratws One, então as informações consultadas são precisas. Porém, ao interpretar pedidos ambíguos, ele pode consultar dados diferentes do esperado. Sempre confirme se o resultado faz sentido antes de tomar decisões. O histórico do seu GPT ou Claude pode impactar a análise.
Posso usar o MCP com qualquer assistente de IA?
O Stratws MCP é compatível com assistentes que suportam o padrão MCP, como o Claude (Anthropic) e GPT. Consulte o time de TI da sua empresa para saber quais integrações estão habilitadas no seu ambiente.
O que acontece se eu pedir algo que não tenho permissão para ver?
O assistente simplesmente não retornará os dados restritos. Você receberá uma resposta informando que não há itens disponíveis para aquela consulta - o que, nesse caso, significa que estão fora do seu escopo de permissão.
Posso usar o MCP para lançar valores de indicadores em lote?
Sim! Essa é uma das funcionalidades mais poderosas. Você pode informar uma lista de indicadores com seus respectivos valores e períodos, e o assistente importará tudo de uma vez no Stratws One.
📞
Precisa de ajuda? Se tiver dúvidas ou encontrar algum problema, abra um chamado no portal de suporte da Siteware. Nosso time está pronto para te ajudar.
Comentários
0 comentário
Por favor, entre para comentar.