Spring til hovedindhold

Forbind Synli med din AI-assistent

MCP er inkluderet i Pro og Enterprise og bruger organisationens API-adgang og fælles scanningskvote.

Klienten har seks afgrænsede værktøjer. Scanninger bruger godkendte gemte mål og samme kvote som øvrige Synli-scanninger. Rapportlinks er private og udløber.

Klientstøtte

  • Codex: alle seks værktøjer er testet, inklusive scanningsstart og PDF-rapportlinks med separat menneskelig bekræftelse.
  • Claude Desktop: målliste, scanningsstatus, sammendrag og fund er testet. Scanningsstart og rapportlinks understøttes ikke i den testede version, fordi Synlis bekræftelsesformular ikke vises.
  • GitHub Copilot i VS Code: kompatibilitetstesten mangler. MCP-støtte alene bekræfter ikke hele forløbet.

Før du starter

Brug Node.js 24.22.2 eller en nyere 24.x-version. Sikker nøglelagring er testet på Windows x64, macOS 15 arm64 og Ubuntu 24.04 x64 med Secret Service. Opret og godkend et gemt scanningsmål i Synli.

1. Installer den lokale klient

npm install --global https://synli.ai/downloads/synli-mcp-server-0.1.0.tgz
Hent kontrolsum

2. Opret en API-nøgle

Åbn API-nøgler i Synli og opret en kortvarig nøgle med targets:read, scans:read, scans:write og reports:read. Kør kommandoen i din egen terminal og indsæt kun nøglen i det skjulte felt, aldrig i en AI-chat eller klientkonfiguration.

Åbn API-nøgler
synli-mcp auth login --origin https://api.synli.ai --profile synli_customer_mcp

3. Forbind assistenten

Brug kommandoen og argumenterne nedenfor i klientens MCP-indstillinger. Profilnavnet identificerer nøglen i operativsystemets sikre lager; det er ikke selve nøglen.

Kør npm root -g for at finde installationsmappen. Erstat første argument nedenfor med mappen efterfulgt af /@synli/mcp-server/dist/cli-bin.js. Brug skråstreger også i Windows-stier.

{
  "command": "node",
  "args": [
    "/absolute/path/to/node_modules/@synli/mcp-server/dist/cli-bin.js",
    "serve",
    "--origin",
    "https://api.synli.ai",
    "--profile",
    "synli_customer_mcp"
  ]
}

Afbryd forbindelsen

Tilbagekald nøglen i Synli og fjern den lokale nøgle med kommandoen nedenfor.

synli-mcp auth logout --origin https://api.synli.ai --profile synli_customer_mcp