Vai al contenuto
NotHolyDocs

MCP

API e MCP

L'API ti dà il modello grezzo. Il server MCP dà a quel modello CKE 2.0 e gli strumenti di ricerca. Collega entrambi.

Vedi in Markdown

NotHoly offre due superfici, e fanno lavori diversi.

  • L'API su https://api.notholy.com/v1 è inferenza pura. Invii i messaggi, ricevi la risposta del modello. È compatibile con OpenAI e Anthropic, quindi qualsiasi client che parla quelle API parla NotHoly. Qui il modello non ha né recupero né strumenti propri.
  • Il server MCP su https://api.notholy.com/mcp è il livello di intelligenza. Dà a un modello Cybersecurity Knowledge Engine 2.0 (CKE 2.0) e gli strumenti di ricerca: record CVE, bollettini sui pacchetti, lettura di web e pagine, analisi di file, intelligence di rete passiva e il registro delle skill. Sono gli stessi strumenti che usa la chat di ricerca.

Se colleghi solo l'API, hai il solo modello. CKE 2.0 e gli strumenti stanno dietro il server MCP. Per averli, collega l'MCP.

Cosa offre ciascuno

API /v1MCP /mcp
Inferenza (chat, completions, messaggi Anthropic)SìNo, non è un endpoint di inferenza
Compatibile con OpenAI e AnthropicSì—
Base di conoscenza CKE 2.0 (kb_search, kb_read)NoSì
Record e ricerca CVENoSì
Bollettini sui pacchetti (OSV)NoSì
Ricerca web e lettura di pagineNoSì
Analisi statica di fileNoSì
Intelligence di rete passiva (IP, DNS, WHOIS, ASN, sito, breach)NoSì
Ricerca nell'indice del dark webNoSì
Registro delle skillNoSì
TrasportoHTTP (REST, SSE per lo streaming)Streamable HTTP (MCP, JSON-RPC)
AutenticazioneAuthorization: Bearer o x-api-keyAuthorization: Bearer

Gli endpoint del modello grezzo, POST /v1/chat/completions, /v1/responses e /v1/messages, non portano nessuno di questi strumenti. Il modello riceve solo gli strumenti di tipo funzione che definisci e invii, e li esegue il tuo codice. Il server MCP è il modo per dare a un modello gli strumenti NotHoly senza scrivere tu quell'infrastruttura.

Vuoi CKE 2.0 e gli strumenti? Collega l'MCP

Punta il tuo client MCP su https://api.notholy.com/mcp e invia la tua chiave API nell'intestazione Authorization: Bearer. La stessa chiave vale sia per l'API sia per il server MCP.

Shell
claude mcp add --transport http notholy https://api.notholy.com/mcp --header "Authorization: Bearer $NOTHOLY_API_KEY"

La guida completa spiega come ottenere una chiave, chiamare /v1 per l'inferenza, collegare l'MCP nei client più comuni e usare ogni strumento con esempi di input e output.

Quale percorso mi serve?

  • Vuoi solo le risposte del modello dal tuo codice o dal tuo client: usa l'API. Non c'è altro da configurare.
  • Vuoi che un modello (in Claude Code, Cursor, il tuo agente) cerchi CVE, interroghi CKE 2.0, legga pagine o analizzi file: collega il server MCP.
  • Vuoi questi dati nel tuo codice senza un agente, come semplice HTTP: l'API di ricerca espone le route CKE 2.0, CVE, bollettini, web e file sotto /v1.

Prossimi passi