Joseph Documentation
Ouvrir Joseph

Connecter un assistant IA

Joseph peut être piloté directement depuis un assistant IA (Claude) — consulter et modifier vos tâches, chantiers et projets en langage courant, sans ouvrir Joseph dans un navigateur. Ceci passe par un jeton personnel et un connecteur MCP (Model Context Protocol).

Ce que ça permet

Une fois connecté, vous pouvez par exemple demander :

  • « Liste mes tâches en retard sur Hospiconnect »
  • « Crée une tâche "Valider le cahier des charges", échéance le 15 octobre »
  • « Marque HOSP-42 comme terminé »
  • « Cette tâche dépend de HOSP-38, pose le lien »

Toute action qui modifie quelque chose vous est proposée avant d'être exécutée — l'assistant ne crée, ne modifie ni ne supprime jamais rien sans votre confirmation explicite (sauf si vous choisissez vous-même d'en autoriser certaines en continu, voir plus bas).

Obtenir votre jeton

Un jeton personnel est nécessaire — demandez-le à l'administrateur de votre espace. C'est une longue chaîne de caractères, unique à vous : ne le partagez avec personne, il donne accès à Joseph en votre nom, comme votre mot de passe. Le retirer se fait en le révoquant, comme n'importe quel accès.

Connecter Claude Desktop

  1. Dans Claude Desktop : Réglages → Connecteurs → Ajouter un connecteur personnalisé.
  2. Nom : Joseph. URL : l'adresse du serveur MCP transmise par votre administrateur (ex. https://mcp.scarlett-ai.fr/mcp).
  3. Sur l'écran Authentification, choisir Aucune connexion — « pour les serveurs qui utilisent une clé API au lieu d'OAuth » (pas « Se connecter maintenant », qui est pour l'OAuth).
  4. Dans En-têtes de requête : clé authorization, valeur Bearer VOTRE_JETON — sans oublier Bearer devant le jeton, avec l'espace.
  5. Ajouter, puis Connecter.
  6. Vérifier : demander « Liste mes projets Joseph » dans une nouvelle conversation.

Une fois connecté, un écran liste tous les outils disponibles, chacun réglable sur toujours autoriser, demander à chaque fois, ou toujours refuser. Le réglage par défaut demande confirmation pour toute écriture ou suppression — à ne changer que si vous savez ce que vous faites.

Ce que l'assistant ne fait pas (encore)

  • Créer un nouveau projet ou une nouvelle réunion (récurrence, participants) — ça reste à faire depuis Joseph.
  • Envoyer un fichier (PDF, image...) — seuls les liens et le texte sont pris en charge.

En cas de souci

Les causes les plus fréquentes :

  • Erreur 401 / non connecté : jeton incorrect, périmé, ou Bearer manquant devant.
  • Le mode d'authentification choisi est « Se connecter maintenant » au lieu de « Aucune connexion ».

Contactez l'administrateur de votre espace si le problème persiste.