Pruebas y resolución de problemas - MCP
Probar la integración
Llama a tools/list desde un cliente MCP y compara el resultado con los permisos marcados al crear la clave - la lista debería contener exactamente esas herramientas, no más. Después llama a una herramienta de lectura, por ejemplo projects.list, y comprueba en Ajustes → Integración MCP que se ha actualizado la fecha de último uso de la clave.
Problemas habituales
Una herramienta no aparece en tools/list
Una herramienta aparece en la respuesta solo cuando la clave tiene el permiso asociado a ella. Comprueba en los ajustes de la clave si ese permiso está marcado - una herramienta sin él no está oculta ni bloqueada, simplemente no existe desde el punto de vista de esa clave.
issues.get no existe para esta clave
El permiso issues.read por sí solo solo concede metadatos del grupo mediante issues.list - el mensaje del error, el lugar del fallo, la pila de llamadas y los datos completos de la petición necesitan el permiso separado issues.details, desmarcado por defecto. Actívalo de forma consciente en los ajustes de la clave cuando una herramienta necesite de verdad diagnosticar errores.
La clave dejó de funcionar de un día para otro
El alcance de una clave se cruza con los permisos actuales de la persona que la emitió en cada petición. Si esa persona fue degradada, perdió un permiso concreto o su cuenta se desactivó, la clave se reduce o deja de funcionar de inmediato, sin ningún cambio en la propia clave. Restaurar los permisos de quien la emitió devuelve el alcance completo de la clave, porque la fila en la base de datos permanece intacta todo el tiempo.
La petición termina en 403
Comprueba la cabecera Origin de la petición. El servidor MCP rechaza cualquier petición cuya cabecera apunte a un dominio ajeno - es una protección frente a llamadas desde el navegador, no un error de configuración. Este endpoint está pensado para clientes del lado del servidor, no para código que se ejecuta en el navegador de una persona usuaria.
La clave no funciona a pesar de un token y unos permisos correctos
Comprueba si la cuenta todavía tiene comprado el componente MCP - es una función de pago del plan, y su pérdida (por ejemplo, al bajar al plan gratuito) desactiva la autenticación de todas las claves de la cuenta, con independencia de los permisos con los que se emitieron.
Sigue sin funcionar
Repasa la lista de comprobación de falta de datos y, si no ayuda, escríbenos. Indica el nombre del proyecto, la versión de la integración y la hora aproximada de la prueba: acorta el camino a la respuesta.