Onboarding d’un collaborateur

Vue d’ensemble

Trois personnes interviennent : vous, qui arrivez ; l’administrateur(trice) de la plateforme, qui crée votre Space ; et, une seule fois pour toute l’équipe, le propriétaire de l’organisation adalan dans claude.ai, qui y ajoute le connecteur et le skill.

Les étapes

1. Signer la charte d’usage

   VousAdministrateur

   La charte d’usage fixe les règles de la plateforme : pas de données personnelles réelles, pas de secrets dans les fichiers, protection des contenus clients, durée de vie des sites. Vous la lisez, la signez et la remettez à l’administrateur, qui la conserve. Le Space n’est créé qu’ensuite.

2. Choisir votre façon de travailler

   Vous

   claude.ai

   Rien à installer. Vous demandez à Claude de produire une présentation ou une maquette, puis de la publier. Idéal pour commencer.

   Claude Code

   Dans le terminal, avec une clé SSH. Pour les projets construits (Vite, Next.js…), les applications et les gros sites.

   Dans le doute, commencez par claude.ai : Claude Code s’ajoute plus tard sans rien changer à votre Space. Envoyez ensuite à l’administrateur :

   • votre adresse e-mail, celle que Grace connaît : la plateforme y lit vos nom, rôle et grade, les rappels d’expiration y arrivent, et votre connexion (compte Microsoft pour un(e) salarié(e), adresse e-mail et mot de passe pour un(e) externe) s’en sert pour retrouver votre Space. Le nom de votre Space, affiché en titre de sa page, est le vôtre, tel que Grace le connaît ;
   • le cas échéant, le slug souhaité, le segment des adresses de votre Space : par défaut votre prénom et votre nom (spaces.adalan.ai/jean-durand/), ou plus court (durand). Il se fixe à la création et ne change plus ensuite ;
   • pour Claude Code, votre clé publique SSH (étape suivante).

3. Créer votre clé SSH

   Vous, pour Claude Code seulement

   La clé SSH identifie votre poste auprès du serveur, sans mot de passe. Si vous en avez déjà une, réutilisez-la : la commande suivante l’affiche.

   cat ~/.ssh/id_ed25519.pub

   Sinon, créez-la. Validez l’emplacement proposé avec Entrée ; une phrase de passe protège la clé si le poste est perdu, elle est recommandée.

   ssh-keygen -t ed25519 -C "prenom.nom@adalan.fr"
   cat ~/.ssh/id_ed25519.pub

   ssh-keygen -t ed25519 -C "prenom.nom@adalan.fr"
   Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub

   Envoyez à l’administrateur la ligne affichée, qui commence par ssh-ed25519. Une clé par poste : pour un second ordinateur, créez une autre clé et envoyez-la aussi.

   N’envoyez jamais la clé privée, le fichier id_ed25519 sans extension .pub. Elle ne quitte pas votre poste.

4. Créer le Space

   Administrateur

   Sur la page d’administration, l’administrateur choisit le collaborateur dans la liste des personnes actives de Grace (par défaut, celles qui n’ont pas encore de Space) ; le slug se remplit, prénom-nom, et reste modifiable. Ou, sur le serveur (ssh almalinux@spaces.adalan.ai) :

   sudo adalan-admin space add --email jean.durand@adalan.fr \
     --key "ssh-ed25519 AAAA… jean@portable"

   Sans --key, le Space n’est ouvert qu’au connecteur claude.ai et à sa page ; une clé s’ajoute plus tard. Le slug est prénom-nom selon Grace (jean-durand) ; pour un autre, plus court ou si celui-ci est pris, l’administrateur le donne en premier (space add durand --email …). La suite de ce guide prend durand pour exemple. La commande vérifie dans Grace que l’adresse est celle d’une personne active et en reprend la fiche, crée le compte, le Space et son quota, vérifie que la page du Space répond, puis affiche une seule fois le code d’accès du connecteur et le bloc de configuration SSH à transmettre.

   Vous recevez aussitôt un courriel de bienvenue : l’adresse de votre Space, son slug, votre façon de vous y connecter (compte Microsoft pour un(e) salarié(e) ; adresse e-mail et mot de passe, choisi à la première connexion avec un code reçu par e-mail, pour un(e) externe), l’adresse des paramètres de votre Space, le lien vers cette page, le connecteur à ajouter dans claude.ai et, si vous avez donné une clé SSH, le bloc de configuration de Claude Code. Vous ne le retrouvez plus ? L’administrateur vous le renvoie en un clic.

   Le code d’accès n’y est jamais : si vous en avez besoin (ni compte Microsoft, ni code par e-mail possible), l’administrateur vous le remet de vive voix, par SMS ou par un autre message, jamais dans le même message que le slug du Space. Des modèles de ces messages sont prêts dans la documentation d’administration.

5. Ajouter le connecteur et le skill à claude.ai

   Propriétaire de l’organisation claude.ai, une seule fois

   Sur un plan Team ou Enterprise, seul un propriétaire de l’organisation peut ajouter un connecteur personnalisé. Il le fait une fois pour toute l’équipe : si le connecteur « adalan » apparaît déjà dans vos connecteurs, passez à l’étape suivante.

   1. Organization settings › Connectors › Add › Custom › Web.
   2. Nom : adalan ; adresse : https://spaces.adalan.ai/mcp.
   3. Laisser vides l’identifiant et le secret OAuth (Advanced settings) : Claude s’inscrit de lui-même auprès du connecteur.

   Il importe aussi le skill spaces-adalan, qui donne à Claude le parcours de publication et les vérifications à faire : claude.ai ne lui transmet pas les consignes générales du connecteur. Organization settings › Plugins & skills › Add › Upload a skill, fichier spaces-adalan.zip. Le skill est alors activé pour tous, dans claude.ai et dans Claude Code pour qui s’y connecte avec son compte Claude.

   Sur un plan individuel (Pro, Max), chacun ajoute le connecteur et le skill pour soi : voir le guide claude.ai.

6. Relier claude.ai à votre Space

   Vous

   1. Dans claude.ai : Customize › Connectors, puis le connecteur adalan et Connect.
   2. Une page adalan s’ouvre, « Relier Claude à votre Space ». Salarié(e) : Se connecter avec Microsoft, avec votre compte adalan (une fois le SSO activé). Externe : votre adresse e-mail et votre mot de passe ; à votre première connexion, Première connexion ou mot de passe oublié : recevoir un code, puis le code reçu, puis le mot de passe que vous choisissez. Sinon, le slug de votre Space (celui de son adresse, par exemple durand) et votre code d’accès, puis Autoriser l’accès.
   3. De retour dans une conversation, activez le connecteur adalan dans le menu des outils, et demandez : « Quel est mon Space adalan ? ». Claude répond avec votre Space, vos adresses et votre quota.

   Le connecteur vaut aussi pour Claude Desktop et l’application mobile. Le détail et les exemples de demandes sont dans Avec claude.ai.

7. Préparer Claude Code

   Vous, pour Claude Code seulement

   Installez Claude Code si ce n’est pas fait (instructions), puis ajoutez à la fin du fichier ~/.ssh/config le bloc remis par l’administrateur :

   Host adalan
       HostName spaces.adalan.ai
       User durand

   Vérifiez l’accès. À la première connexion, SSH demande de confirmer l’identité du serveur : comparez l’empreinte avant de répondre yes.

   ssh adalan adalan info

   Vérifiez enfin que Claude Code a le skill spaces-adalan, qui lui donne le parcours de publication et les vérifications à faire : tapez /skills dans Claude Code. Fourni par l’organisation, il y figure déjà si vous êtes connecté avec votre compte Claude. Sinon, installez-le :

   mkdir -p ~/.claude/skills/spaces-adalan
   curl -fsSL https://spaces.adalan.ai/docs/telechargements/spaces-adalan/SKILL.md \
     -o ~/.claude/skills/spaces-adalan/SKILL.md

8. Vérifier et publier un premier site

   Vous

   Demandez à Claude une page simple, publiée sous un nom d’essai :

   • dans claude.ai : « Crée une page qui présente l’équipe projet, aux couleurs d’adalan, puis publie-la sur ma plateforme adalan sous le nom essai » ;
   • dans Claude Code, depuis un dossier qui contient un index.html : « Publie ce dossier sur ma plateforme adalan sous le nom essai ».

   Claude renvoie l’adresse, https://spaces.adalan.ai/durand/essai/, et sa date d’expiration. Ouvrez-la, puis supprimez le site d’essai : « Supprime le site essai ».

Liste de vérification

Côté collaborateur

• La charte d’usage est signée et remise.
• Claude répond à « Quel est mon Space adalan ? » dans claude.ai.
• Pour Claude Code : ssh adalan adalan info affiche votre Space, et /skills liste spaces-adalan.
• Votre mot de passe (externes) et, si vous en avez un, votre code d’accès sont rangés dans votre gestionnaire de mots de passe, et nulle part ailleurs.
• Un premier site a été publié, ouvert, puis supprimé.
• La page https://spaces.adalan.ai/durand/ s’ouvre avec votre connexion et liste vos sites ; https://spaces.adalan.ai/durand/admin montre vos paramètres.

Côté administrateur

• La charte signée est archivée.
• Le Space est créé avec --email : rappels d’expiration, connexion Microsoft ou par adresse e-mail et mot de passe en dépendent.
• Le code d’accès a été remis par un autre canal que le slug du Space.
• sudo adalan-admin space show durand affiche les clés attendues, le code d’accès remis et une page de Space qui renvoie vers sa connexion (302).

Et ensuite

• Publier un site : noms, liens relatifs, protection par mot de passe.
• Publier une application : Dockerfile, variables, base de données.
• Gérer ses sites : prolonger, protéger, supprimer.

À votre départ, vos accès sont coupés, et vos sites transférés ou archivés puis supprimés sous 30 jours, comme le prévoit la charte d’usage.