Descripción general
Axur MCP (Model Context Protocol) es una integración nativa que permite que los modelos de IA accedan de forma segura a la información de la plataforma Axur mediante una API.
Requisitos previos
Antes de comenzar la configuración, el usuario debe:
Tener acceso a la plataforma Axur.
Generar una API Key en:
Utilizar un cliente compatible con MCP.
Actualmente, los siguientes clientes han sido validados:
Claude Code
ChatGPT Codex
Gemini Antigravity/CLI
Documentación oficial
La documentación oficial de Axur MCP está disponible en:
Buenas prácticas de seguridad
Nunca introduzca su API Key directamente en un prompt de IA.
La recomendación es solicitar al propio asistente que genere un archivo de configuración (mcp_config.json o .mcp.json, según el cliente utilizado) y, únicamente después de su creación, introducir manualmente la API Key en el campo correspondiente.
Este enfoque evita compartir las credenciales durante la conversación con el modelo y sigue las mejores prácticas de seguridad.
Prompt de configuración de MCP
El siguiente prompt ha sido validado para los clientes compatibles (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.
Después de ejecutar este prompt, el modelo debería crear el archivo de configuración de MCP. A continuación, se debe reemplazar el marcador <YOUR_AXUR_API_KEY> por la API Key generada en la plataforma Axur.
Prueba de la integración
Después de completar la configuración, se recomienda realizar una búsqueda sencilla para verificar que la comunicación con el servidor MCP funciona correctamente.
El siguiente prompt realiza una búsqueda en Threat Hunting utilizando una marca de ejemplo.
# 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
Reemplace [INSERT YOUR BRAND NAME] por el nombre de la marca deseada antes de ejecutar la consulta.
Resultado esperado
Si la configuración es correcta, el asistente debería:
Conectarse correctamente al servidor MCP de Axur;
Completar el handshake de inicialización;
Enumerar las herramientas disponibles;
Ejecutar consultas en la plataforma utilizando la API Key configurada;
Devolver los resultados estructurados según lo solicitado en el prompt.
Resumen
Genere una API Key en la plataforma Axur.
Utilice un cliente compatible (Claude Code, ChatGPT Codex, Gemini Antigravity/CLI).
Ejecute el prompt de configuración de MCP.
Introduzca manualmente su API Key en el archivo de configuración generado.
Ejecute el prompt de validación para confirmar que la integración funciona correctamente.