Governança do Power Automate com FlowStudio MCP

Classifique, marque e governe fluxos do Power Automate em escala através do cache do FlowStudio MCP — sem Dataverse, sem o CoE Starter Kit e sem o portal do Power Automate.

Esta habilidade usa a mesma família de ferramentas store_* que flowstudio-power-automate-monitoring, mas com um propósito diferente: a governança escreve metadados (update_store_flow) e lê para resultados de auditoria e classificação. O monitoramento lê as mesmas ferramentas para resultados de saúde operacional. Não tente memorizar qual habilidade "possui" qual ferramenta — escolha pelo que o usuário está fazendo. Para verificações de saúde e painéis de taxa de falha, carregue flowstudio-power-automate-monitoring em vez disso.

⚠️ Assinatura Pro+ necessária. Esta habilidade chama ferramentas store_* que funcionam apenas para assinantes do FlowStudio para Teams ou MCP Pro+.

Se o usuário não tiver acesso Pro+: a primeira chamada de ferramenta store_* retornará um erro 403/404. Quando isso acontecer:

1. PARE de chamar ferramentas do cache
2. Informe ao usuário que os recursos de governança exigem uma assinatura Pro+
3. Encaminhe-o para https://mcp.flowstudio.app/pricing

Descoberta: carregue esquemas de ferramentas através das meta-ferramentas em vez de tools/list — chame tool_search com query: "skill:governance" para o pacote canônico, ou query: "select:update_store_flow" para uma única ferramenta. Esta habilidade cobre padrões de fluxo de trabalho e semântica de campos — coisas que tool_search não pode lhe dizer. Se este documento discordar de uma resposta real da API, a API prevalece.

Crítico: Como Extrair IDs de Fluxo

list_store_flows retorna id no formato <environmentId>.<flowId>. Você deve dividir na primeira . para obter environmentName e flowName para todas as outras ferramentas:

id = "Default-<envGuid>.<flowGuid>"
environmentName = "Default-<envGuid>"    (everything before first ".")
flowName = "<flowGuid>"                  (everything after first ".")

Além disso: ignore entradas que não tenham displayName ou que tenham state=Deleted — estes são registros esparsos ou fluxos que não existem mais no Power Automate. Se um fluxo excluído tiver monitor=true, sugira desabilitar o monitoramento (update_store_flow com monitor=false) para liberar um slot de monitoramento (o plano padrão inclui 20).

A Ferramenta de Escrita: update_store_flow

update_store_flow escreve metadados de governança apenas no cache do FlowStudio — ele NÃO modifica o fluxo no Power Automate. Esses campos não são visíveis através de get_live_flow ou do portal do PA. Eles existem apenas no cache do FlowStudio e são usados pelo pipeline de escaneamento e pelas regras de notificação do FlowStudio.

Isso significa:

• ownerTeam / supportEmail — define quem o FlowStudio considera o contato de governança. NÃO altera o proprietário real do fluxo no PA.
• rule_notify_email — define quem recebe notificações de falha/execução ausente do FlowStudio. NÃO altera os alertas de falha de fluxo integrados da Microsoft.
• monitor / critical / businessImpact — apenas classificação do FlowStudio. O Power Automate não tem campos equivalentes.

Semântica de mesclagem — apenas os campos que você fornece são atualizados. Retorna o registro completo atualizado (mesma forma que get_store_flow).

Parâmetros obrigatórios: environmentName, flowName. Todos os outros campos são opcionais.

Campos Configuráveis

Cuidado com security: O campo security em get_store_flow contém JSON estruturado (por exemplo, {"triggerRequestAuthenticationType":"All"}).

…