MPR Integration Hub v0.1.0

API central dos programas MPR. O ChatGPT e o MCP ligam-se aqui — nunca directamente às bases de dados. Esta página serve para ver o que existe e experimentar as operações, não para o trabalho do dia-a-dia nas apps.

O que fazer aqui
  1. Abra o explorador da API.
  2. Clique em Authenticate e cole a chave X-MPR-Hub-Key (está no .env do Hub, campo MPR_HUB_API_KEYS).
  3. Comece por Programas ligados — confirma que vê Gestão Sociedades, ENI, Têxtil, WA, AEF, etc.
  4. Depois use Procurar ou Resumo com app: gestao_sociedades (ou outro app_id).
  5. Alterar dados e executar robôs fica para depois; nesta fase o normal é só leitura.
  6. Erros críticos podem ir ao Cursor (investigar ou PR). O Hub nunca faz deploy.

Consultar

Leitura
Programas ligados Lista todas as apps do Hub e o que cada uma sabe fazer.
Leitura
Capacidades de um programa O que aquele conector permite: clientes, obrigações, stocks…
Leitura
Procurar Pesquisa atravessando um programa (nome, NIF, tarefa, artigo).
Leitura
Ficha Um registo concreto: cliente, documento, viatura.
Leitura
Listar Lista filtrada (tarefas, obrigações, recolhas, stocks).
Leitura
Resumo O que está pendente neste cliente, cruzando o que o programa souber.

Alterar (com confirmação)

Escrita
Criar / alterar Tarefa, aviso, nota. A IA não executa SQL — só acções com nome.
Robô
Executar Recolhas e processos. Sensível: exige confirmação.
Reconciliação
Reconciliar Compara uma listagem com o programa. Só grava depois de aprovar.

Cursor (código)

Incidente
Abrir incidente App, módulo, erro, versão. O Hub já sabe o repositório Git.
Incidente
Listar / ver incidente O que o ChatGPT usa em «vê o erro desta manhã».
Análise
Analisar incidente Bug de código vs portal externo. Só depois se chama o Cursor.
Nível 1
Investigar Cloud Agent só com diagnóstico. Sem patch.
Nível 2
Corrigir + PR Código, testes e pull request. Sem produção.
Estado
Estado / resultado O agente acabou? Qual é a PR?
PRs
Correções Histórico. Aprovar no Hub não faz merge.

Eventos e auditoria

Eventos
Receber evento Os programas avisam o Hub (recolha falhou, documento chegou…). O Hub decide o destino.
Erros
Receber erro Formato standard. Timeouts/AT/SS não disparam o Cursor.
Auditoria
Quem fez o quê Histórico: utilizador, origem (ChatGPT/API), app, acção, resultado.
Sistema
Saúde do serviço Confirma que o Hub está a correr.