MCP troubleshooting
La plupart des problèmes Ocoya MCP proviennent de la configuration du client, d’une approbation OAuth incomplète, d’un accès à la marque manquant ou de l’utilisation d’IDs provenant de la mauvaise marque.
Quick checks
| Symptom | What to check |
|---|---|
| Le client n’affiche pas les outils Ocoya | Vérifiez que l’URL MCP est https://mcp.ocoya.com, redémarrez le client et assurez-vous que le client prend en charge les serveurs MCP HTTP distants. |
| OAuth s’ouvre mais l’accès est refusé | Connectez-vous au bon compte Ocoya et approuvez au moins une marque. |
Réponse 401 | Le client n’a pas terminé OAuth, le jeton d’accès a expiré ou le client envoie une clé API au lieu d’utiliser OAuth. |
| Marque introuvable | La marque n’a pas été sélectionnée lors de l’approbation, ou le client utilise un ID de marque provenant d’un autre compte Ocoya. |
| Profil social rejeté | Appelez ocoya_list_social_profiles pour le même brandId et utilisez l’un des IDs renvoyés. |
| Planification non valide | Utilisez une date/heure ISO comme 2026-07-01T09:00:00Z. |
| Impossible d’activer le workflow | Corrigez les erreurs de validation du workflow dans Ocoya avant de l’activer ou de l’exécuter. |
OAuth and authorization
Ocoya MCP n’accepte pas les clés API Ocoya. Les clients MCP doivent utiliser OAuth et envoyer un jeton bearer émis par Ocoya après que l’utilisateur a approuvé l’accès.
Pour le diagnostic, une requête non authentifiée doit renvoyer 401 avec un en-tête WWW-Authenticate qui pointe vers les métadonnées OAuth d’Ocoya :
curl -i https://mcp.ocoya.com \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}'Si un client échoue constamment sur OAuth, supprimez la connexion Ocoya MCP dans ce client, ajoutez-la à nouveau et terminez le flux d’approbation depuis un navigateur où vous pouvez vous connecter à Ocoya.
Brand access
Les outils limités à une marque nécessitent un brandId renvoyé par ocoya_list_brands. Si une marque manque :
- Reconnectez Ocoya MCP.
- Sélectionnez la marque manquante pendant le flux d’approbation OAuth.
- Demandez au client d’appeler à nouveau
ocoya_list_brands.
Ne réutilisez pas d’IDs de marque provenant d’un autre compte, environnement ou octroi OAuth.
Posting and scheduling
Avant de créer ou planifier des posts, demandez au client de récupérer des IDs récents :
List my Ocoya brands and connected social profiles for the Acme brand.Utilisez le brandId et les socialProfileIds renvoyés dans les outils de post. Pour la planification, transmettez des dates/heures ISO :
2026-07-01T09:00:00ZClient-specific notes
| Client | Check |
|---|---|
| Claude Code | Mettez les URLs entre guillemets si votre shell traite certains caractères spéciaux différemment. Redémarrez Claude Code après avoir ajouté un nouveau serveur MCP. |
| Codex | Redémarrez l’application ou ouvrez un nouveau fil après avoir modifié ~/.codex/config.toml. Exécutez codex mcp login ocoya lorsque la connexion OAuth est requise. |
| VS Code | Utilisez une version récente de VS Code avec prise en charge MCP et basculez Copilot Chat en mode Agent. |
| Stdio-only clients | Utilisez mcp-remote pour faire le pont avec https://mcp.ocoya.com. |
Safe recovery
Si la connexion semble obsolète ou que le mauvais compte est connecté :
- Révoquez ou supprimez la connexion Ocoya MCP dans le client.
- Ajoutez à nouveau le serveur MCP.
- Terminez OAuth avec le compte Ocoya souhaité.
- Sélectionnez les marques auxquelles le client doit avoir accès.
- Vérifiez avec
ocoya_list_brandsavant toute action d’écriture.