Lorsque Taskavel MCP ne se comporte pas comme prévu, vérifiez dans l’ordre la connexion : point de terminaison, méthode d’authentification, compte connecté, appartenance au projet, rôle puis entrée de l’outil. Cet ordre évite de remplacer des identifiants ou de modifier des données de projet alors que le problème réel est une mauvaise URL ou session de compte.
Le client ne peut pas se connecter ou s’authentifier
Pour le service public Taskavel, utilisez exactement :
https://taskavel.com/mcp/taskavel
Pour une installation auto-hébergée, utilisez l’URL affichée dans Account Settings → AI Integration (MCP). N’utilisez pas un hôte d’exemple copié, une URL de page ou un point de terminaison d’un autre environnement.
ChatGPT et Claude Desktop doivent employer leur flux de connecteur OAuth. Rouvrez la configuration du connecteur, confirmez le point de terminaison et répétez l’approbation Taskavel avec le compte prévu. Un client CLI nécessite un PAT valide fourni comme identifiant Authorization: Bearer. Si le jeton a été révoqué ou n’a pas été conservé à la création, créez un nouveau jeton nommé et mettez à jour le réglage secret privé du client ; Taskavel ne révèle pas plus tard une valeur de jeton existante.
Le serveur se connecte mais le travail attendu est absent
Demandez au client de lister les projets accessibles. Si le projet n’apparaît pas, vérifiez le compte Taskavel qui a approuvé OAuth ou créé le PAT. Vérifiez ensuite l’appartenance de ce compte au projet. MCP ne contourne pas les règles d’appartenance et ne peut pas combiner l’accès d’un autre compte.
Si le projet existe mais qu’un nom est ambigu, demandez au client d’afficher les choix correspondants et utilisez l’identifiant de projet retourné. Faites de même avec colonnes, jalons, étiquettes et tâches avant une écriture. Une recherche échouée est souvent un identifiant imprécis, non un échec d’autorisation.
Une écriture est refusée ou produit un résultat inattendu
Vérifiez le rôle de projet de l’utilisateur connecté. Les invités peuvent lire le contenu et observer les tâches, mais ne peuvent modifier tâches, commentaires ou pièces jointes. Les actions de propriétaire ou administrateur telles que la gestion des membres exigent ces rôles. Ne réessayez pas avec l’identifiant d’un collègue ; modifiez l’appartenance via le propriétaire de projet approprié si l’accès est voulu.
Pour un comportement d’entrée inattendu, examinez la page d’outil générée. Les schémas précisent les champs requis et les descriptions clarifient les cas particuliers. Les descriptions de tâches doivent être du HTML riche valide, non du Markdown. Un numéro de commentaire tel que #123 identifie un commentaire, non une tâche. Listez les jalons existants avant d’en créer un et choisissez une vraie colonne de tableau renvoyée par le serveur.
Une opération destructive est refusée
La suppression définitive possède intentionnellement deux conditions : la tâche doit déjà être archivée et l’appel doit contenir une confirmation explicite. Examinez ou archivez d’abord la tâche. Si votre objectif est seulement de la retirer du travail actif, arrêtez-vous après l’archivage et examinez le résultat ; la suppression n’est pas un raccourci général de nettoyage.
Toujours bloqué
Collectez le nom du client, le type de point de terminaison (OAuth ou PAT), l’erreur exacte non secrète et si une demande de lecture telle que la liste des projets réussit. N’incluez jamais un jeton dans un rapport. Ces informations distinguent un problème de connecteur d’un problème de compte, rôle ou entrée sans exposer d’identifiants.