Introducción
Qué es el MCP de Bazookapp
El servidor MCP es una conexión local entre Bazookapp Desktop y un cliente compatible con Model Context Protocol. Permite que ese cliente solicite datos de tu espacio de trabajo y, si lo autorizas, ejecute determinadas operaciones sobre él.
En producción necesitas una suscripción Premium activa o una concesión Premium manual vigente. El canal de la aplicación también debe tener habilitado el MCP.
El MCP no sustituye a Bazookapp ni publica tu información en Internet. Bazookapp debe permanecer abierto, con tu sesión válida, y el servidor escucha únicamente en tu propio ordenador.
Antes de empezar
Requisitos
- Bazookapp Desktop actualizado y abierto en el mismo equipo que el cliente MCP.
- Una sesión válida con Premium activo y las capacidades MCP concedidas.
- El feature flag MCP habilitado en el canal instalado.
- Un puerto local libre entre 1024 y 65535.
- Un cliente que permita configurar un servidor MCP mediante una URL HTTP local.
Las tools solo pueden actuar con las capacidades que tenga tu sesión. Tener acceso al servidor no concede permisos adicionales.
Configuración
Activar y conectar el MCP
- Abre Settings → MCP.Comprueba que el canal permite utilizar el servidor MCP.
- Elige el puerto.El valor inicial es 47831. Solo cámbialo si está ocupado o tu cliente necesita otro.
- Activa «Servidor MCP local».Bazookapp valida Premium, permisos y puerto antes de iniciarlo.
- Copia la configuración.Utiliza el botón de copia para evitar errores al escribir la URL.
- Añádela a tu cliente MCP.Reinicia o recarga el cliente si no descubre las tools inmediatamente.
La configuración tiene esta forma:
{
"mcpServers": {
"bazookapp": {
"url": "http://127.0.0.1:<PUERTO>/mcp"
}
}
}El servidor está diseñado para uso local. No abras el puerto en el router ni lo publiques mediante túneles o proxies.
Opciones disponibles
- Iniciar con Bazookapp
- Levanta el MCP automáticamente después de restaurar una sesión válida, siempre que Premium y el canal lo permitan.
- Límite de solicitudes
- Permite entre 10 y 600 solicitudes por minuto para evitar bucles o clientes descontrolados.
- Estado y endpoint
- Indican si el servicio está activo y la URL exacta que debe utilizar tu cliente.
Consultar datos
Tools de lectura
Estas tools consultan información sin modificar tu espacio de trabajo. Todas requieren mcp.read y la capability funcional correspondiente.
| Tool | Qué hace | Entradas principales |
|---|---|---|
list_apps | Lista apps del portfolio actual. | limit, offset |
get_app_keywords | Devuelve keywords trackeadas para una app. | app_uuid, limit |
search_rankings | Consulta el histórico de rankings de un contexto. | context_uuid, hasta 8 keyword_uuids |
get_app_ratings | Consulta ratings de un contexto y storefront. | context_uuid, storefront |
search_app_store | Busca una app en el catálogo de App Store. | query, storefront, platform |
get_keyword_suggestions | Lista oportunidades relacionadas con una app. | context_uuid, source_app_uuid, limit |
Solicita primero las apps o keywords y reutiliza sus UUID. Un nombre visible o un Apple ID no reemplazan un UUID cuando la tool lo requiere.
Modificar datos
Tools de escritura
Requieren mcp.write, portfolio.write y una idempotency_key única por intención. Repetir la misma petición con la misma clave no debe duplicar la operación.
| Tool | Acción | Protección relevante |
|---|---|---|
add_app | Añade una app de App Store al portfolio. | Apple ID, storefront y clave idempotente. |
add_keywords | Añade hasta 100 keywords a un contexto. | Validación por lote e idempotencia. |
delete_keywords | Elimina keywords trackeadas. | Confirmación literal DELETE. |
set_keyword_note | Actualiza o limpia una nota privada. | Concurrencia mediante expected_updated_at. |
set_keyword_tag | Asigna o retira una etiqueta. | Máximo 100 keywords por operación. |
manage_tag | Crea, edita o elimina una etiqueta. | Eliminar exige confirmación DELETE. |
extract_competitors_keywords | Extrae candidatos desde un competidor. | Origen y keyword trackeada explícitos. |
Las tools destructivas no deben ejecutarse a partir de una instrucción ambigua. Comprueba siempre el objeto, la cantidad afectada y el contexto de mercado.
Control
Seguridad y privacidad
- El servicio enlaza únicamente con
127.0.0.1y, cuando está disponible,::1. - Las tools vuelven a comprobar capabilities en cada ejecución.
- Las escrituras son idempotentes y las eliminaciones requieren confirmación reforzada.
- Existe rate limit configurable y límites por tamaño de operación.
- La auditoría registra tool, resultado y código seguro; no debe registrar notas, keywords, tokens ni cuerpos completos.
- Al perder Premium, cerrar sesión o desactivar el MCP, deja de estar disponible para el cliente.
Conecta únicamente clientes de confianza. El cliente MCP podrá ver los datos que devuelvan las tools autorizadas mientras Bazookapp y la sesión permanezcan activos.
Troubleshooting
Resolver problemas
«Tu plan no incluye el servidor MCP»
Sincroniza la suscripción y comprueba que Premium esté activo. Una cuenta Free no recibe mcp.read.
El puerto ya está en uso
Detén el proceso que lo ocupa o selecciona otro puerto válido en Settings → MCP y actualiza la configuración del cliente.
El cliente no descubre tools
Comprueba que el estado sea «Activo», que la URL termine en /mcp y recarga el cliente después de copiarla.
Permission denied
La tool necesita una capability que tu sesión no posee o es de escritura y solo tienes permiso de lectura.
Too many requests
El cliente superó el límite por minuto. Reduce la frecuencia o sube el límite dentro del rango permitido.
Datos desactualizados u offline
El MCP puede devolver caché o errores controlados según la operación. Reconecta Bazookapp y actualiza el área correspondiente.
¿Necesitas entender una función concreta? Consulta el centro de ayuda de Bazookapp.