Resolución de problemas MCP
Soluciona errores comunes del MCP de Feedjolt: 402 plan requerido, 401 no autorizado, 403 scope insuficiente, 429 límite de tasa, etiqueta no encontrada, y los guardarraíles al eliminar tableros y estados.
402 Plan requerido
La respuesta indica que el acceso a MCP requiere el plan Startup o Scale (no Growth). Tu workspace está en Growth, que no incluye el servidor MCP. Cambia a Startup o Scale desde Dashboard -> Facturación y vuelve a intentarlo.
401 No autorizado
La petición no llevaba credencial, o era inválida o estaba revocada.
- OAuth. Vuelve a aprobar el cliente en el navegador, o mira Dashboard -> Developers -> MCP -> Apps conectadas.
- Clave de API. Tu cabecera
Authorization: Bearer fjk_...falta, está mal formada o la clave fue revocada. Genera una nueva clave en Claves de API.
403 Forbidden - falta un scope
La credencial es válida pero le falta el scope que exige la herramienta. El error indica qué scope falta y qué puede hacer el principal en su lugar:
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-keysEn OAuth, vuelve a aprobar con el scope que falta (step-up). En una clave de API, ábrela en Claves de API y añade el scope. Consulta Permisos para ver qué cubre cada scope.
429 Límite de peticiones alcanzado
Has superado 600 peticiones por minuto por principal (clave de API, o usuario+cliente en OAuth). La respuesta de error incluye un indicador retry_after_seconds. Si lo ves con un uso normal, contacta con soporte.
La herramienta devuelve "Etiqueta 'X' no encontrada"
Las etiquetas deben existir previamente. Usa list_tags para ver las disponibles, o crea la etiqueta en el dashboard primero.
delete_board rechaza con "REFUSED: board ... holds N posts"
Es el comportamiento esperado - delete_board nunca elimina un tablero que todavía tiene posts, y no hay ningún argumento para forzarlo, porque eliminar arrastra en cascada todos los posts, votos y comentarios del tablero. Mueve los posts a otro sitio, o llama a update_board con archived: true para retirar el tablero conservando su contenido. Consulta Herramientas MCP.
delete_status pide reassign_to_status_id
delete_status necesita saber dónde poner los posts que están en el estado que vas a eliminar - pasa el ID del estado destino como reassign_to_status_id. También se niega a eliminar el estado por defecto del workspace o su único estado restante; usa list_statuses para encontrar otro estado que promover o al que reasignar primero. Consulta Herramientas MCP.
Herramientas MCP
Las 37 herramientas del servidor MCP de Feedjolt, agrupadas por recurso, cada una con su scope requerido - además de los comportamientos que sorprenden: los guardarraíles al eliminar tableros y estados, borrador vs. publicación del changelog, y las reglas de edición de comentarios.
SSO con JWT
Autentica a tus usuarios en el portal y el widget de Feedjolt con un JWT efímero que firma tu backend. Sin segundo inicio. Configura claims, secretos y rotación.