Aller au contenu
Ouvrir l'app

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_TOKEN est-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_TOKEN n’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/mcp doit ê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 champ team.name indique le Workspace actuellement connecté.