Visão geral
O Axur MCP (Model Context Protocol) é uma integração nativa que permite que modelos de IA acessem informações da plataforma Axur de forma segura por meio de uma API.
Pré-requisitos
Antes de iniciar a configuração, o usuário deve:
Possuir acesso à plataforma Axur.
Gerar uma API Key em:
Utilizar um cliente compatível com MCP.
Atualmente, os seguintes clientes foram validados:
Claude Code
ChatGPT Codex
Gemini Antigravity/CLI
Documentação oficial
A documentação oficial do Axur MCP está disponível em:
Boas práticas de segurança
Nunca insira sua API Key diretamente em um prompt de IA.
A recomendação é solicitar que o próprio assistente gere um arquivo de configuração (mcp_config.json ou .mcp.json, conforme o cliente utilizado) e, somente após sua criação, inserir manualmente a API Key no campo correspondente.
Essa abordagem evita o compartilhamento de credenciais durante a conversa com o modelo e segue as melhores práticas de segurança.
Prompt de configuração do MCP
O prompt abaixo foi validado para os clientes compatíveis (Claude Code, ChatGPT Codex, Gemini Antigravity/CLI).
# MCP Configuration Task
Create or update the client's MCP configuration file (`mcp_config.json`) with all four Axur MCP endpoints using Streamable HTTP (SSE):
1. Threat Hunting: https://mcp.axur.ai/mcp/th/
2. Cyber Threat Intelligence (CTI): https://mcp.axur.ai/mcp/cti/
3. Risk Tickets: https://mcp.axur.ai/mcp/tickets/
# Server Headers Required
For every server entry, include the following headers:
- Authorization: Bearer <YOUR_AXUR_API_KEY>
- Content-Type: application/json
- Accept: application/json, text/event-stream
# Verification
Verify that the initialize handshake connects successfully to https://mcp.axur.ai/mcp/th/ and return a list of available tools.
Após executar esse prompt, o modelo deverá criar o arquivo de configuração do MCP. Em seguida, deve-se substituir o placeholder <YOUR_AXUR_API_KEY> pela API Key gerada na plataforma Axur.
Testando a integração
Após concluir a configuração, recomenda-se executar uma busca simples para validar que a comunicação com o servidor MCP está funcionando corretamente.
O prompt abaixo realiza uma pesquisa no Threat Hunting utilizando uma marca de exemplo.
# Objective
Perform a Threat Hunting audit to detect high-impersonation threats targeting the brand: "[INSERT YOUR BRAND NAME]".
# Execution Instructions
1. Build Query: Use build_url_domain_query_tool with parameter impersonated_brands_high: "[INSERT YOUR BRAND NAME]".
2. Run Threat Search: Call search_urls_domains using the generated query impersonatedBrandsHigh="[INSERT YOUR BRAND NAME]" for top 10 results.
3. Inspect Credential Risks: Extract references, hostnames, WHOIS registrants, credential harvesting indicators, and ISP geolocations.
# Report Format
Return a structured executive threat report with a summary table containing:
- Reference URL
- Impersonated Level (High)
- Credential Harvesting Risk (Yes / No / Possibly)
- Domain Host & Registrar
- Geolocation / ISP
Substitua [INSERT YOUR BRAND NAME] pelo nome da marca desejada antes de executar a consulta.
Resultado esperado
Se a configuração estiver correta, o assistente deverá:
Conectar-se com sucesso ao servidor MCP da Axur;
Concluir o handshake initialize;
Listar as ferramentas disponíveis;
Executar consultas na plataforma utilizando a API Key configurada;
Retornar os resultados estruturados conforme solicitado no prompt.
Resumo
Gere uma API Key na plataforma Axur.
Utilize um cliente compatível (Claude Code, ChatGPT Codex, Gemini Antigravity/CLI).
Execute o prompt de configuração do MCP.
Insira manualmente sua API Key no arquivo de configuração gerado.
Execute o prompt de validação para confirmar que a integração está funcionando corretamente.