Skip to main content

​
Model Context Protocol (MCP)

PulseGuard ondersteunt het Model Context Protocol (MCP), waardoor je PulseGuard kunt gebruiken in AI assistants zoals ChatGPT. Hiermee kun je je monitoring data direct opvragen via natuurlijke taal.

​
Overzicht

Het MCP server van PulseGuard stelt je in staat om:
  • Dashboard statistieken te bekijken
  • Domeinen en uptime te monitoren
  • Incidenten bij te houden
  • Device status te controleren
  • Netwerk scans uit te voeren (DNS, poorten)

​
Setup in ChatGPT

​
1. Custom Action Aanmaken

  1. Ga naar ChatGPT Settings → Actions → Create new action
  2. Server Details invullen: 
    Server URL: https://api.ipulse.one/mcp
Authentication: Bearer token (optioneel)
  3. Schema importeren of gebruik de beschikbare tools
  4. Verbinding testen: Vraag ChatGPT: “Laat me mijn PulseGuard dashboard zien”

​
Beschikbare Tools

​
1. Dashboard Statistieken Opvragen

Tool Naam: get_dashboard_stats Haalt uitgebreide monitoring statistieken op. Parameters:
  • organizationId (optioneel): Filter statistieken per organisatie
Response: 
{
  "domains": { "total": 10, "up": 8, "down": 2, "uptime": 95 },
  "devices": { "total": 5, "online": 4, "offline": 1 },
  "services": { "total": 15, "up": 14, "down": 1 },
  "incidents": { "active": 3, "critical": 1 }
}

​
2. Incidenten Lijst

Tool Naam: list_incidents Haal een lijst van incidenten op met filtering. Parameters:
  • status (optioneel): Filter op status (open, investigating, resolved, etc.)
  • severity (optioneel): Filter op severity (low, medium, high, critical)
  • organizationId (optioneel): Filter per organisatie
  • limit (optioneel, standaard: 20): Aantal resultaten
Response: 
{
  "incidents": [...],
  "total": 50,
  "summary": {
    "open": 10,
    "critical": 2
  }
}

​
3. Domeinen Status

Tool Naam: get_domains_status Haal monitoring status voor alle domeinen op. Parameters:
  • organizationId (optioneel): Filter per organisatie
Response: 
{
  "summary": {
    "total": 10,
    "up": 8,
    "down": 2,
    "avgResponseTime": 150,
    "uptime": 95.5
  },
  "domains": [...]
}

​
4. DNS Records Scannen

Tool Naam: scan_dns Scan DNS records voor een domein. Parameters:
  • domain (vereist): Domeinnaam om te scannen
Response: 
{
  "domain": "example.com",
  "records": [...],
  "total": 15
}

​
5. Poorten Scannen

Tool Naam: scan_ports Scan veelgebruikte poorten op een host. Parameters:
  • host (vereist): Hostname of IP adres
  • ports (optioneel): Komma-gescheiden poorten of range
Response: 
{
  "host": "example.com",
  "openPorts": [...],
  "totalScanned": 15
}

​
6. Devices Status

Tool Naam: get_devices_status Haal status en metrics voor gemonitorde devices op. Parameters:
  • organizationId (vereist): Organisatie ID
Response: 
{
  "devices": [...],
  "total": 5,
  "online": 4,
  "offline": 1
}

​
UI Componenten

Het MCP server bevat kant-en-klare UI componenten die renderen in ChatGPT:

​
Dashboard Widget

  • Toont real-time monitoring statistieken
  • Geeft aantal domeinen, devices, services en incidenten weer
  • Kleur-gecodeerde status indicatoren

​
Incidenten Widget

  • Lijst incidenten met severity en status
  • Kleur-gecodeerd per severity niveau
  • Toont aanmaaktijd en metadata

​
Domeinen Widget

  • Samenvattingsstatistieken (uptime, response time)
  • Lijst van gemonitorde domeinen met status
  • Visuele status indicatoren

​
Voorbeeld Prompts

  • “Laat me mijn monitoring dashboard zien”
  • “Geef alle kritieke incidenten”
  • “Wat is de status van mijn domeinen?”
  • “Scan DNS records voor example.com”
  • “Controleer poort 443 op example.com”
  • “Laat offline devices zien”

​
Authenticatie

Het MCP server ondersteunt Clerk authenticatie: 
POST /mcp
Authorization: Bearer <clerk-jwt-token>
User context wordt geëxtraheerd uit de JWT en gebruikt om resultaten te filteren.

​
Development

​
Lokaal Testen

  1. Start de backend:
cd apps/backend
bun run start:dev
  1. Test met curl:
curl -X POST http://localhost:3001/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'
  1. Gebruik MCP Inspector:
npx @modelcontextprotocol/inspector http://localhost:3001/mcp

​
Troubleshooting

​
Veelvoorkomende Problemen

  1. CORS Errors:
    • Zorg ervoor dat CORS is ingeschakeld in NestJS main.ts
    • Controleer of toegestane origins ChatGPT domeinen bevatten
  2. Authenticatie Fouten:
    • Controleer of Clerk JWT geldig is
    • Controleer authorization header formaat
  3. Tool Niet Gevonden:
    • Controleer of tool is geregistreerd in mcp.service.ts
    • Controleer of tool naam exact overeenkomt

​
Debug Mode

Schakel debug logging in: 
// In mcp.controller.ts
this.logger.debug(`MCP Request: ${JSON.stringify(body)}`);

​
Meer Informatie