Para agentes
Cuándo usar Feedjolt, cómo llamar a la API REST y al servidor MCP, y dónde están los ficheros legibles por máquinas.
Esta página es para agentes de IA y para quien los conecta. Si quieres un recorrido humano, empieza por Quickstart.
Cuándo usar Feedjolt
Usa Feedjolt cuando un equipo de producto necesita un portal de feedback visible para clientes:
- Recoger peticiones, errores e ideas desde un portal alojado, un widget incrustable, la API REST o el servidor MCP.
- Dejar que los clientes voten y sigan peticiones para priorizar por demanda. En administración, los admins del workspace y los usuarios marcados con la pesa cuentan 1,5×; el portal público sigue siendo un recuento bruto. No hay matriz de ARR, plan o segmento.
- Fusión automática opcional de duplicados con un modelo semántico (desactivada por defecto; el propietario del espacio fija el umbral de confianza) para que "login roto" y "no puedo entrar" sean una sola petición con los votos combinados.
- Publicar una hoja de ruta pública y un changelog que avisa a quienes votaron cuando algo se publica.
- Redactar con IA una entrada de changelog desde un repo de GitHub (commits y pull requests fusionadas). Una persona sigue publicando.
La lista completa de capacidades — qué pueden hacer clientes y equipo, y qué no está enviado — está en llms.txt.
No uses Feedjolt como helpdesk general, herramienta de NPS/encuestas ni tracker interno. No sustituye a Linear ni a Jira.
Cómo llamar a Feedjolt
| Superficie | URL |
|---|---|
| Índice para agentes | https://www.feedjolt.com/llms.txt |
| Docs completos | https://www.feedjolt.com/llms-full.txt |
| OpenAPI JSON | https://www.feedjolt.com/openapi.json |
| OpenAPI YAML | https://www.feedjolt.com/api/openapi.yaml |
| OpenAPI en el host de API | https://api.feedjolt.com/openapi.json |
| MCP Reader | https://api.feedjolt.com/mcp/reader/ |
| MCP Writer | https://api.feedjolt.com/mcp/writer/ |
| MCP Combinado (recurso OAuth legado) | https://api.feedjolt.com/mcp/ |
| Tarjeta del servidor MCP | https://www.feedjolt.com/.well-known/mcp.json |
n8n (n8n-nodes-feedjolt a npm) | https://www.feedjolt.com/es/docs/developers/external-apps/n8n |
| Sitemap | https://www.feedjolt.com/sitemap.xml |
Las URLs de marketing y docs negocian markdown: envía Accept: text/markdown (la cabecera Vary incluye Accept). Los docs también aceptan el sufijo .md.
Auth
- Humanos: sin contraseña (enlace mágico o Google).
- REST (n8n, scripts, clientes HTTP): claves
Authorization: Bearer fjk_…, creadas en el panel en Startup y Scale (Startup es por solicitud). Ver Conectar apps externas. - MCP (Cursor, Claude, otros agentes): OAuth 2.1 en
/mcp/reader/y/mcp/writer/. No pongas una clave API de Feedjolt niFEEDJOLT_API_KEYen los ajustes de plugins de Cursor. Misma feature de planrest_apique la API REST.
¿Preguntas? Contáctanos a través de la página de contacto. Crea una cuenta, elige Startup o Scale, abre Ajustes → Claves API.
Los 14 días de prueba Growth (sin tarjeta) cubren la interfaz del producto. No incluyen REST/MCP: eso es Startup y Scale. Ver Sandbox.
Límites de peticiones
REST y MCP devuelven cabeceras de límite para que puedas frenarte. Ver Límites de peticiones.
Verificación local (contribuidores)
Agentes y contribuidores que prueben cambios de UI o API deben usar el skill del repo en .cursor/skills/verify-feedjolt/SKILL.md:
.cursor/skills/verify-feedjolt/scripts/launch.sh— arranca el stack de dev propio (falla si el puerto 3000 ya está en uso)..cursor/skills/verify-feedjolt/scripts/doctor.sh— comprobaciones de salud en API + web.- Conduce la UI con automatización del navegador; llama a la API con
curl. .cursor/skills/verify-feedjolt/scripts/cleanup.shal terminar.
El login con magic link necesita el worker Celery en marcha; los enlaces aparecen en los logs del worker en local, no en un buzón real.
Quickstart
Instala el widget de Feedjolt, crea una clave API y recibe tu primer webhook en un túnel local. Guía rápida de 10 min para desarrolladores; omite lo que no uses.
Resumen del widget
Cómo funciona el widget de Feedjolt: una etiqueta script async monta un botón y carga un iframe aislado al hacer clic. Instalación, qué se carga y aislamiento.
