Utilisez le serveur MCP Taskavel lorsqu’un client IA a besoin d’un accès authentifié à votre travail Taskavel. Avant la connexion, décidez si le client peut terminer OAuth dans un navigateur ou s’il a besoin d’un jeton d’accès personnel. Cette réponse détermine la manière dont le client prouve son identité à Taskavel.
Le point de terminaison public Taskavel est :
https://taskavel.com/mcp/taskavel
Si vous utilisez une instance Taskavel auto-hébergée, copiez plutôt l’URL affichée dans Account Settings → AI Integration (MCP). Ne remplacez pas l’URL de production par un nom d’hôte d’exemple provenant d’un extrait de configuration.
Utiliser OAuth pour les clients connecteurs
OAuth est le bon choix pour un client offrant un flux interactif « ajouter un connecteur » ou « ajouter une app ». Il vous redirige vers Taskavel, où vous vous connectez si nécessaire et approuvez la connexion. Le client opère ensuite comme votre utilisateur Taskavel et reste soumis à vos appartenances et restrictions de rôle habituelles.
ChatGPT et Claude Desktop ont des parcours de connecteurs documentés dans les guides suivants. Ajoutez uniquement le point de terminaison Taskavel ci-dessus, puis terminez l’approbation dans Taskavel. Ne créez ni ne collez de jeton personnel pour un client capable d’utiliser OAuth.
Après autorisation, ouvrez le client et posez une question sans risque telle que « Liste mes projets Taskavel ». Une réponse réussie confirme à la fois la connexion MCP et le compte effectif. Si des projets attendus n’apparaissent pas, vérifiez le compte Taskavel et l’appartenance au projet avant de reconnecter.
Utiliser un PAT pour les clients CLI
Claude Code, Codex et les configurations de ligne de commande similaires utilisent un jeton d’accès personnel. Dans Taskavel, ouvrez Account Settings → AI Integration (MCP) et créez un jeton portant un nom précis, par exemple le client et la machine concernés. Copiez la valeur lorsqu’elle est affichée et placez-la uniquement dans un stockage secret local ou une variable d’environnement.
Configurez le client avec le point de terminaison et un en-tête Authorization: Bearer. Ne validez jamais un jeton dans un dépôt, ne l’incluez pas dans une capture d’écran et ne le collez pas dans un fichier de configuration partagé. Un jeton nommé par client ou machine rend une révocation ultérieure précise.
Vérifier la configuration avant les outils d’écriture
Demandez d’abord au client de découvrir les données : lister les projets, vos tâches ou examiner une tâche connue. Confirmez que la réponse correspond au compte Taskavel connecté. Essayez ensuite une demande à faible risque telle qu’un instantané de tableau. Demandez seulement ensuite au client de créer, déplacer ou mettre à jour du travail.
Les erreurs de connexion sont en général des erreurs de point de terminaison ou d’authentification ; les données manquantes indiquent plutôt un problème de compte, appartenance ou rôle. Consultez le dépannage pour les vérifications dans l’ordre et lisez sécurité et révocation avant de distribuer un PAT.