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
- 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).
- 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.
- 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:
| URL | Acceso | Quién la usa |
|---|---|---|
https://feedback.melonhelp.com/mcp | Lectura y escritura | Owners y administradores |
https://feedback.melonhelp.com/mcp/readonly | Solo lectura | Miembros 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
| Herramienta | Acceso | Qué hace |
|---|---|---|
get_install_guide | Lectura | Devuelve los pasos y el código exacto, con tu clave real, para tu framework y tu backend |
check_installation | Lectura | Muestra qué sitios cargaron el SDK, cuáles fueron rechazados y si llegan usuarios, pedidos y errores |
add_allowed_origins | Escritura | Permite el origen local y el de producción |
configure_launcher | Escritura | Cambia cómo se abre: globito, botón, pestaña, desde tu botón o solo por código |
create_survey | Escritura | Crea 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
| Herramienta | Acceso | Qué hace |
|---|---|---|
list_portals | Lectura | Los portales de tu espacio |
list_issues | Lectura | Errores y pedidos priorizados por usuarios afectados, votos, MRR o fecha |
get_issue | Lectura | El detalle de uno, con el contexto para arreglarlo |
list_errors | Lectura | Los grupos de errores con sus ocurrencias y versiones |
claim_issue | Escritura | Lo toma para que dos agentes no hagan lo mismo |
add_note | Escritura | Deja una nota interna |
link_pull_request | Escritura | Enlaza el PR o commit que lo arregla |
resolve_issue | Escritura | Lo marca resuelto, si quieres en la versión que trae el arreglo |
register_release | Escritura | Registra una versión ya desplegada y avisa a quienes reportaron los errores resueltos en ella |
reply_to_user | Escritura | Prepara una respuesta pública, que queda esperando tu aprobación |
draft_changelog | Escritura | Redacta 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
| Herramienta | Acceso | Qué hace |
|---|---|---|
list_widgets | Lectura | Las encuestas con su clave, estado y respuestas |
get_summary | Lectura | Promedio, sentimiento y NPS del período |
search_responses | Lectura | Busca respuestas por sentimiento, categoría, texto o fecha |
get_response | Lectura | El 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:
| Prompt | Qué hace |
|---|---|
install_feedback | Instala el SDK en el repositorio abierto y verifica que cargó |
add_error_reporting | Agrega el reporte de errores en los flujos críticos |
add_survey | Crea 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_SECRETvacía y tú la completas. - Las respuestas públicas que redacta (con
reply_to_usero la nota deresolve_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.