Que faire si le serveur MCP de Picasi ne répond pas ?
Réponse courte
Si le serveur Picasi-MCP ne répond pas, cela est généralement dû à un jeton API non valide, à un fichier de configuration obsolète ou à une intégration incorrecte du serveur MCP dans l’application d’IA.
Détails
Vérifier le jeton :
Dans Picasi, ouvrez Paramètres du Workspace → Connexions IA et vérifiez sous Jetons d’accès actifs si le jeton est toujours là et quand a eu lieu sa Dernière utilisation. Picasi n’affiche plus le jeton lui-même après sa création. S’il manque ou si vous n’avez plus la valeur, créez-en un nouveau et remplacez la valeur dans votre .mcp.json ou dans votre configuration.
Vérifier le fichier de configuration dans Claude Code :
Ouvre le fichier ~/.claude.json ou le fichier spécifique au projet .mcp.json et vérifie :
- La valeur
PICASI_API_TOKENest-elle correctement définie ? - L’URL (
https://picasi.app/mcp) est-elle correcte ? - Le JSON est-il syntaxiquement correct (aucune virgule manquante, aucun guillemet incorrect) ?
Claude Desktop / ChatGPT (OAuth) :
Pour les connexions basées sur OAuth, la session peut avoir expiré. Ouvre Picasi sous Paramètres personnels → Connexions et vérifie si la connexion y figure toujours. Si ce n’est pas le cas, ou si elle ne fonctionne plus, révoque-la et reconnecte l’assistant, comme la première fois.
Recharger le serveur MCP :
Dans Claude Code : Tapez /mcp dans le chat et vérifiez si picasi figure dans la liste des serveurs connectés. Si ce n’est pas le cas, redémarrez l’application — les serveurs MCP sont chargés au démarrage.
Si rien ne fonctionne :
Créez un nouveau jeton API, révoquez l’ancien, mettez à jour tous les fichiers de configuration et redémarrez l’assistant IA.
Autres erreurs courantes
« Permission required » ou erreur de portée lors de l’appel d’un outil
L’outil appelé nécessite une portée supérieure à celle accordée lors de la connexion. Exemple : create_source nécessite write, mais le jeton n’a été créé qu’avec read.
- Jeton API : sous Paramètres du Workspace → Connexions IA, créez un nouveau jeton avec le Niveau d’autorisation approprié et saisissez-le dans le client.
- OAuth (Claude.ai, ChatGPT) : sous Paramètres personnels → Connexions, révoquez la connexion existante et choisissez Lire et écrire lors de la reconnexion.
Réponse 401 Unauthorized
Le serveur n’a pas pu détecter de jeton valide.
- L’en-tête
Authorization: Bearer …est-il manquant, ou la chaîne « Bearer » est-elle vide ? Vérifiez dans la configuration du client. - Pour Claude Code : la variable d’environnement
PICASI_API_TOKENn’est éventuellement définie que dans le terminal à partir duquel le client a été lancé. Si le jeton est référencé dans.mcp.json, définissez-le directement à cet endroit.
Réponse 403 Forbidden
Le jeton est valide, mais la ressource sollicitée n’appartient pas au Workspace connecté.
- Vérifiez si le jeton a été émis pour le bon Workspace. Un nouveau jeton est nécessaire en cas de changement de Workspace.
Erreurs réseau ou délais d’attente
La requête n’atteint pas Picasi ou est interrompue.
- Vérifiez le VPN ou le proxy de l’entreprise :
https://picasi.app/mcpdoit être accessible. - Pour les requêtes d’analyse (résumés, retours d’information) : le client IA s’interrompt au bout d’environ 30 secondes. Ces analyses ne sont actuellement pas proposées via MCP — générez plutôt le Report dans l’application Picasi et récupérez-le avec
get_report.
La connexion est régulièrement interrompue (Claude.ai / ChatGPT)
Les jetons d’accès OAuth expirent. Picasi renouvelle généralement la connexion automatiquement ; dans de rares cas, la connexion est définitivement interrompue.
- Sous Paramètres personnels → Connexions, révoquez la connexion, puis reconnectez l’assistant.
- Cas connu : après une inactivité prolongée (> 15 jours sans actualisation), la connexion doit être réautorisée.
La version du serveur ne correspond pas à celle du client
Si le client IA affiche un message d’erreur indiquant une version de protocole (par ex. unsupported protocol version), le client est probablement trop ancien.
- Mettre à jour le client : Claude Code (
claude update), Claude Desktop et ChatGPT via leur boutique respective.
Connexion établie, mais aucune donnée
list_sources renvoie une liste vide, bien que des sources soient visibles dans l’application.
- Vérifiez si la connexion a été établie dans le bon Workspace. Le contexte de l’équipe peut être vérifié à l’aide de
get_team_context— le champteam.nameindique le Workspace actuellement connecté.