Theras en 2 minutes
Vos employés utilisent des agents IA qui lisent des fichiers et envoient des mails. Theras se place entre l’agent et vos outils.
- L’agent n’a jamais vos mots de passe ni l’accès direct à vos boîtes : il demande, Theras décide et agit.
- Les règles sont fixes et écrites à l’avance : un mail piégé ne peut pas les contourner.
- Chaque action est rattachée à une personne, et scellée dans un journal de preuves.
1. Installation
Deux parcours au choix, le résultat est le même. Les adresses theras.votre-entreprise.fr sont des exemples à remplacer par la vôtre.
Nous installons, vous n’avez rien de technique à faire
Prévoyez 1 h 30 avec la personne qui sera administrateur.
Avant notre venue
- Un serveur, ou votre accord pour en louer un en France, réservé à votre entreprise.
- Un nom pour l’adresse de Theras et l’accès à vos réglages DNS.
- Un compte administrateur Google Workspace ou Microsoft 365 (15 min).
- La liste des employés et de leurs services.
- La convention de pilote signée.
Le jour J, nous
- installons Theras et le mettons en HTTPS ;
- branchons Google ou Microsoft ;
- créons votre compte et vos services ;
- ajoutons Theras dans Claude ou ChatGPT ;
- verrouillons les postes ;
- faisons un essai complet avec vous.
Vous repartez avec l’adresse de votre console, votre compte administrateur et cette page.
Votre service informatique installe
Comptez 2 à 3 h la première fois. Il faut un serveur Linux avec Docker (2 processeurs et 4 Go suffisent pour 50 personnes), un nom de domaine qui pointe vers lui avec les ports 80 et 443 ouverts, et un accès administrateur Google Workspace ou Microsoft 365.
Étape 1 · Lancer TherasDocker, HTTPS automatique
# code fourni par l'équipe Theras
cd theras
cp .env.example .envDans .env, réglez au minimum :
THERAS_DOMAIN=theras.votre-entreprise.fr THERAS_PUBLIC_URL=https://theras.votre-entreprise.fr THERAS_CONSOLE_URL=https://theras.votre-entreprise.fr THERAS_MCP_FIREWALL=true
Les secrets (clé de chiffrement, mot de passe de la base, secret Microsoft) vont dans le gestionnaire de secrets du serveur, jamais dans Git. La clé de chiffrement se crée ainsi, et se garde précieusement :
python3 -c "import base64,os;print(base64.urlsafe_b64encode(os.urandom(32)).decode())"
Puis :
docker compose --profile https --profile mcp-distant up -d --build docker compose ps
Contrôle : l’adresse de Theras affiche la page de connexion, et /mcp répond 401 (normal : il faut être connecté).
Étape 2 · Brancher Google Workspaceou Microsoft 365 à l’étape suivante
- Dans votre console Google Cloud, créez un projet « Theras » et activez les API Gmail et Google Drive.
- Écran de consentement OAuth : type Interne. Réservé à votre organisation, aucune vérification Google n’est nécessaire.
- Identifiants, puis ID client OAuth de type Application Web, avec ces trois URI de redirection :
https://theras.votre-entreprise.fr/v1/mailbox/callback https://theras.votre-entreprise.fr/oauth/sso/callback https://theras.votre-entreprise.fr/
Téléchargez le fichier JSON du client et déposez-le sur le serveur :
docker compose cp client_secret.json gateway:/data/client_secret.json
# dans .env : THERAS_GOOGLE_CLIENT_FILE=/data/client_secret.json
docker compose up -dÉtape 2 bis · Ou brancher Microsoft 365Microsoft Entra
- Microsoft Entra, Inscriptions d’applications, nouvelle inscription « Theras », comptes de cette organisation uniquement.
- Authentification, plateforme Web, avec les trois mêmes adresses de retour que pour Google.
- Autorisations déléguées :
User.Read,Files.ReadWrite,Mail.Send,Mail.Read,offline_access, puis Accorder le consentement de l’administrateur. - Créez un secret client.
- Sur le serveur :
THERAS_MS_CLIENT_IDetTHERAS_MS_TENANTdans.env, le secret dans le gestionnaire de secrets.
Étape 3 · Créer le premier administrateur
docker compose exec gateway python scripts/creer_super_admin.py \ --email dirigeant@votre-entreprise.fr --nom "Prénom Nom" --societe "Votre entreprise"
La personne se connecte ensuite à la console avec Continuer avec Google (ou Microsoft), sans mot de passe à créer.
Étape 4 · Ajouter Theras dans les agentsClaude, ChatGPT
- Claude Team ou Enterprise : Paramètres de l’organisation, Connecteurs, Ajouter, Personnalisé, adresse
https://theras.votre-entreprise.fr/mcp. Chaque employé le voit ensuite dans ses connecteurs. - ChatGPT Business, Enterprise ou Edu : Paramètres de l’espace de travail, Apps, ajoutez l’app par son adresse MCP, vérifiez-la, puis publiez-la.
- Claude Code : rien à faire côté serveur, voir la partie employé.
Étape 5 · Verrouiller les postesfortement recommandé
Sans cette étape, un employé pourrait utiliser un agent sans passer par Theras.
- Claude Code : déployez les deux fichiers fournis (
managed-settings.json,managed-mcp.json) dans le dossier système de chaque poste, avec votre outil de gestion de parc. L’agent perd le terminal, la lecture directe des fichiers et le web, et seul Theras est autorisé. - ChatGPT Enterprise : les apps sont désactivées par défaut. N’activez que Theras.
- Claude Team ou Enterprise : seuls les propriétaires ajoutent des connecteurs. Ne laissez actif que Theras.
Étape 6 · Boîtes de toute l’entreprisefacultatif
Par défaut, chaque employé autorise sa boîte à sa première connexion. Pour l’autoriser une fois pour tous :
- Google : un compte de service avec délégation au niveau du domaine (console d’administration, Sécurité, Contrôle des API), accès Gmail et Drive.
- Microsoft : autorisations d’application
Mail.Read,Mail.Send,Files.ReadWrite.Allavec consentement de l’administrateur.
Puis, dans la console : Ma boîte, partie Pour toute la société.
Entretiensauvegardes, mises à jour
# sauvegarde, chaque nuit, à copier hors du serveur et chiffrer docker compose exec gateway python -m scripts.sauvegarde sauver --sortie /data/sauvegarde.json.gz # mise à jour git pull && docker compose up -d --build
La supervision (alerte si Theras s’arrête ou si le journal est altéré) se lance avec le profil supervision.
2. Administrateur
Votre console : https://theras.votre-entreprise.fr. Connectez-vous avec Continuer avec Google ou Microsoft.
Ajouter vos employés
Comptes, Nouveau compte : adresse, nom, secteur (RH, Commercial…) et rôle. L’employé n’a rien à ouvrir : il se connecte directement depuis son agent avec son compte Google ou Microsoft.
Membre
Un employé. Il n’a besoin d’aucun accès à la console. Cochez des pages seulement s’il doit voir le journal ou valider des demandes.
Administrateur
Un responsable. Avec un secteur (le DRH par exemple), il ne gère que ce secteur. Sans secteur (le dirigeant), il gère toute l’entreprise.
Plus rapide : dans Comptes, partie Connexion avec Google / Microsoft, indiquez votre domaine. Chaque employé de ce domaine reçoit un compte à sa première connexion, sans aucun accès, et vous lui donnez un secteur ensuite.
Secteurs et droits
Huit secteurs sont proposés et modifiables : Direction, Ressources humaines, Commercial et ventes, Marketing, Finance, Juridique, Administration, Informatique. Un fichier appartient au secteur dont un nom de dossier apparaît dans son chemin : Confidentiel/RH/salaires.xlsx est un fichier RH confidentiel.
Dans Comptes, Modifier un compte, Droits de son agent, vous choisissez pour chaque personne :
- les secteurs dont son agent peut lire et envoyer les fichiers ;
- le niveau maximal : Interne, Confidentiel, ou Secret compris ;
- les envois dans l’entreprise et vers l’extérieur : selon les règles, toujours avec validation, ou interdits.
Ces droits ne font que durcir. Même avec tous les droits, un fichier Secret ne part jamais à l’extérieur.
Valider les demandes
La page Décisions montre ce que l’agent veut faire, pour qui, et pourquoi une validation est demandée. Choisissez Approuver ou Refuser avec une courte justification : Theras exécute aussitôt l’action approuvée.
- La demande va au responsable du secteur de la personne, et à celui du secteur du fichier s’il est différent. Le dirigeant voit tout.
- Personne ne valide la demande de son propre agent.
- Sans réponse au bout de 10 minutes, la demande expire et rien ne part.
Suivre l’activité
Journal : toutes les actions, et par qui. Boîte noire : le journal de preuves scellé, vérifiable et exportable pour un audit ou un litige.
Quand un employé part
Comptes, Modifier, Compte actif : non. Son agent est coupé immédiatement, et l’accès à sa boîte ne peut plus servir.
3. Employé
Vous gardez votre compte Claude ou ChatGPT. Vous y ajoutez seulement Theras, une fois.
Connecter votre agent
- Paramètres, Connecteurs. Si votre entreprise a ajouté Theras, il apparaît avec la mention « Personnalisé ». Sinon : Ajouter un connecteur personnalisé, adresse
https://theras.votre-entreprise.fr/mcp. - Cliquez sur Connecter.
- Sur la page Theras : Continuer avec Google (ou Microsoft), choisissez votre compte professionnel, puis Continuer.
- Dans une conversation, ouvrez Apps et choisissez Theras, ajouté par votre entreprise.
- Cliquez sur Connecter.
- Sur la page Theras : Continuer avec Google (ou Microsoft), puis Continuer.
claude mcp add --transport http theras https://theras.votre-entreprise.fr/mcp
Puis, dans Claude Code : /mcp, theras, Authenticate, et Continuer avec Google. Si votre poste a été verrouillé par l’informatique, Theras est déjà configuré : seule l’authentification reste.
C’est tout. Vos prochaines demandes, comme « envoie le compte rendu à Paul » ou « lis le dernier devis », passent par Theras.
Après une demande
L’action est faite tout de suite.
L’agent vous explique pourquoi, par exemple « fichier Secret vers l’extérieur ». Rien n’est parti.
Un responsable doit approuver. S’il répond dans les 30 secondes, l’agent vous donne le résultat directement. Sinon, il vous donne un numéro, par exemple PA-0012.
- Ne relancez pas la demande, sinon elle partirait deux fois.
- Une fois validée, Theras exécute l’action lui-même.
- Pour une lecture, demandez à l’agent : « vérifie l’action PA-0012 ».
Vos fichiers et votre boîte
Sur Google Drive ou OneDrive, votre agent ne voit que le dossier Theras de votre espace : rangez-y les documents à lui confier. Dans la console, la page Ma boîte montre si votre boîte est connectée, et vous pouvez la déconnecter à tout moment.
Questions
« Boîte non connectée »
Votre agent agit pour vous, mais Theras n’a pas encore l’accès à votre boîte. Dans la console : Ma boîte, puis Connecter.
« Refusé : fichier d’un secteur non autorisé »
Ce dossier appartient à un autre service. Demandez à votre responsable de vous ouvrir ce secteur si votre travail le nécessite.
« Pas de compte Theras »
Votre adresse n’a pas encore été ajoutée. Votre administrateur l’ajoute en une minute, dans la page Comptes.
Google affiche « Accès bloqué » ou « application non validée »
L’application Theras de votre entreprise n’est pas en mode « Interne ». Votre service informatique le corrige à l’étape 2 de l’installation.
J’ai oublié mon mot de passe
Utilisez Continuer avec Google ou Microsoft. Sinon, votre administrateur vous renvoie un lien depuis la page Comptes.
Est-ce que Theras lit mes mails ?
Theras ne lit rien de lui-même. Il ne lit ou n’envoie que lorsque votre agent le demande et que les règles l’autorisent, et chaque action est notée dans le journal. Il ne contient aucune IA : il applique des règles.