> ## Documentation Index
> Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Serveur MCP pour les réseaux sociaux et les agents IA

> Laissez Claude, Cursor, Codex ou tout client MCP programmer des publications, répondre aux messages et lire les statistiques via le serveur MCP distant de Social media studio.

## Qu'est-ce que MCP ?

Le [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) est un standard ouvert pour connecter des outils d'IA à des services externes. Le serveur MCP de Social media studio permet aux agents IA de créer, programmer et gérer directement des publications sur les réseaux sociaux.

## Détails de connexion

| Propriété | Valeur |
| - | - |
| **Point de terminaison complet** (Cursor / personnalisé) | `https://api.so-me.studio/mcp` |
| **Point de terminaison du répertoire** (places de marché, sans outils d'image/vidéo IA) | `https://api.so-me.studio/mcp/directory` |
| **Point de terminaison du répertoire Claude** (Claude Connectors Directory) | `https://api.so-me.studio/mcp/claude` |
| **Transport** | Streamable HTTP (POST uniquement) |
| **Authentification** | En-tête `X-API-Key` **ou** OAuth 2.1 (PKCE) |
| **Mode** | Sans état (pas de sessions) |

> [!NOTE]
>
> Les connecteurs personnalisés (Cursor, connecteur personnalisé Claude avec une clé collée) peuvent continuer à utiliser
> `X-API-Key`. Les fiches des places de marché utilisent OAuth : la fiche du Claude Connectors Directory utilise
> l'URL du **répertoire Claude** (voir ci-dessous), et les autres places de marché utilisent l'URL du **répertoire**,
> qui exclut les outils d'image/vidéo IA.

> [!NOTE]
>
> L'URL MCP du répertoire filtre les outils de génération d'images et de vidéos par IA (politique du répertoire
> Claude). Les outils d'IA pour les légendes/textes et de programmation restent disponibles. Le catalogue complet reste sur
> `/mcp`.

## Connecteur Claude Directory

**Social media studio** (propulsé par So-me Studio) dispose de son propre point de terminaison pour Claude. La fiche du Claude
Connectors Directory et le plugin Social media studio pour Claude l'utilisent, et vous pouvez
l'ajouter dès aujourd'hui comme connecteur personnalisé par URL (**Customize** > **Connectors** > **Add custom
connector**). Il donne à Claude les mêmes 28 outils de publication que les plugins ChatGPT et Grok.

| Propriété | Valeur |
| - | - |
| **URL** | `https://api.so-me.studio/mcp/claude` |
| **Connexion** | OAuth 2.1 avec PKCE. Claude ouvre la page de connexion de Social media studio ; aucune clé d'API n'est nécessaire. |
| **Espace de travail** | L'espace de travail que vous approuvez sur la page de consentement. Votre forfait, vos autorisations et vos limites d'utilisation s'appliquent. |

Le connecteur couvre :

* **Publication et programmation** — créer, modifier, programmer, déprogrammer, relancer et supprimer des publications, et lire le calendrier
* **Brouillons** — créer, modifier, supprimer des brouillons et les convertir en publications
* **Bibliothèque de médias et téléversement** — parcourir, rechercher et téléverser des images et des vidéos
* **Vérification des médias** — contrôler les fichiers par rapport aux règles médias de chaque plateforme avant de publier
* **Options de publication** — fils de publications, premier commentaire, et paramètres de confidentialité et d'interaction TikTok
* **Destinations** — comptes connectés, tableaux Pinterest, et canaux Discord et Slack

Il ne couvre pas les statistiques, la boîte de réception, la facturation, l'administration des comptes, ni la génération
d'images et de vidéos par IA. Les publications Reddit et Google Business Profile ne sont pas prises en charge dans cette version.

> [!NOTE]
>
> Le parcours développeur ne change pas : utilisez `https://api.so-me.studio/mcp` avec un en-tête `X-API-Key`
> pour le catalogue complet d'outils.

## OAuth (clients du répertoire)

Social media studio prend en charge MCP OAuth 2.1 avec PKCE (S256), les métadonnées de ressource protégée, et
l'enregistrement dynamique de clients / des métadonnées de serveur d'autorisation compatibles CIMD.

Le [guide Auth.md](https://so-me.studio/auth.md), lisible par les agents, décrit le flux PKCE complet pour client public. Son URL et la méthode `user_authorization` prise en charge sont aussi publiées dans le bloc `agent_auth` des métadonnées OAuth.

| Point de terminaison | Rôle |
| - | - |
| `GET /.well-known/oauth-protected-resource/mcp/directory` | Métadonnées de ressource protégée pour le MCP du répertoire |
| `GET /.well-known/oauth-protected-resource/mcp/claude` | Métadonnées de ressource protégée pour le MCP du répertoire Claude |
| `GET /.well-known/oauth-authorization-server` | Découverte du serveur d'autorisation (PKCE S256) |
| `GET /oauth/authorize` | Autorisation + consentement |
| `POST /oauth/token` | Échange / renouvellement de jeton |
| `POST /oauth/register` | Enregistrement dynamique de client (solution de repli) |

Les outils d'écriture restent réservés à certains forfaits (accès API Standard, Advanced ou Lifetime) pour les sessions par clé d'API comme pour OAuth.

## Outils disponibles

Une fois connecté, votre agent IA peut appeler **205 outils**, regroupés ci-dessous par domaine. Chaque outil consomme un petit nombre de crédits MCP par appel (1 = lecture, 2 = écriture/modification, 3 = statistiques, 5 = texte IA, 8 = image IA, 10 = actions IA composées). Utilisez `list_mcp_tools` pour obtenir la liste à jour avec le coût en crédits de chaque outil, et `get_mcp_usage` pour vérifier vos crédits MCP restants.

> **Publications (11 outils)**
>
> | Outil | Description |
> | - | - |
> | `list_posts` | Lister les publications programmées/publiées avec filtrage par statut et par plateforme |
> | `get_post` | Obtenir une publication par ID |
> | `create_post` | Créer une publication ciblant n'importe quelle plateforme connectée |
> | `update_post` | Modifier le contenu ou la programmation d'une publication existante |
> | `schedule_post` | Programmer une publication existante pour une publication ultérieure |
> | `unschedule_post` | Retirer une publication de la programmation (retour à l'état en attente) |
> | `delete_post` | Supprimer une publication |
> | `retry_post` | Relancer une publication en échec (le statut passe de FAILED à PENDING) |
> | `resubmit_post` | Soumettre à nouveau une publication rejetée pour approbation |
> | `bulk_delete_posts` | Supprimer plusieurs publications à la fois |
> | `get_calendar_posts` | Obtenir les publications d'une période (vue calendrier) |

> **Commentaires de publication (5 outils)**
>
> | Outil | Description |
> | - | - |
> | `list_post_comments` | Lister les commentaires d'une publication |
> | `add_post_comment` | Ajouter un commentaire à une publication |
> | `update_post_comment` | Modifier un commentaire de publication existant |
> | `delete_post_comment` | Supprimer un commentaire de publication |
> | `mark_comments_as_read` | Marquer tous les commentaires d'une publication comme lus |

> **Brouillons (6 outils)**
>
> | Outil | Description |
> | - | - |
> | `list_drafts` | Lister les brouillons de votre espace de travail |
> | `get_draft` | Obtenir un brouillon par ID |
> | `create_draft` | Créer un nouveau brouillon |
> | `update_draft` | Modifier un brouillon existant |
> | `delete_draft` | Supprimer un brouillon |
> | `convert_draft` | Convertir un brouillon en publication programmée |

> **Comptes (3 outils)**
>
> | Outil | Description |
> | - | - |
> | `list_accounts` | Lister les comptes de réseaux sociaux connectés |
> | `get_account` | Obtenir les détails d'un compte social connecté |
> | `disconnect_account` | Déconnecter (supprimer) un compte social connecté |

> **Médias (13 outils)**
>
> | Outil | Description |
> | - | - |
> | `list_media` | Lister les fichiers médias de votre bibliothèque |
> | `search_media` | Rechercher des fichiers médias par nom |
> | `get_media_file` | Obtenir un fichier média par ID |
> | `delete_media` | Supprimer un fichier média de la bibliothèque |
> | `bulk_delete_media` | Supprimer plusieurs fichiers médias à la fois |
> | `list_media_folders` | Lister les dossiers de médias de la bibliothèque |
> | `create_media_folder` | Créer un nouveau dossier de médias |
> | `delete_media_folder` | Supprimer un dossier de médias (et son contenu) |
> | `move_media_file` | Déplacer un fichier média vers un autre dossier ou à la racine |
> | `move_media_folder` | Déplacer un dossier vers un autre parent ou à la racine |
> | `rename_media_file` | Renommer un fichier média |
> | `rename_media_folder` | Renommer un dossier de médias |
> | `presign_media_upload` | Générer des URL PUT S3 présignées pour téléverser des fichiers dans la bibliothèque |

> **Boîte de réception (18 outils)**
>
> | Outil | Description |
> | - | - |
> | `list_conversations` | Lister les conversations de la boîte de réception sur toutes les plateformes connectées |
> | `get_messages` | Obtenir les messages d'un fil de conversation |
> | `reply_to_conversation` | Publier une réponse dans un fil de conversation |
> | `update_conversation` | Mettre à jour le statut d'une conversation (lue/vue, résolue, etc.) |
> | `delete_conversation` | Supprimer un fil de conversation |
> | `list_saved_replies` | Lister les modèles de réponses enregistrées |
> | `get_saved_reply` | Obtenir une réponse enregistrée par ID |
> | `create_saved_reply` | Créer un nouveau modèle de réponse enregistrée |
> | `update_saved_reply` | Modifier une réponse enregistrée existante |
> | `delete_saved_reply` | Supprimer une réponse enregistrée |
> | `subscribe_inbox` | Activer la synchronisation de la boîte de réception pour un compte social connecté |
> | `unsubscribe_inbox` | Désactiver la synchronisation de la boîte de réception pour un compte social connecté |
> | `edit_inbox_message` | Modifier un commentaire/message dans la boîte de réception sociale (Facebook/Instagram) |
> | `delete_inbox_message` | Supprimer un commentaire/message dans la boîte de réception sociale (Facebook/Instagram) |
> | `hide_inbox_message` | Masquer ou afficher à nouveau un commentaire dans la boîte de réception sociale (Facebook/Instagram) |
> | `preview_bulk_reply` | Prévisualiser les destinataires d'une réponse groupée avant l'envoi |
> | `create_bulk_reply` | Envoyer une même réponse (avec personnalisation `{{name}}` facultative) à de nombreuses conversations de messages privés |
> | `get_bulk_reply_batch` | Obtenir le statut et les résultats d'un lot de réponses groupées |

> **Approbations (4 outils)**
>
> | Outil | Description |
> | - | - |
> | `list_approvals` | Lister les publications en attente d'approbation |
> | `approve_post` | Approuver une publication en attente d'approbation |
> | `reject_post` | Rejeter une publication en attente d'approbation (commentaire de rejet obligatoire) |
> | `update_review_comment` | Modifier le commentaire de relecture/rejet d'une publication dans le workflow d'approbation |

> **Équipes (6 outils)**
>
> | Outil | Description |
> | - | - |
> | `list_team_members` | Lister tous les membres de l'équipe de votre espace de travail |
> | `invite_team_member` | Inviter un nouveau membre dans l'espace de travail |
> | `remove_team_member` | Retirer un membre de l'espace de travail |
> | `update_member_role` | Modifier le rôle d'un membre de l'équipe |
> | `list_team_invitations` | Lister les invitations d'équipe en attente |
> | `cancel_team_invitation` | Annuler une invitation d'équipe en attente |

> **Biolinks (19 outils)**
>
> | Outil | Description |
> | - | - |
> | `list_biolinks` | Lister toutes les pages biolink |
> | `get_biolink` | Obtenir les détails d'une page biolink |
> | `create_biolink` | Créer une nouvelle page biolink |
> | `update_biolink` | Modifier une page biolink existante |
> | `delete_biolink` | Supprimer une page biolink |
> | `publish_biolink` | Basculer l'état de publication d'un biolink |
> | `change_biolink_theme` | Passer un biolink à un thème prédéfini |
> | `set_biolink_custom_theme` | Appliquer des couleurs de thème personnalisées à un biolink |
> | `list_biolink_buttons` | Lister les boutons d'une page biolink |
> | `create_biolink_button` | Ajouter un bouton à une page biolink |
> | `update_biolink_button` | Modifier un bouton d'une page biolink |
> | `delete_biolink_button` | Supprimer un bouton d'une page biolink |
> | `reorder_biolink_buttons` | Réordonner les boutons d'une page biolink |
> | `list_biolink_posts` | Lister les publications de galerie d'une page biolink |
> | `create_biolink_post` | Ajouter une publication de galerie à un biolink |
> | `update_biolink_post` | Modifier une publication de galerie d'un biolink |
> | `delete_biolink_post` | Supprimer une publication de galerie d'un biolink |
> | `reorder_biolink_posts` | Réordonner les publications de galerie d'un biolink |
> | `get_biolink_analytics` | Obtenir les statistiques d'une page biolink (vues, clics) |

> **Contenu IA (10 outils)**
>
> | Outil | Description |
> | - | - |
> | `generate_caption` | Générer une légende IA pour une plateforme et un ton donnés |
> | `generate_content` | Générer ou réécrire du texte IA de tout type (publication, légende, hashtag, titre, bio, fil, e-mail, etc.) |
> | `generate_image` | Générer une image IA à partir d'un prompt |
> | `generate_and_schedule` | Générer du contenu IA, créer une publication et la programmer en un seul appel |
> | `get_ai_history` | Obtenir l'historique des prompts de génération IA |
> | `get_ai_credits` | Obtenir les soldes et limites de crédits IA (texte, image, vidéo UGC) du forfait actuel |
> | `list_ai_image_providers` | Lister les fournisseurs de génération d'images IA autorisés par le forfait actuel |
> | `list_generated_images` | Lister les images générées par IA avec pagination |
> | `get_generated_image` | Obtenir les détails d'une image générée par IA par ID |
> | `delete_generated_image` | Supprimer une image générée par IA |

> **Vidéo IA / UGC (9 outils)**
>
> | Outil | Description |
> | - | - |
> | `generate_video` | Générer une vidéo UGC IA à partir d'un texte d'accroche + un avatar |
> | `list_videos` | Lister les vidéos UGC générées |
> | `get_video` | Obtenir une vidéo générée par ID (inclut le statut de génération) |
> | `delete_video` | Supprimer une vidéo générée |
> | `list_avatars` | Lister les avatars UGC disponibles pour la génération de vidéos |
> | `list_sounds` | Lister les sons/musiques disponibles pour la génération de vidéos |
> | `get_sound_genres` | Lister les genres de sons d'ambiance disponibles pour les vidéos UGC |
> | `generate_hook_suggestions` | Générer des suggestions d'accroches/scripts IA pour les vidéos UGC |
> | `list_ai_video_providers` | Lister les fournisseurs de vidéos UGC IA autorisés par le forfait actuel |

> **Statistiques (26 outils)**
>
> | Outil | Description |
> | - | - |
> | `get_analytics_summary` | Obtenir les statistiques de l'espace de travail : nombre de publications par statut et par plateforme |
> | `get_platform_analytics` | Obtenir des statistiques détaillées pour un compte social connecté donné |
> | `get_post_analytics` | Obtenir les statistiques d'une publication donnée |
> | `get_facebook_analytics` | Obtenir les statistiques Facebook au niveau de la page |
> | `get_facebook_posts_analytics` | Obtenir les statistiques de page Facebook par publication |
> | `get_facebook_videos_analytics` | Obtenir les statistiques de page Facebook par vidéo |
> | `get_instagram_analytics` | Obtenir les statistiques Instagram au niveau du compte |
> | `get_instagram_media_analytics` | Obtenir les statistiques des médias Instagram par publication |
> | `get_instagram_stories_analytics` | Obtenir les statistiques des stories Instagram |
> | `get_linkedin_analytics` | Obtenir les statistiques LinkedIn au niveau de la page |
> | `get_linkedin_posts_analytics` | Obtenir les statistiques de page LinkedIn par publication |
> | `get_youtube_analytics` | Obtenir les statistiques YouTube au niveau de la chaîne |
> | `get_youtube_videos_analytics` | Obtenir les statistiques de chaîne YouTube par vidéo |
> | `get_twitter_analytics` | Obtenir les statistiques Twitter/X au niveau du compte |
> | `get_twitter_content_analytics` | Obtenir les statistiques Twitter/X au niveau du contenu |
> | `get_tiktok_analytics` | Obtenir les statistiques du compte TikTok |
> | `get_whatsapp_analytics` | Obtenir les statistiques du compte WhatsApp Business |
> | `get_bluesky_analytics` | Obtenir les statistiques du compte Bluesky |
> | `get_mastodon_analytics` | Obtenir les statistiques du compte Mastodon |
> | `get_reddit_account_analytics` | Obtenir les statistiques Reddit au niveau du compte |
> | `get_reddit_submissions_analytics` | Obtenir les statistiques des soumissions (publications) Reddit |
> | `get_pinterest_analytics` | Obtenir les statistiques du compte Pinterest |
> | `get_pinterest_pins_analytics` | Obtenir les statistiques Pinterest par épingle |
> | `get_pinterest_top_pins_analytics` | Obtenir les épingles Pinterest les plus performantes |
> | `get_pinterest_top_video_pins_analytics` | Obtenir les épingles vidéo Pinterest les plus performantes |
> | `get_gmb_analytics` | Obtenir les statistiques d'un établissement Google Business Profile (GMB) |

> **Meilleur moment pour publier (3 outils)**
>
> | Outil | Description |
> | - | - |
> | `get_best_time_recommendations` | Lister les recommandations de meilleur moment pour publier pour tous les comptes connectés de l'espace de travail |
> | `get_best_time_recommendation` | Obtenir la recommandation de meilleur moment (carte de chaleur + meilleurs créneaux) pour un compte |
> | `recompute_best_time_recommendation` | Recalculer la recommandation de meilleur moment d'un compte à partir de l'historique d'engagement récent |

> **Modèles (3 outils)**
>
> | Outil | Description |
> | - | - |
> | `list_templates` | Lister les modèles de contenu disponibles par catégorie |
> | `get_template` | Obtenir un modèle par ID |
> | `render_template` | Générer un modèle avec les valeurs de champs fournies |

> **Connaissances (RAG) (6 outils)**
>
> | Outil | Description |
> | - | - |
> | `list_knowledge` | Lister les documents de connaissances utilisés par l'assistant IA (RAG) |
> | `get_knowledge` | Obtenir un document de connaissances avec le texte extrait et les métadonnées |
> | `create_knowledge` | Créer un document de connaissances à partir d'un fichier téléversé ou d'une note saisie |
> | `update_knowledge` | Modifier les métadonnées ou le corps de la note d'un document de connaissances |
> | `reprocess_knowledge` | Relancer l'extraction d'un document de connaissances PDF/image/texte en échec |
> | `delete_knowledge` | Supprimer un document de connaissances |

> **Canva (4 outils)**
>
> | Outil | Description |
> | - | - |
> | `get_canva_status` | Vérifier si Canva est connecté pour l'utilisateur authentifié |
> | `list_canva_designs` | Lister les designs Canva de l'utilisateur (paginé, avec recherche) |
> | `export_canva_design` | Exporter un design Canva en image (asynchrone ; renvoie un ID de tâche d'export) |
> | `get_canva_export_status` | Interroger le statut d'une tâche d'export de design Canva |

> **Aide et support (5 outils)**
>
> | Outil | Description |
> | - | - |
> | `create_ticket` | Créer un ticket de support |
> | `list_tickets` | Lister vos tickets de support |
> | `get_ticket` | Obtenir un ticket de support avec ses détails |
> | `send_ticket_message` | Envoyer un message dans un ticket de support |
> | `list_ticket_messages` | Lister tous les messages d'un ticket de support |

> **Notifications (5 outils)**
>
> | Outil | Description |
> | - | - |
> | `list_notifications` | Lister les notifications dans l'application de l'utilisateur authentifié |
> | `get_unread_notification_count` | Obtenir le nombre de notifications non lues, éventuellement par catégorie |
> | `mark_notification_read` | Marquer une notification comme lue |
> | `mark_all_notifications_read` | Marquer toutes les notifications (éventuellement d'une catégorie) comme lues |
> | `archive_notification` | Archiver (ignorer) une notification |

> **Paramètres et compte (9 outils)**
>
> | Outil | Description |
> | - | - |
> | `get_profile` | Obtenir votre profil utilisateur |
> | `update_profile` | Modifier le profil de l'utilisateur authentifié (nom, mot de passe, e-mail) |
> | `get_organization` | Obtenir les détails de l'espace de travail/organisation |
> | `update_organization` | Modifier l'espace de travail actuel (nom, description, couleur, fuseau horaire) |
> | `get_usage` | Obtenir le détail de l'utilisation pour la période de facturation en cours |
> | `get_user_preferences` | Obtenir les préférences de l'utilisateur authentifié (notifications, fuseau horaire, interface) |
> | `update_user_preferences` | Modifier (fusionner) les préférences de l'utilisateur authentifié |
> | `get_current_tenant` | Obtenir les détails de l'espace de travail (tenant) actuellement actif |
> | `get_billing` | Obtenir les informations d'abonnement et de facturation |

> **Forfaits et facturation (4 outils)**
>
> | Outil | Description |
> | - | - |
> | `get_plans` | Obtenir le catalogue des forfaits avec tarifs et visibilité |
> | `get_plan_features` | Obtenir la matrice des fonctionnalités d'un forfait donné |
> | `get_subscription` | Obtenir le statut d'abonnement, le forfait et les limites de l'espace de travail |
> | `list_invoices` | Lister les factures de l'abonnement actuel |

> **Clés d'API (3 outils)**
>
> | Outil | Description |
> | - | - |
> | `list_api_keys` | Lister les clés d'API actives de l'espace de travail actuel |
> | `create_api_key` | Créer une nouvelle clé d'API (la clé complète n'est renvoyée qu'une seule fois) |
> | `revoke_api_key` | Révoquer une clé d'API |

> **Espaces de travail / Tenants (4 outils)**
>
> | Outil | Description |
> | - | - |
> | `list_tenants` | Lister les espaces de travail/tenants auxquels appartient l'utilisateur authentifié |
> | `create_tenant` | Créer un nouvel espace de travail dont l'utilisateur authentifié est propriétaire |
> | `delete_tenant` | Supprimer un espace de travail |
> | `leave_tenant` | Quitter un espace de travail dont l'utilisateur est membre |

> **Parrainage (2 outils)**
>
> | Outil | Description |
> | - | - |
> | `get_referral_code` | Obtenir le code de parrainage de l'utilisateur authentifié |
> | `get_referral_stats` | Obtenir le code de parrainage, le nombre de parrainages, les crédits gagnés et l'URL de partage |

> **Introspection MCP (2 outils)**
>
> | Outil | Description |
> | - | - |
> | `get_mcp_usage` | Obtenir l'utilisation des crédits MCP de cet espace de travail, les limites et le détail par outil pour la période en cours |
> | `list_mcp_tools` | Lister tous les outils MCP disponibles et leur coût en crédits |

> **WhatsApp (6 outils)**
>
> | Outil | Description |
> | - | - |
> | `list_whatsapp_templates` | Lister les modèles de messages WhatsApp Business |
> | `get_whatsapp_template` | Obtenir un modèle de message WhatsApp par nom |
> | `create_whatsapp_template` | Créer (soumettre à l'approbation de Meta) un modèle de message WhatsApp |
> | `delete_whatsapp_template` | Supprimer un modèle de message WhatsApp |
> | `send_whatsapp_template` | Envoyer un message modèle WhatsApp à un destinataire |
> | `upload_whatsapp_template_media` | Téléverser le média d'en-tête (image/vidéo/document) d'un modèle |

> **Webhooks (10 outils)**
>
> | Outil | Description |
> | - | - |
> | `list_webhook_subscriptions` | Lister les abonnements webhook |
> | `get_webhook_subscription` | Obtenir un abonnement webhook par ID |
> | `create_webhook_subscription` | Créer un abonnement webhook pour des catégories d'événements |
> | `update_webhook_subscription` | Modifier un abonnement webhook (URL, catégories, état actif, régénération du secret) |
> | `delete_webhook_subscription` | Supprimer un abonnement webhook |
> | `test_webhook_subscription` | Envoyer un ping de test à un abonnement webhook |
> | `list_webhook_deliveries` | Lister les journaux de livraison des webhooks avec filtres facultatifs |
> | `get_webhook_delivery` | Obtenir un journal de livraison webhook avec la charge utile complète et le statut |
> | `retry_webhook_delivery` | Relancer une livraison webhook en échec |
> | `list_webhook_events` | Lister tous les types d'événements webhook disponibles par catégorie |

> **Aides à l'intégration (9 outils)**
>
> Ces outils résolvent les cibles de publication propres à chaque plateforme (tableaux, subreddits, canaux, établissements) afin que vous puissiez choisir une destination avant de créer une publication.
>
> | Outil | Description |
> | - | - |
> | `list_pinterest_boards` | Lister les tableaux Pinterest d'un compte (sélectionnez un tableau avant de publier) |
> | `create_pinterest_board` | Créer un nouveau tableau Pinterest |
> | `list_reddit_subreddits` | Lister les subreddits dont le compte Reddit connecté est membre |
> | `list_reddit_flairs` | Lister les flairs de publication disponibles pour un subreddit |
> | `list_gmb_locations` | Lister les établissements Google Business Profile (GMB) d'un compte |
> | `list_discord_channels` | Lister les canaux Discord disponibles pour un compte en mode bot |
> | `list_slack_channels` | Lister les canaux Slack d'un espace de travail connecté |
> | `list_telegram_chats` | Lister les conversations/groupes Telegram disponibles pour un compte |
> | `get_tiktok_creator_info` | Obtenir les informations de créateur/compte TikTok (valider les capacités de publication) |

## Plateformes prises en charge

L'énumération `socialMedia` / `platform` utilisée par les outils de publication et de contenu IA (`create_post`, `create_draft`, `generate_caption`, `generate_and_schedule`, `generate_hook_suggestions`, etc.) accepte ces valeurs :

| Plateforme | Valeur de l'énumération |
| - | - |
| Twitter / X | `TWITTER` |
| Instagram | `INSTAGRAM` |
| LinkedIn | `LINKEDIN` |
| LinkedIn Page | `LINKEDIN_PAGE` |
| Facebook | `FACEBOOK` |
| TikTok | `TIKTOK` |
| YouTube | `YOUTUBE` |
| Threads | `THREADS` |
| WhatsApp | `WHATSAPP` |
| Dribbble | `DRIBBBLE` |
| Pinterest | `PINTEREST` |

> [!NOTE]
>
> Les outils de statistiques et d'aide à l'intégration couvrent plus de destinations que l'énumération de publication ci-dessus — notamment Bluesky, Mastodon, Reddit, Google Business Profile (GMB), Discord, Slack et Telegram. Utilisez `list_accounts` pour découvrir tous les comptes connectés et leur `accountId`, puis transmettez cet identifiant aux outils de statistiques ou d'aide à l'intégration propres à chaque plateforme.

## Types de publication

Le paramètre `postType` de `create_post`, `update_post`, `create_draft` et `update_draft` accepte : `TEXT`, `IMAGE`, `MULTIPLE_IMAGES`, `VIDEO`, `CAROUSEL`, `REEL`, `STORY` (par défaut : `TEXT`).

## Statuts des publications

Le filtre `status` de `list_posts` accepte : `POSTED`, `SCHEDULED`, `PENDING`, `FAILED`, `PENDING_APPROVAL`, `REJECTED`.

## Exemples de requêtes

Le serveur MCP parle JSON-RPC 2.0 sur Streamable HTTP. La plupart des agents s'en chargent pour vous, mais vous pouvez l'appeler directement avec `curl`.

```bash Lister les outils theme={null}
curl -X POST https://api.so-me.studio/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-API-Key: sk_live_your_api_key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'
```

```bash Créer une publication programmée theme={null}
curl -X POST https://api.so-me.studio/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-API-Key: sk_live_your_api_key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "create_post",
      "arguments": {
        "text": "Big news coming Friday!",
        "socialMedia": "TWITTER",
        "postType": "TEXT",
        "scheduledAt": "2026-06-20T15:00:00.000Z"
      }
    }
  }'
```

```bash Générer + programmer en un seul appel theme={null}
curl -X POST https://api.so-me.studio/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-API-Key: sk_live_your_api_key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "generate_and_schedule",
      "arguments": {
        "platform": "LINKEDIN",
        "socialMedia": "LINKEDIN",
        "topic": "Why async standups beat daily meetings",
        "tone": "professional",
        "scheduledAt": "2026-06-21T09:00:00.000Z"
      }
    }
  }'
```

## Guides de configuration

Choisissez votre agent IA pour commencer :

> **[Claude Code](/fr/mcp/claude-code.md)**
>
> L'outil de codage agentique d'Anthropic

> **[Claude Desktop](/fr/mcp/claude-desktop.md)**
>
> L'application de bureau d'Anthropic

> **[Cursor](/fr/mcp/cursor.md)**
>
> Éditeur de code conçu d'abord pour l'IA

> **[OpenAI Codex](/fr/mcp/codex.md)**
>
> L'agent de codage d'OpenAI

> **[Windsurf](/fr/mcp/windsurf.md)**
>
> IDE propulsé par l'IA de Codeium

> **[VS Code (Copilot)](/fr/mcp/vscode.md)**
>
> Mode agent de GitHub Copilot

> **[Gemini CLI](/fr/mcp/gemini-cli.md)**
>
> L'agent de terminal IA de Google

## Dépannage

> **401 Unauthorized**
>
> Vérifiez que votre clé d'API est correcte et active. L'en-tête doit être exactement `X-API-Key` (sensible à la casse). Générez une nouvelle clé depuis **Paramètres > Accès à l'API** si nécessaire.

> **405 Method Not Allowed sur GET/SSE**
>
> Le serveur MCP de Social media studio fonctionne en mode sans état avec Streamable HTTP. Seules les requêtes POST sont prises en charge. Assurez-vous que votre agent est configuré avec le transport HTTP, et non SSE.

> **Limite de débit dépassée**
>
> Les appels d'outils MCP sont limités par minute selon le forfait. Consultez votre utilisation dans **Paramètres > MCP** et passez à un forfait supérieur si nécessaire.

> **Crédits épuisés**
>
> Chaque appel d'outil MCP consomme des crédits. Consultez les crédits restants dans **Paramètres > MCP**.

> **Délai de connexion dépassé**
>
> Augmentez le délai d'expiration dans votre configuration MCP. Une valeur de 30000 ms (30 secondes) est recommandée.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.