@joserqc/feedback-mcp

Servidor MCP (Model Context Protocol) da plataforma de feedback ZexIA. Permite que clientes MCP como Codex e Claude Code listem, detalhem e triem feedbacks dos apps direto na sessão de desenvolvimento, transformando relatos de usuários em tarefas de código sem sair do editor.

Configuração

O token (fbt_...) é gerado na página Tokens do painel e exibido uma única vez. Exporte-o como FEEDBACK_API_TOKEN no ambiente que inicia o cliente MCP; nunca grave nem faça commit do valor.

Antes de configurar, consulte a versão publicada e fixe exatamente a versão validada. Não use @latest.

npm view @joserqc/feedback-mcp version

Codex

Com FEEDBACK_API_TOKEN já disponível no ambiente que inicia o Codex:

codex mcp add feedback -- npx -y @joserqc/[email protected]
codex mcp get feedback
codex mcp list

Substitua 0.2.1 pelo valor validado no registry. Em seguida, acrescente o repasse das variáveis à entrada criada em ~/.codex/config.toml, sem copiar o segredo para o arquivo:

[mcp_servers.feedback]
command = "npx"
args = ["-y", "@joserqc/[email protected]"]
env_vars = ["FEEDBACK_API_TOKEN"]

FEEDBACK_API_URL pode ser acrescentada a env_vars quando for necessário sobrescrever a URL padrão de produção.

O Codex CLI, a extensão IDE e o ChatGPT desktop compartilham essa configuração no mesmo host. Reinicie o cliente depois da alteração e confirme o servidor em /mcp ou com codex mcp list. Consulte também a documentação oficial do Codex sobre MCP.

Claude Code

Adicione ao .mcp.json do repositório, também com versão exata:

{
  "mcpServers": {
    "feedback": {
      "command": "npx",
      "args": ["-y", "@joserqc/[email protected]"],
      "env": {
        "FEEDBACK_API_URL": "https://feedback.zexia.tech",
        "FEEDBACK_API_TOKEN": "${FEEDBACK_API_TOKEN}"
      }
    }
  }
}

Atualize o pin conscientemente quando uma nova versão for validada. A presença do .mcp.json no repositório não comprova que o servidor foi carregado pelo Codex, que usa a configuração própria descrita acima.

| Variável | Obrigatória | Descrição | | --- | --- | --- | | FEEDBACK_API_TOKEN | sim | Token de API do painel (fbt_...) | | FEEDBACK_API_URL | não | Base da API (padrão https://feedback.zexia.tech) |

Tools

• list_projects — projetos cadastrados na plataforma
• list_feedback — listagem paginada com filtros (projeto, status, tipo, prioridade)
• get_feedback — detalhe completo: contexto técnico, console logs, comentários e URL assinada da captura
• update_feedback — atualiza status/prioridade/resposta; aceite expectedStatus para compare-and-swap e não sobrescrever uma mudança concorrente
• add_feedback_comment — comenta um feedback (marcado como via MCP no painel)
• search_feedback — busca por texto na mensagem

Ao publicar uma versão com breaking change, o major do pacote sobe — atualize o pin das configurações MCP app por app.

Ao implementar um feedback, preserve o UUID completo e use o footer de commit Feedback-ZexIA: <UUID>. Marque em_andamento ao iniciar. Só encerre como resolvido depois de publicar no ambiente usado pelo relator, validar o fluxo e enviar uma resposta em português; implementação local ou parcial permanece em_andamento com comentário técnico.