MCP
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 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 |
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.
claude mcp add --transport http notholy https://api.notholy.com/mcp --header "Authorization: Bearer $NOTHOLY_API_KEY"O guia completo 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. 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.
- Você quer esses dados no seu código, sem agente, como HTTP simples: a API de pesquisa expõe rotas de CKE 2.0, CVE, advisories, web e arquivos em
/v1.