DashDescomplicar/okf/entidades/Integracao-MCP-Gateway.md

type, layer, tags, title

type	layer	tags	title
Entity	wiki	stack dashdescomplicar backend integracao mcp gateway	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