# 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](https://notholy.com/chat).

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` |

> [!NOTE]
> 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.

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

La [guida completa](/it/mcp/connect) 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](/it/api/chat-completions). 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](/it/mcp/remote).
- Vuoi questi dati nel tuo codice senza un agente, come semplice HTTP: l'[API di ricerca](/it/api/research) espone le route CKE 2.0, CVE, bollettini, web e file sotto `/v1`.

## Prossimi passi

- [Usa l'API con CKE 2.0 e gli strumenti](/it/mcp/connect)
- [Server MCP remoto](/it/mcp/remote)
- [Server MCP locale](/it/mcp/local)
