BugSmash

Feedback Visual Instantâneo e Colaboração para Agências, Produto, Design e Equipes de Marketing

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

Plugin de IA BugSmash

Conecte qualquer assistente de IA compatível com MCP — incluindo Claude, ChatGPT, Cursor e Codex — ao BugSmash, a plataforma de revisão visual e feedback para agências e equipes de produto, design e marketing.

Com este plugin, seu assistente de IA pode criar projetos de revisão, enviar versões, ler e resumir feedback, responder comentários, organizar pastas e gerenciar webhooks — tudo a partir do chat em que você já trabalha.

O que é o BugSmash?

O BugSmash é uma camada de revisão para a internet. Compartilhe qualquer conteúdo digital — sites ao vivo, painéis, vídeos, PDFs, imagens, áudio, até aplicativos móveis — e deixe clientes e partes interessadas comentarem diretamente nele. Os comentários são fixados exatamente onde está o contexto, para que feedback, progresso e aprovações fiquem em um só lugar, em vez de capturas de tela espalhadas e threads de e-mail.

O que este plugin faz

Este plugin empacota o servidor MCP hospedado do BugSmash para assistentes de codificação com IA. Depois de instalado, você pode pedir ao seu assistente para:

Área	O que você pode fazer
Projetos	Listar, ler, criar, atualizar e excluir projetos de revisão
Versões	Listar, ler, criar e excluir versões de um projeto
Pastas	Listar, ler, criar, atualizar e excluir pastas
Comentários	Listar, ler, criar, atualizar e excluir comentários de feedback
Respostas	Listar, criar e excluir respostas em um comentário
Webhooks	Listar, atualizar, testar e excluir webhooks
Uploads	Anexar arquivos locais e anexos de chat como projetos, versões ou atualizações de comentários

O plugin fala com o endpoint MCP hospedado do BugSmash:

https://api.bugsmash.io/mcp

Nada é executado localmente e não há servidor para hospedar. Este repositório contém apenas os manifestos do plugin e uma habilidade que ensina o assistente a trabalhar com o BugSmash com segurança.

Requisitos

Uma conta no BugSmash

Autenticação

O BugSmash usa OAuth 2.1 com PKCE. Na primeira vez que seu assistente chamar uma ferramenta do BugSmash, seu navegador abrirá uma página de login onde você aprova o acesso. Só isso.

Sem chaves de API para copiar, colar ou armazenar
O plugin nunca solicita, armazena ou faz proxy de uma chave de API do BugSmash
O acesso segue os mesmos papéis, plano e limites de uso do aplicativo BugSmash
Revogue a conexão a qualquer momento pelo BugSmash; o assistente perde o acesso imediatamente

Instalação

Claude Code

Adicione o marketplace e instale o plugin:

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

Execute /reload-plugins se o Claude Code pedir, depois /mcp para entrar no BugSmash quando solicitado.

Claude (web e desktop)

Você pode conectar o BugSmash diretamente como um conector personalizado — sem necessidade de plugin:

Abra Personalizar → Conectores.
Clique em + e escolha Adicionar conector personalizado.
Digite https://api.bugsmash.io/mcp como URL do servidor MCP remoto. Deixe os campos de cliente OAuth vazios — o BugSmash suporta registro dinâmico de clientes.
Clique em Adicionar, depois em Conectar e aprove o acesso na página de login do BugSmash.
Ative o BugSmash em um novo chat.

Cursor

Adicione este repositório como marketplace: vá em Painel → Plugins e MCPs, escolha Adicionar Marketplace em Marketplaces da equipe, selecione Importar do repositório e cole https://github.com/solutionwise/bugsmash-ai-plugin. O plugin aparecerá em Personalizar na barra lateral do Cursor, onde você pode selecionar Instalar no escopo do usuário ou do projeto.

Para testar em uma única máquina, clone este repositório e vincule o plugin à pasta local de plugins do Cursor, depois recarregue o Cursor (Desenvolvedor: Recarregar janela):

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

Codex

Pelo CLI do Codex:

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

Inicie uma nova tarefa após a instalação; a primeira chamada de ferramenta do BugSmash abrirá o fluxo de login.

Qualquer outro cliente MCP

Aponte seu cliente para https://api.bugsmash.io/mcp usando o transporte HTTP transmissível. O servidor suporta descoberta OAuth, registro dinâmico de clientes, PKCE (S256), atualização de token e revogação.

Exemplos de prompts

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.

Segurança

A habilidade incluída instrui o assistente a:

Ler o estado atual antes de gravar quando o destino não for exato
Informar o destino exato e pedir confirmação antes de qualquer exclusão
Avisar que excluir uma pasta também exclui suas subpastas e todos os projetos dentro dela
Informar quando uma gravação cria ou altera um link público de revisão
Nunca exibir tokens OAuth, segredos de assinatura de webhook ou URLs privadas de upload
Nunca repetir automaticamente uma gravação após um tempo limite

Solução de problemas

Sintoma	O que fazer
`401 Unauthorized`	Reconecte o BugSmash pelo fluxo de login no navegador (`/mcp` no Claude Code).
`403 Forbidden`	O papel no workspace, plano, limite de uso ou escopo OAuth não permite a ação. Convidados e colaboradores não podem usar MCP.
`404 Not Found`	Verifique o ID e confirme se você conectou o workspace correto.
As ferramentas do BugSmash não aparecem	Execute `/reload-plugins` (Claude Code), recarregue a janela (Cursor) ou inicie uma nova sessão (Codex).
`429 Too Many Requests`	Você atingiu um limite de taxa ou uso do BugSmash. Aguarde a redefinição.

Estrutura do repositório

.
├── .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

Desenvolvimento

Para testar alterações localmente, adicione este repositório como marketplace local no cliente de sua preferência. Consulte docs/client-setup.md para instruções passo a passo para cada cliente e uma ordem sugerida de testes funcionais.

Valide os manifestos antes de abrir um pull request:

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

Links

Encontrou um problema com o plugin? Abra uma issue.

Licença

Este pacote de plugin é distribuído sob a Licença MIT. A licença cobre apenas os arquivos deste repositório, não o serviço hospedado do BugSmash.