# API vs MCP

> A API entrega o modelo cru. O servidor MCP dá a esse modelo o CKE 2.0 e as ferramentas de pesquisa. Conecte os dois.


A NotHoly tem duas superfícies, e cada uma faz um trabalho diferente.

- **A API** em `https://api.notholy.com/v1` é inferência crua. Você envia mensagens e recebe a resposta do modelo. Ela é compatível com OpenAI e Anthropic, então qualquer cliente que fale essas APIs fala com a NotHoly. Aqui o modelo não tem recuperação de dados nem ferramentas próprias.
- **O servidor MCP** em `https://api.notholy.com/mcp` é a camada de inteligência. Ele dá ao modelo o Cybersecurity Knowledge Engine 2.0 (CKE 2.0) e as ferramentas de pesquisa: registros de CVE, advisories de pacotes, leitura de web e de páginas, análise de arquivos, inteligência de rede passiva e o registro de skills. São as mesmas ferramentas que o [chat de pesquisa](https://notholy.com/chat) usa.

Se você conectar só a API, fica só com o modelo. O CKE 2.0 e as ferramentas ficam atrás do servidor MCP. Para ter acesso a eles, conecte o MCP.

## O que cada um entrega

| | API `/v1` | MCP `/mcp` |
|---|---|---|
| Inferência (chat, completions, mensagens Anthropic) | Sim | Não, não é um endpoint de inferência |
| Compatível com OpenAI e Anthropic | Sim | — |
| Base de conhecimento CKE 2.0 (`kb_search`, `kb_read`) | Não | Sim |
| Registros e busca de CVE | Não | Sim |
| Advisories de pacotes (OSV) | Não | Sim |
| Busca na web e leitura de páginas | Não | Sim |
| Análise estática de arquivos | Não | Sim |
| Inteligência de rede passiva (IP, DNS, WHOIS, ASN, site, vazamentos) | Não | Sim |
| Busca no índice da dark web | Não | Sim |
| Registro de skills | Não | Sim |
| Transporte | HTTP (REST, SSE para streams) | Streamable HTTP (MCP, JSON-RPC) |
| Autenticação | `Authorization: Bearer` ou `x-api-key` | `Authorization: Bearer` |

> [!NOTE]
> Os endpoints crus do modelo, `POST /v1/chat/completions`, `/v1/responses` e `/v1/messages`, não trazem nenhuma dessas ferramentas. O modelo recebe só as ferramentas de função que você define e envia, e o seu código as executa. O servidor MCP é o caminho para entregar as ferramentas da NotHoly a um modelo sem escrever essa infraestrutura você mesmo.

## Quer o CKE 2.0 e as ferramentas? Conecte o MCP

Aponte o seu cliente MCP para `https://api.notholy.com/mcp` e envie a chave de API no cabeçalho `Authorization: Bearer`. A mesma chave vale para a API e para o servidor MCP.

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

O [guia completo](/pt-br/mcp/connect) mostra como obter uma chave, chamar `/v1` para inferência, conectar o MCP nos clientes mais comuns e usar cada ferramenta com exemplos de entrada e saída.

## Qual caminho eu preciso?

- Você só quer respostas do modelo a partir do seu código ou cliente: use a [API](/pt-br/api/chat-completions). Não há mais nada para configurar.
- Você quer que um modelo (no Claude Code, no Cursor, no seu próprio agente) consulte CVEs, busque no CKE 2.0, leia páginas ou analise arquivos: conecte o [servidor MCP](/pt-br/mcp/remote).
- Você quer esses dados no seu código, sem agente, como HTTP simples: a [API de pesquisa](/pt-br/api/research) expõe rotas de CKE 2.0, CVE, advisories, web e arquivos em `/v1`.

## Próximos passos

- [Use a API com CKE 2.0 e ferramentas](/pt-br/mcp/connect)
- [Servidor MCP remoto](/pt-br/mcp/remote)
- [Servidor MCP local](/pt-br/mcp/local)
