Feedjoltdocs
Desarrolladores

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

SuperficieURL
Índice para agenteshttps://www.feedjolt.com/llms.txt
Docs completoshttps://www.feedjolt.com/llms-full.txt
OpenAPI JSONhttps://www.feedjolt.com/openapi.json
OpenAPI YAMLhttps://www.feedjolt.com/api/openapi.yaml
OpenAPI en el host de APIhttps://api.feedjolt.com/openapi.json
MCP Readerhttps://api.feedjolt.com/mcp/reader/
MCP Writerhttps://api.feedjolt.com/mcp/writer/
MCP Combinado (recurso OAuth legado)https://api.feedjolt.com/mcp/
Tarjeta del servidor MCPhttps://www.feedjolt.com/.well-known/mcp.json
n8n (n8n-nodes-feedjolt a npm)https://www.feedjolt.com/es/docs/developers/external-apps/n8n
Sitemaphttps://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 ni FEEDJOLT_API_KEY en los ajustes de plugins de Cursor. Misma feature de plan rest_api que 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:

  1. .cursor/skills/verify-feedjolt/scripts/launch.sh — arranca el stack de dev propio (falla si el puerto 3000 ya está en uso).
  2. .cursor/skills/verify-feedjolt/scripts/doctor.sh — comprobaciones de salud en API + web.
  3. Conduce la UI con automatización del navegador; llama a la API con curl.
  4. .cursor/skills/verify-feedjolt/scripts/cleanup.sh al 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.

On this page