MCP
Use a API com CKE 2.0 e ferramentas
Obtenha uma chave, chame /v1 para inferência, conecte o MCP para o CKE 2.0 e as ferramentas de pesquisa, e use cada ferramenta.
A API responde com o modelo. O servidor MCP acrescenta o CKE 2.0 e as ferramentas. Este guia faz os dois, de ponta a ponta. Para entender em poucas linhas por que são separados, leia antes API vs MCP.
1. Obtenha uma chave de API
- Crie uma conta em notholy.com/signup e confirme seu e-mail.
- Adicione créditos em Cobrança. O depósito mínimo está nessa página.
- Abra Chaves de API e crie uma chave. Ela começa com
nh_live_e é mostrada uma única vez.
Uma chave vale para a API e para o servidor MCP. Exporte-a:
export NOTHOLY_API_KEY="nh_live_..."2. Chame /v1 para inferência
Este é o modelo cru: sem recuperação de dados, sem ferramentas, só a resposta.
curl https://api.notholy.com/v1/chat/completions \
-H "Authorization: Bearer $NOTHOLY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "notholy-specter", "messages": [{"role": "user", "content": "Explain IDOR in two sentences."}]}'import os
from openai import OpenAI
client = OpenAI(base_url="https://api.notholy.com/v1", api_key=os.environ["NOTHOLY_API_KEY"])
r = client.chat.completions.create(
model="notholy-specter",
messages=[{"role": "user", "content": "Explain IDOR in two sentences."}],
)
print(r.choices[0].message.content)O modelo responde a partir dos próprios pesos. Se você pedir o CVSS de uma CVE recente, ele só consegue chutar, porque aqui não tem como consultar nada. É isso que o servidor MCP resolve.
3. Conecte o MCP para o CKE 2.0 e as ferramentas
O servidor fala MCP sobre Streamable HTTP em https://api.notholy.com/mcp. Envie a mesma chave em Authorization: Bearer. Escolha o seu cliente.
Claude Code
claude mcp add --transport http notholy https://api.notholy.com/mcp --header "Authorization: Bearer $NOTHOLY_API_KEY"Ou por configuração, em .mcp.json ou ~/.claude.json:
{"mcpServers": {"notholy": {"type": "http", "url": "https://api.notholy.com/mcp", "headers": {"Authorization": "Bearer ${NOTHOLY_API_KEY}"}}}}Cursor
Adicione o servidor em .cursor/mcp.json no projeto (ou em ~/.cursor/mcp.json para todos os projetos):
{"mcpServers": {"notholy": {"url": "https://api.notholy.com/mcp", "headers": {"Authorization": "Bearer nh_live_..."}}}}Claude Desktop
O Claude Desktop lê mcpServers do arquivo de configuração (Settings → Developer → Edit Config). Ele faz a ponte com um servidor remoto usando mcp-remote:
{"mcpServers": {"notholy": {"command": "npx", "args": ["-y", "mcp-remote", "https://api.notholy.com/mcp", "--header", "Authorization: Bearer nh_live_..."]}}}Reinicie o Claude Desktop. As ferramentas notholy aparecem no menu de ferramentas.
Seu próprio código (SDK do MCP)
Qualquer biblioteca cliente de MCP serve. Aponte o transporte Streamable HTTP para a URL e defina o cabeçalho.
import os, asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client
URL = "https://api.notholy.com/mcp"
HEADERS = {"Authorization": f"Bearer {os.environ['NOTHOLY_API_KEY']}"}
async def main():
async with streamablehttp_client(URL, headers=HEADERS) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
tools = await session.list_tools()
print([t.name for t in tools.tools])
out = await session.call_tool("cve_lookup", {"id": "CVE-2021-44228"})
print(out.structuredContent)
asyncio.run(main())import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
const transport = new StreamableHTTPClientTransport(new URL('https://api.notholy.com/mcp'), {
requestInit: { headers: { Authorization: `Bearer ${process.env.NOTHOLY_API_KEY}` } },
});
const client = new Client({ name: 'my-agent', version: '1.0.0' });
await client.connect(transport);
const tools = await client.listTools();
console.log(tools.tools.map((t) => t.name));
const out = await client.callTool({ name: 'cve_lookup', arguments: { id: 'CVE-2021-44228' } });
console.log(out.structuredContent);JSON-RPC direto
O servidor é JSON-RPC 2.0 simples sobre HTTP, então o curl basta para listar as ferramentas ou chamar uma.
curl https://api.notholy.com/mcp \
-H "Authorization: Bearer $NOTHOLY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'4. Use as ferramentas
Toda chamada de ferramenta é uma mensagem tools/call. A resposta traz duas cópias do resultado: content[0].text (com um prefixo que o marca como dado externo não confiável) e structuredContent.data (o objeto já interpretado). Os exemplos abaixo mostram o structuredContent.data resumido.
kb_search: buscar no CKE 2.0
Busca na base de conhecimento de segurança curada. Filtre por domain (web, api, mobile, offensive, tools, cloud, ir, attack), source ou tool. Cada resultado traz a licença da fonte e um id de documento para o kb_read.
{"jsonrpc": "2.0", "id": 2, "method": "tools/call",
"params": {"name": "kb_search", "arguments": {"query": "ssrf prevention", "domain": "web", "limit": 3}}}{"data": {"hits": [
{"id": "owasp-cheatsheet-ssrf", "title": "SSRF Prevention Cheat Sheet", "source": "OWASP", "licence": "CC-BY-SA-4.0", "score": 0.82,
"snippet": "Validate the host against an allow-list, resolve it, and pin the connection to the resolved IP..."}
]}}kb_read: abrir um documento
Lê um documento do CKE 2.0 pelo id (vindo do kb_search), paginado por seção com from e limit.
{"jsonrpc": "2.0", "id": 3, "method": "tools/call",
"params": {"name": "kb_read", "arguments": {"id": "owasp-cheatsheet-ssrf", "from": 0, "limit": 2}}}{"data": {"id": "owasp-cheatsheet-ssrf", "title": "SSRF Prevention Cheat Sheet", "source": "OWASP",
"sections": [{"heading": "Allow-list the destination", "text": "..."}],
"next": 2, "total": 9}}cve_lookup: um registro de CVE
O registro consolidado de um id de CVE: descrição, CVSS, EPSS, status na CISA KEV, produtos afetados e referências.
{"jsonrpc": "2.0", "id": 4, "method": "tools/call",
"params": {"name": "cve_lookup", "arguments": {"id": "CVE-2021-44228"}}}{"data": {"id": "CVE-2021-44228", "cvss": {"score": 10.0, "vector": "CVSS:3.1/AV:N/AC:L/..."},
"epss": {"score": 0.975, "percentile": 0.999}, "kev": {"listed": true, "known_ransomware": true},
"cwe": ["CWE-502", "CWE-917"], "references": ["https://nvd.nist.gov/vuln/detail/CVE-2021-44228"]}}cve_search: buscar CVEs
Busque por texto, fornecedor ou CWE, com filtros min_cvss, min_epss e kev.
{"jsonrpc": "2.0", "id": 5, "method": "tools/call",
"params": {"name": "cve_search", "arguments": {"vendor": "apache", "cwe": "CWE-502", "kev": true, "limit": 5}}}Outras ferramentas em uma linha
Veja o servidor MCP remoto para a lista completa com limites. As demais seguem o mesmo formato:
advisory_query: advisories de um pacote:{"name": "lodash", "ecosystem": "npm", "version": "4.17.15"}.web_search: web pública:{"query": "log4shell detection"}.read_url: uma página pública pelo leitor protegido contra SSRF:{"url": "https://example.com/advisory"}.analyze_file: análise estática; no servidor remoto, envienameecontent_base64:{"name": "handler.js", "content_base64": "..."}.ip_info,domain_info,asn_lookup,site_check,breach_check: inteligência de rede passiva.port_scan: a única ferramenta ativa; escaneie só hosts que você pode testar.darkweb_search: busca no índice do Tor; chame só quando o usuário pedir uma busca na dark web.skills_search,skill_get,skill_invoke: o registro de skills.
Crédito e limites
As ferramentas precisam de crédito na conta. Sem ele, as rotas de pesquisa respondem 402 insufficient_credits, e uma chamada de ferramenta devolve essa mensagem no lugar do resultado, com um link para a cobrança. O servidor MCP continua conectando e listando as ferramentas. As chamadas contam no limite de 120 requisições por minuto das rotas de pesquisa. A inferência em /v1 é cobrada por token; as ferramentas de pesquisa não usam tokens.
Próximos passos
- Servidor MCP remoto: a lista completa de ferramentas e limites
- Servidor MCP local: rode as ferramentas pelo CLI sobre stdio
- API de pesquisa: os mesmos dados como rotas HTTP simples