FlyTrap MCP

@flytrap-qa/mcp

Servidor MCP para FlyTrap. Permite que el agente de codificación que ya usas (Cursor, Claude Code, Codex, Windsurf, Zed, VS Code) lea los resultados de los rastreos de FlyTrap: los errores que FlyTrap encontró en tu aplicación con capturas de pantalla, XML de UI, logcat y llamadas de red fallidas, el grafo de pantallas, los hosts con los que tu compilación se comunica, los SDK y permisos detectados, y las diferencias entre dos compilaciones.

FlyTrap ejecuta tu compilación real de Android o iOS en dispositivos reales y registra todo. Este paquete solo lee esos resultados. No ejecuta aplicaciones, descompila binarios ni toca tu árbol de código fuente.

Inicio rápido

1. Inicia sesión en dashboard.flytrap.dev, abre Settings > API keys y crea una clave. Elige el alcance read a menos que quieras que el agente pueda poner en cola nuevos rastreos.
2. Añade el servidor a tu agente:

{
  "mcpServers": {
    "flytrap": {
      "command": "npx",
      "args": ["-y", "@flytrap-qa/mcp@latest"],
      "env": {
        "FLYTRAP_API_KEY": "ft_live_..."
      }
    }
  }
}

Claude Code: claude mcp add flytrap -e FLYTRAP_API_KEY=ft_live_... -- npx -y @flytrap-qa/mcp@latest

Codex CLI (~/.codex/config.toml):

[mcp_servers.flytrap]
command = "npx"
args = ["-y", "@flytrap-qa/mcp@latest"]
env = { FLYTRAP_API_KEY = "ft_live_..." }

3. Haz preguntas como:

• "¿Por qué falla la incorporación en mi aplicación? Muéstrame la evidencia."
• "¿Con qué hosts de terceros habla la compilación 1184 antes de la pantalla de consentimiento?"
• "¿Qué cambió entre la compilación 1180 y la 1184: SDK, permisos, errores?"
• "¿Qué SDK incluye com.booking en Android?" (catálogo público, sin necesidad de clave)

Sin FLYTRAP_API_KEY las herramientas del catálogo público siguen funcionando.

Herramientas

Tus proyectos (necesitan FLYTRAP_API_KEY):

Herramienta	Qué devuelve
whoami	La cuenta a la que pertenece la clave
list_projects	Proyectos que el propietario de la clave puede leer, con la ejecución de rastreo seleccionada
get_project	Un proyecto más su estado de rastreo en vivo
list_builds	Compilaciones de un proyecto con SHA-256 del binario y procedencia
get_build_summary	Versión, tamaño, recuentos de SDK/permisos, recuentos de errores y pruebas, pantallas, totales de red y rendimiento
get_sdks	SDK detectados con confianza y fuentes de evidencia, permisos declarados, enlaces profundos
list_bugs	Errores de la ejecución seleccionada, ordenados por gravedad
get_bug_evidence	Escenario, paso fallido, capturas de pantalla y XML (URLs firmadas), ventana de error de logcat, llamadas de red fallidas, picos de rendimiento, un ai_prompt listo
get_screen_graph	Pantallas alcanzadas y los bordes de toque entre ellas
get_network_hosts	Hosts contactados con recuentos de llamadas, bytes y tasas de error
search_apps	Describe una aplicación en lenguaje natural y obtén las aplicaciones públicas rastreadas cuyas características observadas la cubren, con requisitos coincidentes y faltantes
get_ux_benchmark	Las características de tu compilación junto a la misma característica en aplicaciones de la competencia y del mismo género, con capturas de pantalla
list_competitors	Competidores fijados al punto de referencia de UX de un proyecto
find_competitors	Busca aplicaciones públicas rastreadas y Google Play para fijar aplicaciones
add_competitor	Fija una aplicación rastreada, o crea un proyecto de tienda desde un paquete de Google Play y fíjalo (alcance crawl, confirm: true para crear)
remove_competitor	Desfija un competidor (alcance crawl)
compare_builds	Diferencia de SDK, permisos, enlaces profundos, hosts, errores y pantallas entre dos compilaciones
start_crawl	Pone en cola un nuevo rastreo de la compilación actual. Necesita el alcance crawl y confirm: true

Catálogo público (sin clave): lookup_app, get_app_profile, lookup_sdk, lookup_permission.

Habilidad del agente

skills/flytrap/SKILL.md le indica a un agente cuándo recurrir a qué herramienta y cómo citar evidencia. Cópialo en la carpeta de habilidades de tu proyecto (por ejemplo .claude/skills/flytrap/SKILL.md o .cursor/rules/) o apunta tu agente hacia él.

Configuración

La única configuración es FLYTRAP_API_KEY: tu clave personal de Settings > API keys (ft_live_...). Es opcional para las herramientas del catálogo público. El servidor siempre se comunica con https://api.flytrap.dev.

Seguridad

• La clave se envía solo a https://api.flytrap.dev como encabezado Bearer, a través de https. Nunca se escribe en disco ni se registra.
• Las claves tienen alcance. Una clave read no puede iniciar rastreos, crear claves ni cambiar la facturación, incluso si el agente lo solicita. Revoca claves en cualquier momento en el panel de control.
• Las claves heredan los permisos de proyecto del usuario que las creó. Una clave nunca ve los proyectos privados de otra cuenta.
• La salida de las herramientas está limitada (ventanas de registro, límites de llamadas, 4 MiB por respuesta) y se marca como datos de aplicación no confiables, ya que los títulos de errores, líneas de registro y URLs provienen de la aplicación rastreada y su tráfico.
• start_crawl, add_competitor y remove_competitor son las únicas herramientas que cambian algo; necesitan una clave creada con el alcance crawl. Poner en cola un rastreo (start_crawl, o add_competitor con un paquete de Google Play) también requiere un confirm: true explícito.

REST en lugar de MCP

Cada herramienta se asigna a un endpoint REST, por lo que un agente que pueda ejecutar curl puede hacer lo mismo sin este paquete:

curl -H "Authorization: Bearer $FLYTRAP_API_KEY" https://api.flytrap.dev/project/projects
curl -H "Authorization: Bearer $FLYTRAP_API_KEY" https://api.flytrap.dev/project/projects/1248/bugs
curl -H "Authorization: Bearer $FLYTRAP_API_KEY" https://api.flytrap.dev/project/projects/1248/bugs/BUG-102/evidence

Referencia de API: https://api.flytrap.dev/docs

Desarrollo

npm install
npm test
FLYTRAP_API_KEY=ft_live_... npm run inspect   # MCP Inspector UI

Requiere Node 20 o más reciente. Se publica desde GitHub Actions en etiquetas (v*) con procedencia de npm.