BugSmash

Retroalimentación visual instantánea y colaboración para agencias, equipos de producto, diseño y marketing.

Servidor MCP alojado

npx add-mcp 'https://api.bugsmash.io/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Plugin de IA BugSmash

Conecta cualquier asistente de IA compatible con MCP — incluyendo Claude, ChatGPT, Cursor y Codex — a BugSmash, la plataforma de revisión visual y comentarios para agencias y equipos de producto, diseño y marketing.

Con este plugin, tu asistente de IA puede crear proyectos de revisión, subir versiones, leer y resumir comentarios, responder a comentarios, organizar carpetas y gestionar webhooks — todo desde el chat en el que ya trabajas.

¿Qué es BugSmash?

BugSmash es una capa de revisión para internet. Comparte cualquier contenido digital — sitios web en vivo, paneles, videos, PDFs, imágenes, audio, incluso aplicaciones móviles — y permite que clientes y partes interesadas comenten directamente sobre él. Los comentarios se fijan exactamente donde está el contexto, de modo que los comentarios, el progreso y las aprobaciones viven en un solo lugar en lugar de capturas de pantalla dispersas e hilos de correo electrónico.

Qué hace este plugin

Este plugin empaqueta el servidor MCP alojado de BugSmash para asistentes de codificación con IA. Una vez instalado, puedes pedirle a tu asistente que:

Área	Qué puedes hacer
Proyectos	Listar, leer, crear, actualizar y eliminar proyectos de revisión
Versiones	Listar, leer, crear y eliminar versiones de un proyecto
Carpetas	Listar, leer, crear, actualizar y eliminar carpetas
Comentarios	Listar, leer, crear, actualizar y eliminar comentarios de comentarios
Respuestas	Listar, crear y eliminar respuestas en un comentario
Webhooks	Listar, actualizar, probar y eliminar webhooks
Cargas	Adjuntar archivos locales y archivos adjuntos del chat como proyectos, versiones o actualizaciones de comentarios

El plugin se comunica con el endpoint MCP alojado de BugSmash:

https://api.bugsmash.io/mcp

Nada se ejecuta localmente y no hay servidor que alojar. Este repositorio contiene solo los manifiestos del plugin y una habilidad que enseña al asistente cómo trabajar con BugSmash de forma segura.

Requisitos

Una cuenta de BugSmash

Autenticación

BugSmash utiliza OAuth 2.1 con PKCE. La primera vez que tu asistente llama a una herramienta de BugSmash, tu navegador abre una página de inicio de sesión donde apruebas el acceso. Eso es todo.

No hay claves de API que copiar, pegar o almacenar
El plugin nunca solicita, almacena ni actúa como intermediario de una clave de API de BugSmash
El acceso sigue los mismos roles, plan y límites de uso que la aplicación BugSmash
Revoca la conexión en cualquier momento desde BugSmash; el asistente pierde el acceso inmediatamente

Instalación

Claude Code

Agrega el marketplace e instala el plugin:

/plugin marketplace add solutionwise/bugsmash-ai-plugin
/plugin install bugsmash@bugsmash

Ejecuta /reload-plugins si Claude Code te lo pide, luego /mcp para iniciar sesión en BugSmash cuando se te solicite.

Claude (web y escritorio)

Puedes conectar BugSmash directamente como un conector personalizado — no se requiere plugin:

Abre Personalizar → Conectores.
Haz clic en + y elige Agregar conector personalizado.
Ingresa https://api.bugsmash.io/mcp como la URL del servidor MCP remoto. Deja los campos de cliente OAuth vacíos — BugSmash admite registro dinámico de clientes.
Haz clic en Agregar, luego Conectar y aprueba el acceso en la página de inicio de sesión de BugSmash.
Habilita BugSmash en un nuevo chat.

Cursor

Agrega este repositorio como marketplace: ve a Panel → Plugins y MCPs, elige Agregar Marketplace bajo Marketplaces de equipo, selecciona Importar desde Repo y pega https://github.com/solutionwise/bugsmash-ai-plugin. El plugin aparece entonces bajo Personalizar en la barra lateral de Cursor, donde puedes seleccionar Instalar a nivel de usuario o de proyecto.

Para probarlo en una sola máquina, clona este repositorio y vincula el plugin a la carpeta local de plugins de Cursor, luego recarga Cursor (Desarrollador: Recargar ventana):

mkdir -p ~/.cursor/plugins/local
ln -s /absolute/path/to/bugsmash-ai-plugin/plugins/bugsmash ~/.cursor/plugins/local/bugsmash

Codex

Desde la CLI de Codex:

codex plugin marketplace add solutionwise/bugsmash-ai-plugin
codex plugin add bugsmash@bugsmash

Inicia una nueva tarea después de instalar; la primera llamada a una herramienta de BugSmash abre el flujo de inicio de sesión.

Cualquier otro cliente MCP

Apunta tu cliente a https://api.bugsmash.io/mcp usando el transporte HTTP transmisible. El servidor admite descubrimiento OAuth, registro dinámico de clientes, PKCE (S256), actualización de tokens y revocación.

Ejemplos de indicaciones

List my BugSmash projects. Do not change anything.

Summarize the active feedback on the "Homepage redesign" project, grouped by page.

Create a BugSmash review project named "Q4 landing page" for https://example.com.

Add a new version to the "Mobile app onboarding" project from the screenshot I attached.

Reply to comment #14 on "Pricing page v2" saying the spacing issue is fixed in the latest build.

Seguridad

La habilidad incluida instruye al asistente a:

Leer el estado actual antes de escribir cuando el objetivo no es exacto
Indicar el objetivo exacto y pedir confirmación antes de cualquier eliminación
Advertir que eliminar una carpeta también elimina sus subcarpetas y todos los proyectos dentro de ellas
Informarte cuando una escritura crea o cambia un enlace de revisión público
Nunca mostrar tokens OAuth, secretos de firma de webhooks o URL de carga privadas
Nunca reintentar una escritura automáticamente después de un tiempo de espera

Solución de problemas

Síntoma	Qué hacer
`401 Unauthorized`	Reconecta BugSmash a través del flujo de inicio de sesión del navegador (`/mcp` en Claude Code).
`403 Forbidden`	El rol de tu espacio de trabajo, plan, límite de uso o alcance OAuth no permite la acción. Los invitados y colaboradores no pueden usar MCP.
`404 Not Found`	Verifica el ID y confirma que te conectaste al espacio de trabajo correcto.
Las herramientas de BugSmash no aparecen	Ejecuta `/reload-plugins` (Claude Code), recarga la ventana (Cursor) o inicia una nueva sesión (Codex).
`429 Too Many Requests`	Has alcanzado un límite de uso o de frecuencia de BugSmash. Espera a que se restablezca.

Estructura del repositorio

.
├── .agents/plugins/marketplace.json     # Codex marketplace
├── .claude-plugin/marketplace.json      # Claude Code marketplace
├── .cursor-plugin/marketplace.json      # Cursor marketplace
└── plugins/bugsmash
    ├── .claude-plugin/plugin.json
    ├── .codex-plugin/plugin.json
    ├── .cursor-plugin/plugin.json
    ├── .mcp.json                        # Hosted MCP endpoint
    ├── assets/                          # Icon
    └── skills/manage-reviews            # Review-management skill

Desarrollo

Para probar cambios localmente, agrega este repositorio como marketplace local en el cliente de tu elección. Consulta docs/client-setup.md para instrucciones paso a paso para cada cliente y un orden de prueba funcional sugerido.

Valida los manifiestos antes de abrir una solicitud de extracción:

claude plugin validate .
claude plugin validate ./plugins/bugsmash

Enlaces

¿Encontraste un problema con el plugin? Abre un problema.

Licencia

Este paquete de plugin se publica bajo la Licencia MIT. La licencia cubre solo los archivos de este repositorio, no el servicio alojado de BugSmash.