Connectez vos agents IA (MCP)

Syncro expose un serveur MCP pour connecter des assistants IA (Claude, ChatGPT, Codex, Cursor, opencode, Mistral…) à vos projets. L'assistant agit avec vos permissions : il ne voit que les projets dont vous faites partie et respecte votre rôle.

MCP est le standard qui permet à un assistant de lire et modifier les données d'une app. Vous décidez ce que vous connectez et pouvez le révoquer à tout moment depuis votre profil.

Endpoint

Tous les assistants pointent vers le même endpoint :

https://syncrowork.app/api/mcp

Connecter un assistant distant (OAuth)

Claude, ChatGPT, Codex ou Cursor se connectent via OAuth 2.1 : vous collez l'URL de l'endpoint et ils ouvrent un écran d'autorisation Syncro.

1. Ajoutez un connecteur/serveur MCP avec l'URL ci-dessus.
2. Un onglet s'ouvre pour vous connecter (si ce n'était pas fait) et autoriser l'accès.
3. Vérifiez les permissions demandées (Lecture ou Lecture et écriture) et cliquez sur Autoriser.
4. Terminé : l'assistant peut maintenant lire et modifier vos données.

La première fois vous verrez l'écran de consentement avec le nom de l'app qui se connecte et les permissions demandées. Vous pouvez annuler sans rien autoriser.

Connecter un assistant local (stdio + jeton)

Les assistants qui tournent sur votre machine (par exemple Claude Desktop ou opencode en mode local) utilisent un jeton personnel au lieu d'OAuth :

1. Allez dans Profil → Accès pour agents.
2. Dans Jetons d'accès, donnez-lui un nom, choisissez les permissions (Lecture / Écriture), limitez-le éventuellement à un projet et fixez une expiration.
3. Cliquez sur Créer un jeton et copiez la valeur (elle ne sera plus affichée).

Puis configurez l'assistant avec ce jeton. Exemple générique :

{
  "mcpServers": {
    "syncro": {
      "url": "https://syncrowork.app/api/mcp",
      "headers": { "Authorization": "Bearer syncro_pat_VOTRE_JETON" }
    }
  }
}

Dans chaque assistant

Comment chaque client se connecte, et où trouver sa documentation officielle :

Permissions et périmètre

• Un jeton peut être limité à un projet ; l'assistant ne verra alors que ce projet.
• Les colonnes et tableaux ne peuvent être créés ou renommés que si vous êtes propriétaire ou administrateur.
• Un agent ne peut jamais supprimer un projet, retirer des membres ni changer les rôles.

Et maintenant ?

Une fois l'assistant connecté, ces deux guides vous aident à en profiter :

• Ce que vous pouvez demander à votre agent : résumés, recherches et état de vos projets.
• Ce que votre agent peut faire dans Syncro : créer, déplacer et commenter des tâches, étiquettes et Markdown.

En cas de problème

• Ça ne se connecte pas : vérifiez que l'URL correspond exactement à l'endpoint et que vous vous êtes connecté avant d'autoriser.
• Vous avez affiché un jeton et l'avez perdu : les jetons ne s'affichent qu'une fois. Révoquez-le et créez-en un nouveau.
• Un assistant ne répond plus : vérifiez dans Profil → Accès pour agents que l'application ou le jeton sont toujours actifs.

Révoquer l'accès

Dans Profil → Accès pour agents :

• Applications connectées : cliquez sur Révoquer pour couper l'accès OAuth d'un assistant.
• Jetons d'accès : cliquez sur Révoquer pour invalider un jeton local.

La révocation est immédiate : l'assistant ne peut plus lire ni écrire.

---

Astuce : Commencez par Lecture seule pour tester ; activez Écriture quand vous faites confiance au flux. Vérifiez de temps en temps Accès pour agents et révoquez ce que vous n'utilisez pas.