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.
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 /v1 | MCP /mcp | |
|---|---|---|
| Inferenza (chat, completions, messaggi Anthropic) | Sì | No, non è un endpoint di inferenza |
| Compatibile con OpenAI e Anthropic | Sì | — |
Base di conoscenza CKE 2.0 (kb_search, kb_read) | No | Sì |
| Record e ricerca CVE | No | Sì |
| Bollettini sui pacchetti (OSV) | No | Sì |
| Ricerca web e lettura di pagine | No | Sì |
| Analisi statica di file | No | Sì |
| Intelligence di rete passiva (IP, DNS, WHOIS, ASN, sito, breach) | No | Sì |
| Ricerca nell'indice del dark web | No | Sì |
| Registro delle skill | No | Sì |
| Trasporto | HTTP (REST, SSE per lo streaming) | Streamable HTTP (MCP, JSON-RPC) |
| Autenticazione | Authorization: Bearer o x-api-key | Authorization: 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.
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.