docs(okf): entidades e relacionamentos OKF do DashDescomplicar

2026-10-28 16:01:20 +00:00
parent f063a2ec8c
commit 61ae4697f9
48 changed files with 2610 additions and 0 deletions
@@ -0,0 +1,58 @@
+---
+type: Entity
+layer: wiki
+tags: [stack, dashdescomplicar, backend, integracao, mcp, gateway]
+title: "Integracao-MCP-Gateway"
+---
+
+# Integracao-MCP-Gateway
+
+Monitorização do MCP Gateway (`gateway.descomplicar.pt`). Faz ping paralelo a 32 MCPs registados e expõe estado (online/offline/disabled) com cache de 60 segundos.
+
+## Responsabilidades
+
+- **Ping Paralelo**: Verifica health de cada MCP via HTTP (timeout 5s)
+- **Gateway Status**: Verifica se o gateway está online
+- **Categorização**: CRM, Infra, AI, Tools, External, Gateway, Project
+- **Cache**: 60 segundos TTL para evitar sobrecarga
+- **Auth Info**: Expõe método de autenticação e expiração do token
+
+## Stack
+
+- **Gateway**: `https://gateway.descomplicar.pt`
+- **Auth**: `MCP_GATEWAY_TOKEN` (Bearer)
+- **Ping**: HTTP GET com timeout 5s por MCP
+- **Cache**: Em memória, 60s TTL
+
+## MCPs Monitorizados (32)
+
+| Categoria | MCPs | Exemplos |
+|---|---|---|
+| CRM | 2 | desk-crm-v3 (3150), desk-project-minimal (3153, disabled) |
+| Infra | 3 | ssh-unified (3192), filesystem, chrome-devtools |
+| AI | 5 | lightrag (3160), memory-supabase (3151), notebooklm (3190) |
+| Tools | 5 | mcp-time (3155), deepl (3188), pexels, vimeo, drawio |
+| External | 9 | google-workspace (3156), gitea (3162), moloni (3158), n8n |
+| Gateway | 4 | authentik, spaceship, puppeteer, lighthouse |
+| Project | 2 | carl-mcp, reonic |
+
+## Rotas
+
+| Método | Rota | Função |
+|---|---|---|
+| `GET` | `/api/mcps` | Dashboard com estado de todos os MCPs |
+
+## Localizações
+
+- **Código**: `api/services/mcps.ts` (219 linhas), `api/routes/mcps.ts` (24 linhas)
+
+## Dependências
+
+- **MCP Gateway**: `MCP_GATEWAY_URL` e `MCP_GATEWAY_TOKEN`
+- **Express-API**: Rota `/api/mcps`
+
+## Fornece a
+
+- **Painel-MCPs**: Estado de todos os MCPs (online/offline/disabled)
+- **Painel-IA**: Camada 1 (Claude Code) — contagem de MCPs
+- **Express-API**: Rota `/api/mcps`