Melonhelp Feedback

Conector MCP para agentes de código

Melonhelp Feedback expone un servidor MCP (Model Context Protocol). Con él, tu agente de código hace dos cosas: instala Feedback en tu proyecto y trabaja los errores y pedidos de tus usuarios hasta marcarlos resueltos.

Conectarlo

La URL del servidor es:

https://feedback.melonhelp.com/mcp
  1. En tu cliente de IA, agrega un conector MCP personalizado y pega la URL. Funciona con cualquier cliente compatible con MCP remoto (asistentes de chat, agentes de código y editores).
  2. Se abre el navegador y autorizas con tu cuenta de Melonhelp. La pantalla de autorización te muestra qué acceso tendrá el agente. No hay claves ni tokens que copiar.
  3. Listo. El conector está activo para todos los miembros del espacio.

Lectura y escritura

Hay dos direcciones, según lo que quieras que haga el agente:

URLAccesoQuién la usa
https://feedback.melonhelp.com/mcpLectura y escrituraOwners y administradores
https://feedback.melonhelp.com/mcp/readonlySolo lecturaMiembros con rol de solo lectura, o cuando no quieres que el agente cambie nada

Las herramientas de escritura y los prompts listos solo aparecen en /mcp y con rol de owner o administrador. Si tu rol es de solo lectura, conecta /mcp/readonly: en /mcp el servidor rechaza la conexión (error 403 insufficient_scope).

Sesiones de agentes

Cada conexión que autorizas queda como una sesión. Las ves en dos lugares:

  • En la pestaña Instalación de cada encuesta, sección "Instálalo con tu agente de código".
  • En Ajustes, Espacio de trabajo, lista "Sesiones de agentes".

Cada persona ve sus propias sesiones y los owners y administradores ven las de todo el espacio. Al cerrar una sesión el agente pierde el acceso en su siguiente llamada.

Herramientas para instalar

HerramientaAccesoQué hace
get_install_guideLecturaDevuelve los pasos y el código exacto, con tu clave real, para tu framework y tu backend
check_installationLecturaMuestra qué sitios cargaron el SDK, cuáles fueron rechazados y si llegan usuarios, pedidos y errores
add_allowed_originsEscrituraPermite el origen local y el de producción
configure_launcherEscrituraCambia cómo se abre: globito, botón, pestaña, desde tu botón o solo por código
create_surveyEscrituraCrea una encuesta de satisfacción

El conector también ofrece el recurso melonhelp://docs/sdk-reference, con los atributos del script, la API global, la versión y la CSP. El paso a paso está en Integrar en tu app. El secreto de identidad y el resto de la configuración del botón están en Ajustes, Botón de feedback.

Herramientas para trabajar los pedidos

HerramientaAccesoQué hace
list_portalsLecturaLos portales de tu espacio
list_issuesLecturaErrores y pedidos priorizados por usuarios afectados, votos, MRR o fecha
get_issueLecturaEl detalle de uno, con el contexto para arreglarlo
list_errorsLecturaLos grupos de errores con sus ocurrencias y versiones
claim_issueEscrituraLo toma para que dos agentes no hagan lo mismo
add_noteEscrituraDeja una nota interna
link_pull_requestEscrituraEnlaza el PR o commit que lo arregla
resolve_issueEscrituraLo marca resuelto, si quieres en la versión que trae el arreglo
register_releaseEscrituraRegistra una versión ya desplegada y avisa a quienes reportaron los errores resueltos en ella
reply_to_userEscrituraPrepara una respuesta pública, que queda esperando tu aprobación
draft_changelogEscrituraRedacta el borrador de las novedades

Con más de un portal en el espacio, el agente indica en cuál trabaja (lo obtiene de list_portals). Las listas vienen por páginas.

Del arreglo al aviso

Para un error capturado, el flujo es: claim_issue, el arreglo en tu repositorio con su test, link_pull_request con el PR y resolve_issue con la versión que trae el arreglo. Cuando esa versión ya está en producción, el agente llama a register_release y en ese momento avisamos a quienes reportaron el error. También puedes registrarla tú en Errores, con "Registrar versión desplegada". Nunca se registra una versión antes de desplegarla.

Las ideas, bugs y preguntas que se resuelven avisan a sus seguidores al instante. El cierre por versión está incluido en los planes Indie y Pro.

Herramientas de encuestas

HerramientaAccesoQué hace
list_widgetsLecturaLas encuestas con su clave, estado y respuestas
get_summaryLecturaPromedio, sentimiento y NPS del período
search_responsesLecturaBusca respuestas por sentimiento, categoría, texto o fecha
get_responseLecturaEl detalle de una respuesta

Prompts listos

En los clientes que soportan prompts MCP aparecen como comandos del conector. Usan herramientas de escritura, así que solo están en conexiones con escritura:

PromptQué hace
install_feedbackInstala el SDK en el repositorio abierto y verifica que cargó
add_error_reportingAgrega el reporte de errores en los flujos críticos
add_surveyCrea una encuesta y la muestra en un momento clave

Ejemplos de uso

  • "Instala Melonhelp Feedback en este proyecto."
  • "Arregla los tres errores que afectan a más usuarios y enlaza los PR."
  • "Ya desplegamos la versión 1.4.3 en producción, regístrala."
  • "¿Qué pedidos tienen más votos y siguen abiertos?"
  • "Prepara el borrador del changelog con lo que resolvimos esta semana."

Seguridad

  • El permiso es por usuario y por espacio: el agente ve lo mismo que tu cuenta y solo escribe si tu rol es owner o administrador.
  • No puede borrar nada, ver secretos ni tocar la facturación.
  • El secreto de identidad nunca pasa por el conector. El agente deja la variable MELON_FEEDBACK_SECRET vacía y tú la completas.
  • Las respuestas públicas que redacta (con reply_to_user o la nota de resolve_issue) quedan pendientes hasta que las apruebas, y el changelog queda como borrador.
  • Lo que escriben tus usuarios llega marcado como contenido no confiable, para que el agente lo trate como información y no como instrucciones.
  • Los cambios que hace el agente quedan en Ajustes, Actividad, a nombre de la persona que lo conectó.
  • Revocas el acceso cerrando la sesión en Ajustes, Espacio de trabajo, o en la pestaña Instalación de una encuesta.
Conector MCP de Melonhelp Feedback para agentes de código | Docs de Melonhelp