Configuración de AiSecBox MCP

AiSecBox MCP (Model Context Protocol) es el puente que conecta tus agentes de IA (Claude, Gemini, Cursor) con servicios de seguridad. Esta guía te muestra cómo configurarlo de forma manual o automatizada mediante el CLI.

Métodos de Configuración

Tienes dos formas de configurar AiSecBox MCP:

1. Configuración Automática (Recomendada): Usando el CLI de AiSecBox en un solo comando
2. Configuración Manual: Configurando cada archivo de forma individual

Opción 1. Configuración automática.

1. Descargar y configurar AiSecBox CLI

• Descarga los binarios pre-compilados para tu sistema:

# Mueve el binario a tu PATH
sudo mv aisecbox-cli /usr/local/bin/

# Verifica la Configuración
aisecbox-cli version
# Output: AiSecBox CLI v1.0.2

2. Inicializar la Configuración MCP

Ejecuta el asistente de configuración:

aisecbox-cli init

¿Qué hace el CLI?

1. Detecta los agentes disponibles (Claude, Gemini, Cursor)
2. Muestra un selector para que elijas cuáles quieres configurar
3. Comprueba si existen las carpetas necesarias
4. Si no existen, te ofrece crearlas automáticamente
5. Genera los archivos de configuración correspondientes

Resultado de la Configuración Automática

Después de ejecutar aisecbox-cli init, tendrás estos archivos creados automáticamente:

• .claude/settings.json - Para Claude Code
• .gemini/settings.json - Para Gemini
• .cursor/mcp.json - Para Cursor Editor

Opción 2: Configuración Manual

Si prefieres configurar todo manualmente o necesitas ajustes específicos, sigue estos pasos:

Requisitos Previos

• Sistema Operativo: Linux, macOS o Windows
• Git: Instalado y disponible en tu PATH
• API Key: Tu clave de API de AiSecBox (obténla en https://aisecbox.com)

1. Crear el Directorio del Proyecto

Asegúrate de estar en la raíz de tu proyecto (donde está el archivo .git/):

cd /ruta/a/tu/proyecto

2. Configuración para Claude Code

Crea el archivo .mcp.json en la raíz de tu proyecto:

nano .mcp.json

Contenido del archivo:

{
  "enabledMcpjsonServers": ["AiSecBox-MCP"],
  "mcpServers": {
    "AiSecBox-MCP": {
      "type": "http",
      "url": "http://mcp.aisecbox.com/mcp",
      "headers": {
        "X-Api-Key": "XXXX"
      }
    }
  }
}

Notas:

• Reemplaza XXXX con tu API key real
  • Guarda el archivo y cierra el editor

Configuración para Gemini (CodeGemma)

Crea el directorio .gemini y dentro el archivo settings.json:

mkdir -p .gemini
nano .gemini/settings.json

Contenido del archivo:

{
  "mcp": {
    "allowed": ["AiSecBox-MCP"]
  },
  "mcpServers": {
    "AiSecBox-MCP": {
      "type": "http",
      "url": "http://mcp.aisecbox.com/mcp",
      "headers": {
        "X-Api-Key": "XXXX"
      }
    }
  }
}

Notas:

• Reemplaza XXXX con tu API key real
  • Guarda el archivo y cierra el editor

Configuración para Cursor

Crea el archivo .cursor/mcp.json en la raíz de tu proyecto:

mkdir -p .cursor
nano .cursor/mcp.json

Contenido del archivo:

{
  "mcpServers": {
    "AiSecBox-MCP": {
      "type": "http",
      "url": "http://mcp.aisecbox.com/mcp",
      "headers": {
        "X-Api-Key": "XXXX"
      }
    }
  }
}

Notas:

• Reemplaza XXXX con tu API key real
  • Guarda el archivo y cierra el editor

-> Después de crear todos los archivos, verifica que existen:

Deberías ver algo como:

-rw-r--r-- 1 user user  201 Oct 15 10:30 .mcp.json
-rw-r--r-- 1 user user  201 Oct 15 10:31 .claude/settings.json
-rw-r--r-- 1 user user  201 Oct 15 10:31 .gemini/settings.json
-rw-r--r-- 1 user user  201 Oct 15 10:31 .cursor/mcp.json

Verificar Conectividad

Para cada agente, verifica que puede conectar con el endpoint:

curl -H "X-Api-Key: <tu-api-key>" https://mcp.aisecbox.com/health

Respuesta esperada:

{
  "status": "healthy"
}

Troubleshooting

• Error: "No such file or directory" al crear archivos

Solución: Asegúrate de estar en la raíz de tu proyecto y de tener permisos de escritura:

# Verifica dónde estás
pwd

# Asegúrate de estar en un proyecto Git
git status

• Error: "Invalid API key"

Solución: Verifica tu API key:

1. Ve a https://aisecbox.com/app/projects
2. Copia tu API key
3. Asegúrate de que está correctamente en cada archivo de configuración
4. No uses comillas adicionales en el valor de la API key

• Error: "Agent not found" en tu IDE

Solución: Verifica la estructura de carpetas:

• .mcp.json → Debe estar en la raíz del proyecto
• .claude/settings.json → El directorio .claude debe existir
• .gemini/settings.json → El directorio .gemini debe existir
• .cursor/mcp.json → El directorio .cursor debe existir

• Error: "No permissions to read config"

Solución: Verifica los permisos de los archivos:

chmod 600 .mcp.json
chmod 600 .gemini/settings.json
chmod 600 .claude/settings.json
chmod 600 .cursor/mcp.json

Preparación del Proyecto

Antes de configurar AiSecBox MCP, asegúrate de que tu proyecto cumpla con:

1. Git inicializado: git status debe funcionar sin errores
2. Árbol de trabajo limpio: Commit o stash todos tus cambios antes de la Configuración
3. Dependencias identificadas: Tener package.json, requirements.txt o archivos equivalentes listos para escanear
4. Agentes instalados: Tener Claude Code, Gemini o Cursor instalados y configurados

Resumen Ejecutivo

AiSecBox MCP puede configurarse de dos formas:

Para la mayoría de usuarios, el método automático (CLI) es el más recomendado. Solo ejecuta:

aisecbox-cli init

Y sigue las instrucciones en pantalla.

Para desarrolladores experimentados que necesitan configuraciones específicas, el método manual ofrece control total sobre cada detalle.

Recursos Adicionales

• Documentación Completa del CVE Agent

Agentes

• Documentación de Gemini CLI
• Documentación de Claude Code CLI
• Documentación de Cursor

AiSecBox

• Portal de AiSecBox
• Issues y Soporte

¿Necesitas ayuda?

• Email: info@aisecbox.com
• Reportar bugs: Crea un ticket en nuestro sistema de soporte

AiSecBox MCP está listo para fortalecer tu seguridad con el poder de la IA!