Per a agents

Aquesta pàgina és per a agents d'IA i per a qui els connecta. Si vols un recorregut humà, comença per Quickstart.

Quan usar Feedjolt

Usa Feedjolt quan un equip de producte necessita un portal de feedback visible per als clients:

• Recollir peticions, errors i idees des d'un portal allotjat, un widget incrustable, l'API REST o el servidor MCP.
• Deixar que els clients votin i segueixin peticions per prioritzar per demanda. A l'administració, els admins del workspace i els usuaris marcats amb la pesa compten 1,5×; el portal públic continua sent un recompte brut. No hi ha matriu d'ARR, pla o segment.
• Fusió automàtica opcional de duplicats amb un model semàntic (desactivada per defecte; el propietari de l'espai fixa el llindar de confiança) perquè "login trencat" i "no puc entrar" siguin una sola petició amb els vots combinats.
• Publicar un full de ruta públic i un changelog que avisa qui ha votat quan alguna cosa es publica.
• Redactar amb IA una entrada de changelog des d'un repo de GitHub (commits i pull requests fusionades). Una persona continua publicant.

La llista completa de capacitats — què poden fer clients i equip, i què no s'ha enviat — és a llms.txt.

No usis Feedjolt com a helpdesk general, eina d'NPS/enquestes ni tracker intern. No substitueix Linear ni Jira.

Com cridar Feedjolt

Les URLs de màrqueting i docs negocien markdown: envia Accept: text/markdown (la capçalera Vary inclou Accept). Els docs també accepten el sufix .md.

Auth

• Humans: sense contrasenya (enllaç màgic o Google).
• REST (n8n, scripts, clients HTTP): claus Authorization: Bearer fjk_…, creades al tauler a Startup i Scale (Startup és per sol·licitud). Vegeu Connectar apps externes.
• MCP (Cursor, Claude, altres agents): OAuth 2.1 a /mcp/reader/ i /mcp/writer/. No posis una clau API de Feedjolt ni FEEDJOLT_API_KEY als ajustos de plugins de Cursor. Mateixa feature de pla rest_api que l'API REST.

Preguntes? Contacta'ns a través de la pàgina de contacte. Crea un compte, tria Startup o Scale, obre Ajustos → Claus API.

Els 14 dies de prova Growth (sense targeta) cobreixen la interfície del producte. No inclouen REST/MCP: això és Startup i Scale. Vegeu Sandbox.

Límits de peticions

REST i MCP retornen capçaleres de límit perquè et puguis frenar. Vegeu Límits de peticions.

Verificació local (contribuïdors)

Agents i contribuïdors que provin canvis d'UI o API han d'usar l'skill del repo a .cursor/skills/verify-feedjolt/SKILL.md:

1. .cursor/skills/verify-feedjolt/scripts/launch.sh — arrenca el stack de dev propi (falla si el port 3000 ja està en ús).
2. .cursor/skills/verify-feedjolt/scripts/doctor.sh — comprovacions de salut a API + web.
3. Condueix la UI amb automatització del navegador; crida l'API amb curl.
4. .cursor/skills/verify-feedjolt/scripts/cleanup.sh en acabar.

L'inici de sessió amb magic link necessita el worker Celery en marxa; els enllaços apareixen als logs del worker en local, no en una bústia real.