Standalone gateway · Streamable HTTP · Private preview

Connect Grok & Any LLM to Your Active Defence via MCP

Use natural language to explore OrionEye SSH telemetry, compare coordinated campaign confidence, enrich an indicator with AbuseIPDB context, and submit a finding to the moderated Intel Feed from an MCP-compatible client.

Grok/xAI directory availability subject to vendor support and approval
Client support is not implied. Claude Code supports remote HTTP MCP configuration. The current public xAI documentation does not verify a custom MCP server flow in the Grok consumer UI; connect Grok only if your client release explicitly supports remote MCP. No official xAI partnership or directory listing is claimed.

Watch: connecting an LLM client in 90 seconds

Generate the gateway URL and token in OrionEye, add them as a custom MCP server in your client, then ask in plain language while the OrionEye map follows the conversation. Any action stops at a human approval gate.

Animated walkthrough with sample data, no audio. The URL and token shown are examples: use the endpoint under “Example connection”. In MCP v1 a block request stays a proposal that the operator reviews in OrionEye.

How it works

  1. 01 · Sign in

    Authorize with OrionEye

    Enterprise users can sign in with their OrionEye account or Google when configured. OAuth uses PKCE and never creates or replaces the normal web-app session.

  2. 02 · Connect

    Add the MCP server URL

    Enter the HTTPS endpoint in a client that supports MCP OAuth discovery. The gateway checks the Enterprise entitlement again for every request; Pro clients may still use an administrator-provisioned bearer where supported.

  3. 03 · Investigate

    Ask, review, then act

    Query threat intelligence or submit an item to moderation. A campaign-block request creates a proposal only; the operator must review it in OrionEye.

What the connector exposes

Read-only resources

orioneye://threats/live
orioneye://campaigns/active
orioneye://telemetry/server
orioneye://intel/feed

IP usernames, server labels, and other internal fields are removed. Feed reads return published items only.

Threat investigation

investigate_ip(ip) combines the tracked SSH record with the AbuseIPDB dossier. It does not report or block an address.

Moderated contribution

post_intel_feed(indicator, severity) creates a submission with status in_review. A human moderator decides whether to publish it.

Action proposal

block_campaign(campaign_id) creates an HMAC-audited proposal. MCP v1 never calls Fail2Ban or the OmniAgent approval endpoint.

Bounded network tools

Enterprise clients may run ping or traceroute only for public IPv4 addresses already in OrionEye threat telemetry, and search RIPE Atlas within a radius capped at 200 km.

Telemetry scope

Health and uptime are exposed. The existing OmniAgent pairing endpoint does not provide CPU, memory, or full SRE metrics.

Example connection

For clients with MCP OAuth discovery, enter the server URL and complete OrionEye sign-in:

https://orioneye.io/mcp

For clients that require a bearer header, an administrator may provision a token securely. For Claude Code, use the remote HTTP transport:

claude mcp add --transport http orioneye \
  https://orioneye.io/mcp \
  --header "Authorization: Bearer YOUR_MCP_CLIENT_TOKEN"

For Claude.ai, Claude Desktop, or Grok, use the custom connector workflow only where that product, account and release support remote MCP. Provider menus and auth options can change; consult the vendor's current documentation.

Example questions:

Plan access

Free

No MCP client token is issued.

Pro

Up to two clients per workspace. Read resources, threat queries and moderated Intel Feed submissions.

Enterprise

Includes proposal and bounded network tools, plus OAuth sign-in with current Enterprise entitlement checks. One gateway instance serves one workspace; OAuth tokens expire after one hour and are reissued through sign-in.

OAuth requires a client that supports MCP's OAuth discovery flow; Grok's consumer connector compatibility is not confirmed. Google sign-in appears only when configured. The gateway uses a privileged backend credential internally, never exposes it to clients, and checks the account's Enterprise plan on every OAuth-authenticated MCP request.

Security by design

Gateway autonomo · Streamable HTTP · Anteprima privata

Collega Grok e qualsiasi LLM alla tua Active Defence via MCP

Usa il linguaggio naturale per esplorare la telemetria SSH di OrionEye, confrontare l’affidabilità delle campagne coordinate, arricchire un indicatore con il contesto di AbuseIPDB e inviare una segnalazione all’Intel Feed moderato da un client compatibile con MCP.

Disponibilità nella directory di Grok/xAI soggetta al supporto e all’approvazione del fornitore
Il supporto dei client non è scontato. Claude Code supporta la configurazione MCP remota via HTTP. La documentazione pubblica attuale di xAI non conferma un flusso per server MCP personalizzati nell’interfaccia consumer di Grok: collega Grok solo se la versione del tuo client supporta esplicitamente MCP remoto. Non dichiariamo alcuna partnership ufficiale con xAI né alcuna presenza nella sua directory.

Guarda: collegare un client LLM in 90 secondi

Generi in OrionEye l’URL del gateway e il token, li aggiungi come server MCP personalizzato nel tuo client, poi chiedi a parole mentre la mappa di OrionEye segue la conversazione. Ogni azione si ferma a un’approvazione umana.

Dimostrazione animata con dati di esempio, senza audio, sottotitoli in inglese. URL e token mostrati sono esempi: usa l’endpoint in «Esempio di collegamento». In MCP v1 una richiesta di blocco resta una proposta che l’operatore esamina in OrionEye.

Come funziona

  1. 01 · Accesso

    Autorizza con OrionEye

    Gli utenti Enterprise accedono con il proprio account OrionEye, o con Google se configurato. OAuth usa PKCE e non crea né sostituisce mai la normale sessione dell’app web.

  2. 02 · Collegamento

    Aggiungi l’URL del server MCP

    Inserisci l’endpoint HTTPS in un client che supporti la discovery OAuth di MCP. Il gateway ricontrolla il diritto Enterprise a ogni richiesta; i client Pro possono usare un token bearer fornito dall’amministratore, dove supportato.

  3. 03 · Indagine

    Chiedi, verifica, poi agisci

    Interroga la threat intelligence o invia un elemento alla moderazione. Una richiesta di blocco di una campagna crea solo una proposta: l’operatore deve esaminarla in OrionEye.

Cosa espone il connettore

Risorse in sola lettura

orioneye://threats/live
orioneye://campaigns/active
orioneye://telemetry/server
orioneye://intel/feed

Nomi utente, etichette dei server e altri campi interni vengono rimossi. Le letture del feed restituiscono solo elementi pubblicati.

Indagine sulle minacce

investigate_ip(ip) unisce il record SSH tracciato al dossier di AbuseIPDB. Non segnala né blocca l’indirizzo.

Contributo moderato

post_intel_feed(indicator, severity) crea un invio con stato in_review. Decide un moderatore umano se pubblicarlo.

Proposta di azione

block_campaign(campaign_id) crea una proposta registrata con HMAC. MCP v1 non chiama mai Fail2Ban né l’endpoint di approvazione di OmniAgent.

Strumenti di rete limitati

I client Enterprise possono eseguire ping o traceroute solo verso indirizzi IPv4 pubblici già presenti nella telemetria delle minacce di OrionEye, e cercare in RIPE Atlas entro un raggio massimo di 200 km.

Perimetro della telemetria

Sono esposti stato e uptime. L’endpoint di associazione di OmniAgent esistente non fornisce CPU, memoria né metriche SRE complete.

Esempio di collegamento

Per i client con discovery OAuth di MCP, inserisci l’URL del server e completa l’accesso a OrionEye:

https://orioneye.io/mcp

Per i client che richiedono un header bearer, un amministratore può fornire un token in modo sicuro. Per Claude Code, usa il trasporto HTTP remoto:

claude mcp add --transport http orioneye \
  https://orioneye.io/mcp \
  --header "Authorization: Bearer YOUR_MCP_CLIENT_TOKEN"

Per Claude.ai, Claude Desktop o Grok, usa la procedura del connettore personalizzato solo dove quel prodotto, quell’account e quella versione supportano MCP remoto. Menu e opzioni di autenticazione dei fornitori possono cambiare: consulta la loro documentazione aggiornata.

Domande di esempio:

Accesso per piano

Free

Nessun token client MCP.

Pro

Fino a due client per workspace. Risorse in lettura, interrogazioni sulle minacce e invii moderati all’Intel Feed.

Enterprise

Include le proposte e gli strumenti di rete limitati, più l’accesso OAuth con il controllo aggiornato del diritto Enterprise. Un’istanza del gateway serve un workspace; i token OAuth scadono dopo un’ora e si rinnovano con l’accesso.

OAuth richiede un client che supporti il flusso di discovery OAuth di MCP; la compatibilità del connettore consumer di Grok non è confermata. L’accesso con Google compare solo se configurato. Il gateway usa internamente una credenziale privilegiata del backend, non la espone mai ai client, e controlla il piano Enterprise dell’account a ogni richiesta MCP autenticata con OAuth.

Sicurezza per costruzione