Le serveur MCP 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 → Jeton API et vérifiez si le jeton est toujours présent et actif. Si vous cliquez sur Afficher le jeton, vous verrez le jeton complet. Recopiez-le 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 → Applications connectées et vérifie si la connexion est toujours active. Si ce n’est pas le cas, révoque-la et reconnecte-toi via Paramètres → Connecter l’assistant IA.

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 (l’ancien deviendra alors invalide), 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 → Jeton API, créez un nouveau jeton avec le rôle approprié et saisissez-le dans le client.
OAuth (Claude.ai, ChatGPT) : sous Paramètres → Applications connectées, révoquez la connexion existante et sélectionnez la portée requise 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 rapport 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 → Applications connectées, révoquez la connexion, puis reconfigurez-la via Paramètres → Connecter l’assistant IA.
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é.