Clés API

Les clés API relient un client local — Claude Desktop, Cursor, Windsurf, un script — à un espace de travail, par le serveur MCP de Gensy. Elles se gèrent dans Paramètres → Assistants IA et clés API, à partir du forfait Démarrage.

Pour Claude.ai, ChatGPT, Claude Code ou Cursor, le connecteur distant est plus simple: il ne demande aucune clé. Un client qui ne gère pas OAuth peut aussi utiliser une clé avec le connecteur distant, en en-tête (Authorization: Bearer gsk_…). Voir la page Connecteur MCP.

Générer une clé

1. Ouvrez l’onglet Assistants IA et clés API.
2. Donnez un nom à la clé.
3. Choisissez la portée: Lecture + écriture ou Lecture seule.
4. Choisissez l’expiration: 30 jours, 90 jours, 1 an, ou sans expiration.
5. Copiez la clé tout de suite: elle n’est affichée qu’une fois.

Tout membre de l’espace peut générer une clé. Jusqu’à 5 clés actives par espace (les connecteurs n’en occupent pas). Une clé agit avec le rôle de la personne qui l’a créée: celle d’un membre ne peut ni changer les réglages, la marque ou les champs, ni supprimer des employés en lot, ni inviter. Elle cesse de servir si cette personne quitte l’espace.

Configurer un client local

L’onglet affiche l’extrait prêt à copier. Pour Claude Desktop, il va dans claude_desktop_config.json:

{
  "mcpServers": {
    "gensy": {
      "command": "npx",
      "args": ["-y", "gensy-mcp"],
      "env": {
        "GENSY_API_KEY": "votre_cle",
        "GENSY_BASE_URL": "adresse affichée dans l’onglet"
      }
    }
  }
}

Redémarrez le client après chaque modification du fichier.

Ce qu’il faut savoir

• Une clé est liée à un seul espace: les données restent isolées.
• Une clé en lecture seule n’expose même pas les outils d’écriture; toute modification est refusée.
• Limite de 90 requêtes par minute par clé.
• Toutes les actions d’une clé apparaissent dans Paramètres → Activités, avec l’auteur «API».

Accès actifs

La liste réunit clés et connecteurs, avec la portée, l’auteur, la date de création, l’expiration et la dernière utilisation. Chacun révoque les siens; le propriétaire peut tout révoquer, et retirer un membre révoque ses accès avec lui.

Ma clé ne fonctionne pas

• Vérifiez qu’elle n’est ni révoquée ni expirée.
• Vérifiez que l’espace est sur un forfait payant: un retour au forfait Gratuit révoque les clés, et reprendre un forfait payant ne les rétablit pas; elles sont à recréer. Une clé cesse aussi de servir si la personne qui l’a créée a quitté l’espace.
• Une clé perdue ne se récupère pas: révoquez-la et générez-en une nouvelle.