Pular para o conteúdo
NotHolyDocs

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.

Ver em Markdown

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 /v1MCP /mcp
Inferência (chat, completions, mensagens Anthropic)SimNão, não é um endpoint de inferência
Compatível com OpenAI e AnthropicSim—
Base de conhecimento CKE 2.0 (kb_search, kb_read)NãoSim
Registros e busca de CVENãoSim
Advisories de pacotes (OSV)NãoSim
Busca na web e leitura de páginasNãoSim
Análise estática de arquivosNãoSim
Inteligência de rede passiva (IP, DNS, WHOIS, ASN, site, vazamentos)NãoSim
Busca no índice da dark webNãoSim
Registro de skillsNãoSim
TransporteHTTP (REST, SSE para streams)Streamable HTTP (MCP, JSON-RPC)
AutenticaçãoAuthorization: Bearer ou x-api-keyAuthorization: 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.

Shell
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.

Próximos passos