Eines MCP

Les 37 eines del servidor MCP de Feedjolt, agrupades per recurs, cadascuna amb el seu scope requerit - a més dels comportaments que sorprenen: les proteccions en eliminar taulers i estats, esborrany vs. publicació del changelog, i les regles d'edició de comentaris.

Cada eina requereix un scope al principal que la crida - read, write o delete. Aquesta concessió surt de la pantalla de consentiment OAuth o d'una clau d'API. Consulta Permisos per veure què significa cada scope i com concedir-lo.

Posts

Eina	Scope	Propòsit
`list_posts`	`read`	Llistar/filtrar posts per tauler, estat o etiqueta, amb paginació
`search_posts`	`read`	Cercar posts per paraula clau al títol
`get_post`	`read`	Detall complet del post: cos, estat, etiquetes i fins a 200 comentaris
`create_post`	`write`	Crear un post en un tauler, amb autoria d'aquesta clau
`update_post`	`write`	Actualitzar el títol, cos o visibilitat interna d'un post
`change_post_status`	`write`	Moure un post a un nou estat, amb nota interna opcional
`move_post`	`write`	Moure un post a un altre tauler
`add_tag_to_post`	`write`	Etiquetar un post (cal usar una etiqueta existent)
`remove_tag_from_post`	`write`	Eliminar una etiqueta d'un post
`assign_post_owner`	`write`	Assignar (o esborrar) l'admin responsable d'un post
`set_post_featured`	`write`	Destacar o treure el destacat d'un post al portal
`merge_posts`	`write`	Fusionar un duplicat en un post canònic
`unmerge_posts`	`write`	Desfer una fusió, restaurant el post original
`delete_post`	`delete`	Eliminar permanentment un post, els seus vots i els seus comentaris

Taulers

Eina	Scope	Propòsit
`list_boards`	`read`	Llistar tots els taulers amb la seva visibilitat i nombre de posts
`create_board`	`write`	Crear un tauler
`update_board`	`write`	Actualitzar un tauler, incloent arxivar-lo
`delete_board`	`delete`	Eliminar un tauler buit únicament - vegeu més avall

Etiquetes

Eina	Scope	Propòsit
`list_tags`	`read`	Llistar totes les etiquetes amb el seu nombre de posts
`create_tag`	`write`	Crear una etiqueta
`update_tag`	`write`	Reanomenar o recolorir una etiqueta
`delete_tag`	`delete`	Eliminar una etiqueta - els posts es mantenen, només perden l'etiqueta

Estats

Eina	Scope	Propòsit
`list_statuses`	`read`	Llistar tots els estats del workspace
`create_status`	`write`	Crear un estat
`update_status`	`write`	Actualitzar el nom, color, visibilitat al roadmap o ordre d'un estat
`delete_status`	`delete`	Eliminar un estat, reassignant els seus posts - vegeu més avall

Comentaris

Eina	Scope	Propòsit
`list_comments`	`read`	Llistar comentaris d'un post, amb paginació
`post_comment`	`write`	Afegir un comentari (públic o intern)
`update_comment`	`write`	Editar, fixar o canviar la visibilitat d'un comentari - vegeu més avall
`delete_comment`	`delete`	Eliminar permanentment un comentari, de qualsevol autor i qualsevol post

Changelog

Eina	Scope	Propòsit
`get_changelog`	`read`	Entrades recents publicades del changelog
`create_changelog_entry`	`write`	Crear una entrada de changelog com a esborrany - vegeu més avall
`update_changelog_entry`	`write`	Actualitzar el títol, cos o posts enllaçats d'una entrada
`publish_changelog_entry`	`write`	Publicar un esborrany - vegeu més avall
`delete_changelog_entry`	`delete`	Eliminar permanentment una entrada, publicada o en esborrany

Roadmap

Eina	Scope	Propòsit
`get_roadmap`	`read`	Columnes del roadmap agrupades per estats visibles al roadmap

Ordre

Eina	Scope	Propòsit
`reorder_items`	`write`	Fixar l'ordre de visualització de taulers, etiquetes o estats en una sola crida

Comportaments que val la pena conèixer

`delete_board` rebutja taulers amb posts

delete_board només funciona en un tauler amb zero posts, i no existeix cap argument per forçar-ho. Eliminar un tauler arrossega en cascada tots els seus posts, vots i comentaris - de manera permanent, sense desfer - així que MCP no ho farà sota cap circumstància, sigui com sigui que es formuli la petició.

Per retirar un tauler sense perdre el seu contingut, crida update_board amb archived: true. El tauler desapareix dels llistats actius; tots els posts queden intactes.

`delete_status` requereix una destinació de reassignació

Els posts referencien el seu estat amb una restricció de base de dades que impedeix eliminar un estat en ús, així que delete_status exigeix un reassign_to_status_id obligatori. Cada post en l'estat condemnat es mou primer a aquesta destinació, i cada moviment genera la seva pròpia entrada d'historial d'estat - igual que un canvi d'estat manual.

Hi ha dos estats que mai es poden eliminar així: l'estat per defecte del workspace, i l'últim estat restant. Converteix un altre estat en el predeterminat, o crea un segon estat, abans d'eliminar cap dels dos.

`create_changelog_entry` sempre crea un esborrany

create_changelog_entry només crea un esborrany - mai és visible per als clients. Publicar és una crida separada i deliberada: publish_changelog_entry. Publicar envia un correu a cada subscriptor i dispara els webhooks del changelog, així que arriba a clients reals en el moment en què s'executa. Revisa el contingut de l'entrada amb update_changelog_entry abans de publicar-la, no després.

`update_comment` només pot editar el seu propi text

update_comment edita tres coses independents - body, is_pinned, is_internal - però no segueixen la mateixa regla. Editar body només funciona en un comentari que aquesta clau d'API ha publicat ella mateixa; el servei rebutja l'intent de reescriure el text d'un altre autor. Fixar i canviar la visibilitat no tenen aquesta restricció - una clau pot fixar o ocultar/mostrar qualsevol comentari del workspace sigui qui sigui qui l'hagi escrit. delete_comment tampoc té restricció: elimina qualsevol comentari, cosa que la fa útil per netejar spam.

Altres coses que val la pena saber

create_post compta contra la quota mensual de posts del workspace - la mateixa quota que respecta el botó "Nou post" del dashboard. Falla en el moment que s'assoleix la quota.
get_post i list_comments retornen comentaris interns a més dels públics - els agents MCP veuen tot el que veu un admin. No reenviïs un comentari amb is_internal: true a un client final.
merge_posts es pot desfer amb unmerge_posts, però la restauració és degradada: els vots, comentaris i etiquetes es queden al post destinació. El post restaurat torna amb 0 vots.
move_post rebutja moure un post a un tauler arxivat, i rebutja un "moviment" al tauler on el post ja és.
reorder_items descarta silenciosament qualsevol ID que no pertanyi al workspace (error tipogràfic, workspace equivocat, ja eliminat) en lloc de donar error. Compara reordered amb submitted a la resposta per veure si s'ha descartat alguna cosa.

El que MCP encara no pot fer

Les eines MCP operen sobre les dades de feedback d'un workspace - posts, taulers, etiquetes, estats, comentaris, changelog, roadmap. No toquen la configuració del workspace, la facturació, els membres de l'equip i els seus rols, ni la configuració de webhooks, widget o branding. Això es queda al dashboard.

Eines MCP

On this page