Connecter Syntra à Claude et ChatGPT
Le connecteur Syntra permet à Claude et ChatGPT de travailler avec votre espace Syntra grâce au protocole ouvert Model Context Protocol (MCP). Posez vos questions sur les projets, tâches, risques et sprints en langage courant et, là où votre espace l’autorise, laissez l’assistant les créer et les modifier pour vous.
Prérequis
- Un compte Syntra membre d’un espace sur un plan payant : Starter, Business ou Enterprise. La lecture via Claude et ChatGPT est incluse dans tout plan payant ; l’écriture est incluse dans le plan Enterprise, avec l’API et les webhooks. Voir les tarifs.
- Claude (tout plan qui prend en charge les connecteurs) ou ChatGPT (un plan qui permet d’ajouter un serveur MCP personnalisé).
- Rien à installer, aucune app OAuth à enregistrer, aucun client ID ni clé API à créer. Vous vous connectez à Syntra dans votre navigateur, choisissez l’espace et autorisez l’accès une seule fois.
Adresse du serveur : https://syntra.tymko.tech/mcp. Vous choisissez l’espace sur la page de consentement lors de la connexion. Si vous êtes membre de plusieurs espaces et préférez un connecteur distinct pour chacun, vous pouvez utiliser à la place l’adresse propre à un espace, https://syntra.tymko.tech/mcp/<workspace>, affichée dans Syntra sur la page API de l’espace. C’est facultatif.
Connexion dans Claude
Syntra figure dans l’annuaire des connecteurs de Claude (Claude Connectors Directory) en tant que connecteur communautaire. Claude s’identifie automatiquement auprès de Syntra avec un Client ID Metadata Document : il n’y a donc ni app OAuth, ni client ID, ni clé API à configurer. Le connecteur fonctionne dans Claude sur le web, dans Claude Desktop et dans les apps mobiles.
- Trouvez Syntra.Dans Claude, ouvrez Customize (ou Settings) → Connectors, recherchez Syntra et cliquez sur Connect. Vous pouvez aussi ouvrir directement la fiche Syntra.
- Connectez-vous à Syntra.Une fenêtre Syntra s’ouvre ; connectez-vous avec votre compte Syntra (et votre second facteur, s’il est activé).
- Choisissez l’espace et autorisez l’accès.La page de consentement indique l’app (Claude, claude.ai), votre utilisateur, le niveau d’accès et l’adresse de retour. Si vous êtes membre de plusieurs espaces, choisissez-en un, puis cliquez sur « Autoriser ».
- Posez votre question.Dans une nouvelle conversation, interrogez Claude sur vos projets. Claude appelle les outils Syntra et affiche chaque appel qu’il effectue.
Claude Code se connecte de la même façon : claude mcp add --transport http syntra https://syntra.tymko.tech/mcp, puis lancez /mcp pour vous connecter.
Connexion dans ChatGPT
- Ajoutez un serveur MCP personnalisé.Dans ChatGPT, ouvrez Plugins (Settings → Apps), cliquez sur Add, puis sur Add custom MCP server. Saisissez l’URL
https://syntra.tymko.tech/mcpet choisissez OAuth comme authentification. - Connectez-vous et autorisez.ChatGPT s’identifie automatiquement : il n’y a donc rien à enregistrer dans Syntra. Connectez-vous à Syntra, choisissez l’espace et cliquez sur « Autoriser » sur la même page de consentement que pour Claude ; elle désigne l’app comme ChatGPT (chatgpt.com).
- Utilisez-le dans une conversation.Mentionnez Syntra ou sélectionnez-le dans le menu des outils, puis posez votre question.
Syntra ne figure pas encore dans l’annuaire d’apps de ChatGPT : pour l’instant, on l’ajoute comme serveur MCP personnalisé.
Autres clients MCP
Les autres clients qui prennent en charge les serveurs MCP distants se connectent à https://syntra.tymko.tech/mcp avec OAuth, via une app OAuth enregistrée dans les paramètres de l’espace, onglet « API » : même connexion et même page de consentement que ci-dessus. Les clients qui envoient leurs propres en-têtes peuvent utiliser à la place une clé d’accès Syntra, sous la forme Authorization: Bearer syn_…. Par exemple, Claude Code avec une clé : claude mcp add --transport http syntra https://syntra.tymko.tech/mcp --header "Authorization: Bearer syn_…". Les propriétaires et administrateurs de l’espace émettent les clés dans les paramètres de l’espace, onglet « API » ; chaque membre peut créer une clé personnelle dans « Paramètres » → « Clés API ». Les apps OAuth et les clés d’accès sont incluses dans le plan Enterprise.
Outils
Chaque connexion reçoit les outils de lecture. Les outils d’écriture n’apparaissent qu’avec le plan Enterprise, lorsque l’écriture est activée pour l’espace et que vous avez choisi « lecture et écriture » sur la page de consentement. Aucun outil ne peut rien supprimer.
| Outil | Ce qu’il fait |
|---|---|
list_projects | Les projets que vous voyez : code, nom, statut, avancement, priorité, trimestre, responsable, échéance, département, feux de santé, risques ouverts. Lecture seule. |
get_project | Un projet en détail : description, budget, feux de santé, tâches par statut, les tâches elles-mêmes et les risques avec leurs mesures d’atténuation. Lecture seule. |
list_tasks | Les tâches de vos projets ou d’un seul projet, les plus récemment modifiées d’abord, filtrées par projet, statut, responsable, sprint ou date de modification. Lecture seule. |
list_sprints | Les sprints par département, avec dates, statut, nombre de tâches et Story Points. Lecture seule. |
get_sprint | Un sprint en détail : objectif, Story Points, ses tâches et le burndown. Lecture seule. |
whoami | L’utilisateur et l’espace au nom desquels agit la connexion, et le rôle. Lecture seule. |
create_task | Crée une tâche ou un rapport de bug dans un projet, en votre nom. Écriture. |
update_task | Modifie une tâche : titre, description, statut, responsable, échéance, étiquettes, Story Points, sprint. Écriture. |
add_task_comment | Ajoute un commentaire à une tâche ; le responsable de la tâche et celui du projet sont notifiés. Écriture. |
create_project | Crée un projet avec description, statut, priorité, trimestre, échéance et responsable. Écriture. |
update_project | Modifie les champs d’un projet, ses feux de santé ou son budget. Écriture. |
add_risk | Enregistre un risque sur un projet, avec sa gravité et sa mesure d’atténuation. Écriture. |
update_risk | Modifie le texte, la gravité, la mesure d’atténuation ou le statut d’un risque (le clôturer ou le rouvrir). Écriture. |
create_sprint | Planifie un nouveau sprint pour un département. Écriture. |
update_sprint | Modifie le nom, l’objectif ou les dates d’un sprint planifié ou en cours. Écriture. |
Exemples de requêtes
- « Quels projets sont en retard ce trimestre, et pourquoi ? »
- « Qu’est-ce qui a changé dans les projets marketing depuis lundi ? »
- « Où en est le sprint en cours ? Montre le burndown et ce qui reste ouvert. »
- « Qui a le plus de tâches en retard en ce moment ? »
- « Crée un bug dans le projet P-117 : le bouton de paiement ne fait rien sur iOS, avec les étapes pour le reproduire. »
- « Ajoute un risque élevé à P-131 : le fournisseur risque de manquer la date de lancement ; atténuation : un second fournisseur. »
Droits d’accès
- Vos droits, rien de plus. L’assistant agit en votre nom dans l’espace choisi et voit exactement ce que votre rôle permet ; les projets restreints restent masqués si vous ne pouvez pas les ouvrir.
- Lecture pour chaque membre. Les membres d’espaces sur tout plan payant (Starter, Business ou Enterprise) peuvent se connecter et lire.
- Écriture sur Enterprise, quand les deux côtés l’autorisent. Les outils d’écriture ne fonctionnent qu’avec le plan Enterprise, lorsqu’un superadmin Syntra a activé l’écriture MCP pour l’espace (le propriétaire en fait la demande au support) et que vous avez choisi « lecture et écriture » sur la page de consentement. Sinon, la connexion est en lecture seule, quoi que demande l’assistant.
- Aucune suppression. Aucun outil ne supprime de projets, tâches, risques, sprints ou commentaires.
- Connecteur uniquement. Les jetons délivrés à Claude et ChatGPT ne valent que pour la connexion MCP, pas pour le reste de l’API Syntra.
- Modifications visibles. Les modifications faites via le connecteur apparaissent dans Syntra sous votre nom, dans l’historique de la tâche et du projet et dans le journal d’audit.
Confidentialité et données
Syntra n’envoie à l’assistant que les résultats des outils qu’il appelle, limités à ce que vous pouvez voir. Syntra ne reçoit ni ne conserve vos conversations avec Claude ou ChatGPT ; ce que l’assistant fait des résultats des outils relève des conditions d’Anthropic ou d’OpenAI applicables à votre compte. La connexion utilise OAuth 2.0 avec PKCE : l’assistant ne voit jamais votre mot de passe Syntra, et Syntra ne conserve que des empreintes (hash) des jetons qu’il émet. Les détails figurent dans la politique de confidentialité, la liste des sous-traitants et le DPA.
Déconnexion
Supprimez le connecteur dans Claude ou ChatGPT, puis retirez votre consentement dans Syntra, dans « Paramètres » → « Clés API » → « Mes autorisations ». Chaque membre le fait pour son propre accès. Dès lors, le jeton de rafraîchissement (refresh token) de l’assistant cesse aussitôt de fonctionner, et le jeton d’accès en cours expire dans les 24 heures. Le propriétaire d’un espace peut aussi demander au support de désactiver l’écriture pour tout l’espace.
Dépannage
« Aucun espace auquel connecter cette application »
Aucun de vos espaces n’est sur un plan payant, ou l’adresse d’espace indiquée dans l’URL du connecteur est celle d’un espace dont vous n’êtes pas membre. Adressez-vous au propriétaire de l’espace, ou connectez-vous avec l’adresse générale https://syntra.tymko.tech/mcp.
L’assistant indique que la connexion est en lecture seule
L’espace n’est pas sur le plan Enterprise, l’écriture y est désactivée, ou vous n’avez autorisé que la lecture. L’écriture nécessite le plan Enterprise ; demandez au propriétaire de faire activer l’écriture, puis déconnectez-vous, reconnectez-vous et choisissez « lecture et écriture » sur la page de consentement.
Un projet manque dans les réponses
Demandez à l’assistant d’exécuter whoami : il indique l’utilisateur, l’espace et le rôle utilisés par la connexion. Les projets que vous ne pouvez pas ouvrir dans Syntra ne sont pas non plus visibles pour l’assistant.
Support
Écrivez à support@tymko.tech en indiquant l’heure du problème et, si possible, le nom de l’outil affiché par l’assistant.