Resolució de problemes MCP

Soluciona errors comuns del MCP de Feedjolt: 402 pla requerit, 401 no autoritzat, 403 scope insuficient, 429 límit de taxa, etiqueta no trobada, i les proteccions en eliminar taulers i estats.

402 Pla requerit

La resposta indica que l'accés a MCP requereix el pla Startup o Scale (no Growth). El teu workspace està a Growth, que no inclou el servidor MCP. Canvia a Startup o Scale des de Dashboard -> Facturació i torna-ho a provar.

401 No autoritzat

La petició no duia credencial, o era invàlida o estava revocada.

OAuth. Torna a aprovar el client al navegador, o mira Dashboard -> Developers -> MCP -> Apps connectades.
Clau d'API. La capçalera Authorization: Bearer fjk_... falta, està mal formada o la clau ha estat revocada. Genera una nova clau a Claus d'API.

403 Forbidden - falta un scope

La credencial és vàlida però li falta el scope que exigeix l'eina. L'error indica quin scope falta i què pot fer el principal en el seu lloc:

This API key lacks the 'delete' scope. It is allowed to: read, write.
Grant the 'delete' scope to this key at https://feedjolt.com/dashboard/developers/api-keys

En OAuth, torna a aprovar amb l'scope que falta (step-up). En una clau d'API, obre-la a Claus d'API i afegeix l'scope. Consulta Permisos per veure què cobreix cada scope.

429 Límit de peticions assolit

Has superat 600 peticions per minut per principal (clau d'API, o usuari+client en OAuth). La resposta d'error inclou un indicador retry_after_seconds. Si el veus amb un ús normal, contacta amb el suport.

L'eina retorna "Etiqueta 'X' no trobada"

Les etiquetes han d'existir prèviament. Usa list_tags per veure les disponibles, o crea l'etiqueta al dashboard primer.

`delete_board` rebutja amb "REFUSED: board ... holds N posts"

És el comportament esperat - delete_board mai elimina un tauler que encara té posts, i no hi ha cap argument per forçar-ho, perquè eliminar arrossega en cascada tots els posts, vots i comentaris del tauler. Mou els posts a un altre lloc, o crida update_board amb archived: true per retirar el tauler conservant el seu contingut. Consulta Eines MCP.

`delete_status` demana `reassign_to_status_id`

delete_status necessita saber on posar els posts que estan a l'estat que eliminaràs - passa l'ID de l'estat destí com a reassign_to_status_id. També es nega a eliminar l'estat per defecte del workspace o el seu únic estat restant; usa list_statuses per trobar un altre estat que promoure o al qual reassignar primer. Consulta Eines MCP.