# MCP (Model Context Protocol), RPA & Segurança LGPD no Kelpie OS

## 1. O que é o MCP explicado de forma prática

Se o modelo de IA é um cérebro isolado, o **MCP (Model Context Protocol)** é o barramento padronizado que fornece **olhos e mãos controladas** para consultar dados e executar ações em sistemas externos sem improvisar prompts soltos.

### Os 3 Blocos de um Servidor MCP Kelpie

1. **`Tools` (Ações e Consultas Escopadas):**
   - `consultar_agenda_disponivel(veterinario, data)`
   - `inserir_agendamento(pet_id, tutor_id, servico, horario)`
   - `consultar_historico_vacinas(pet_id)`
   - `verificar_cobertura_plano_petlove(numero_guia, procedimento)`
2. **`Resources` (Leitura Estruturada Somente Leitura):**
   - `prontuario://paciente/{id}`
   - `agenda://clinica/{data}`
3. **`Prompts` (Protocolos Clínicos e de Triagem):**
   - `triagem_emergencia_protocolo`
   - `resumo_soap_consulta`

---

## 2. Por que o MCP NÃO é invasivo para a clínica (Argumento Comercial & LGPD)

Uma dúvida comum ao vender o sistema é se conectar a IA via MCP/RPA invade a privacidade ou expõe o sistema inteiro da clínica:

1. **Princípio do Mínimo Privilégio:** a clínica não entrega acesso total ao banco de dados, nem expõe módulo financeiro, caixa, notas fiscais ou DRE. O servidor MCP publica apenas as `Tools` explicitamente autorizadas (agenda, carteira de vacinas, confirmação de consulta).
2. **Usuário Dedicado de Recepção:** quando a integração ocorre via RPA em sistemas sem API pública, recomenda-se criar um usuário restrito (ex.: perfil Recepção) apenas com permissão de leitura de agenda e criação de agendamentos.
3. **Política Determinística Antes do LLM (`Policy Engine`):** regras críticas (detecção de óbito de pet, sinais clínicos de emergência para escalonamento imediato, opt-out LGPD e janela de horário silencioso) rodam em código determinístico no servidor antes de qualquer resposta gerativa.
4. **Trilha de Auditoria & Cofre:** ações de agentes ficam registradas por evento/tenant (`audit_logs`) e credenciais de integração utilizam criptografia AES-256-GCM em repouso.

---

## 3. Camadas de Integração (Fluxo de Decisão)

```text
ERP / Sistema da Clínica
   ├── Tem API oficial ou MCP? ──► Conector nativo API / Servidor MCP (preferencial)
   └── Sistema fechado sem API? ──► Worker Python + Playwright (RPA)
                                      ├── Interceptação de requisições internas (XHR/fetch)
                                      ├── Automação em nuvem controlada por fila/idempotência
                                      └── Extensão de navegador opcional para alerta da recepção
```