# 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.