Servidor MCP de Cyberwatch

Presentació

El Model Context Protocol (MCP) és un protocol obert que permet als agents d’IA (Claude Desktop, ChatGPT, Gemini, etc.) interactuar amb serveis externs. Cyberwatch incorpora un servidor MCP que permet al vostre agent d’IA controlar Cyberwatch en llenguatge natural.

Connexió des del vostre client d’IA

L’URL del servidor MCP que cal indicar al vostre client és:

https://<votre-instance>/api/v3/mcp

L’autenticació es gestiona automàticament amb OAuth 2.0: en la primera connexió, el vostre client obre un navegador perquè inicieu la sessió a Cyberwatch i autoritzeu l’accés.

sequenceDiagram
  participant C as Client d'IA
  participant B as Navegador
  participant CBW as Cyberwatch
  C->>CBW: Connexió a /api/v3/mcp
  CBW-->>C: Cal autenticació OAuth 2.0
  C->>B: Obertura de la pàgina d'autorització
  B->>CBW: Inici de sessió (o sessió ja oberta)
  Note over CBW: Client MCP autoritzat<br/>i URI de redirecció conegut?
  B->>CBW: Autorització de l'accés
  CBW-->>C: Testimoni d'accés (PKCE S256)
  C->>CBW: Sol·licituds JSON-RPC
  Note over C,CBW: Drets limitats als projectes<br/>accessibles al compte connectat

En lloc de configurar el servidor MCP individualment a cada estació de treball, és preferible crear una aplicació o un connector a nivell del vostre client d’IA. Així, tots els membres de l’organització hi poden accedir sense cap configuració addicional.

Per a més detalls, consulteu la documentació del client d’IA corresponent (Claude, ChatGPT, Gemini, Cursor, etc.) per conèixer el procediment de configuració.

Delegar l’autorització a un compte robot

Per defecte, l’agent d’IA actua amb els drets de l’usuari que ha iniciat la sessió durant el flux d’autorització. Es pot delegar aquesta autorització a un compte de servei dedicat.

Per fer-ho, inicieu la sessió a la interfície de Cyberwatch en un navegador amb el compte robot abans d’iniciar la connexió MCP al client d’IA. Aleshores, el flux OAuth utilitzarà la sessió oberta i l’agent actuarà amb els drets d’aquest compte.

Aquest enfocament és útil per als usos automatitzats o compartits, per no exposar els drets d’un compte personal.

Què podeu fer amb l’agent d’IA

Un cop connectat, l’agent d’IA pot interactuar amb Cyberwatch per:

Consultar els actius i les vulnerabilitats

Llistar i cercar actius (per nom d’amfitrió, adreça IP, sistema operatiu…)
Consultar les vulnerabilitats associades a un actiu
Accedir a les puntuacions i als detalls de les CVE

Gestionar els escanejos

Consultar els descobriments de xarxa en curs
Tornar a executar escanejos en actius

Fer el seguiment de la conformitat

Consultar els controls de conformitat i el seu estat
Accedir als resultats de conformitat per actiu

Gestionar els pedaços

Iniciar accions d’aplicació de pedaços
Tornar a executar reinicis planificats

Les operacions d’aplicació de pedaços i de reinici només estan disponibles si els paràmetres corresponents estan activats a la instància de Cyberwatch. Els drets de l’agent sempre queden limitats als projectes accessibles al compte connectat.

Clients MCP autoritzats

Només els clients MCP autoritzats explícitament poden iniciar un flux OAuth amb Cyberwatch. Cada client autoritzat s’identifica amb un nom i la llista dels seus URI de redirecció.

Clients configurats per defecte

Els clients següents estan preconfigurats:

Anthropic (Claude)
OpenAI (ChatGPT)
Mistral (Vibe)

Afegir un client MCP autoritzat

Per autoritzar un client MCP nou:

Aneu a Administració > Eines externes > Clients MCP autoritzats.
Feu clic al botó + per afegir un client nou.
Indiqueu el nom del client.
Indiqueu els URI de redirecció, un per línia.
Feu clic a «Desa» per confirmar la configuració.

Per suprimir un client, utilitzeu la icona de la paperera que hi ha al costat del client corresponent i, després, deseu.

Qualsevol modificació de la llista de clients autoritzats revoca les sessions MCP en curs. Els usuaris hauran de tornar a connectar-se des del seu client d’IA.

Estàndards complerts

El servidor MCP de Cyberwatch compleix els estàndards següents:

Model Context Protocol — versió 2025-06-18
OAuth 2.0 Authorization Server Metadata — RFC 8414
OAuth 2.0 Protected Resource Metadata — RFC 9728
OAuth 2.0 Dynamic Client Registration — RFC 7591
PKCE — RFC 7636 (mètode S256 obligatori)
JSON-RPC 2.0