# Configurer SosoAPI pour la personne utilisant cet assistant

Utilisez l’assistant habituel de la personne et conservez la tâche, le contenu et les
références médias d’origine dans cette conversation. Utilisez un seul MCP SosoAPI pour ses
comptes sociaux connectés. Réutilisez une connexion existante ou choisissez l’accès local ou hébergé
ci-dessous. La configuration ne publie rien. La personne se connecte et choisit les
autorisations dans son navigateur. Ne saisissez jamais ses identifiants et n’approuvez pas le consentement
à sa place. Free ne nécessite aucune carte bancaire.

## 1. Connecter cet assistant

Vérifiez d’abord l’hôte actuel et sa configuration SosoAPI existante. Réutilisez une
connexion fonctionnelle ; ne déconnectez pas, n’écrasez pas la configuration et ne créez pas une autre
connexion simplement parce que ce guide a été rouvert.

Pour un shell local, vérifiez la disponibilité de Node.js 20 ou ultérieur et de npx. Utilisez un
environnement d’exécution pris en charge existant. S’il manque, expliquez le prérequis en termes
simples ; ne modifiez pas automatiquement le système global ou avec privilèges.

Claude Code :

```sh
claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi
```

Codex :

```sh
codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi
```

Après l’enregistrement du serveur, vérifiez que ses outils sont appelables dans cette
conversation. Si l’hôte nécessite une reconnexion ou un redémarrage, indiquez à la personne
l’action à effectuer. Attendez que les outils fonctionnent avant d’annoncer que la connexion est prête.

Les nouvelles connexions utilisent le profil core existant à 28 outils pour la publication courante,
les médias, commentaires et statistiques. Réutilisez une connexion fonctionnelle au profil full.
Si une opération d’administration demandée manque, expliquez que le profil full
est disponible ; masquer un outil n’accorde ni ne révoque d’autorisation.

Pour un client uniquement dans le navigateur comme ChatGPT prenant en charge les applications MCP personnalisées, ajoutez cette
URL MCP distante et choisissez OAuth avec enregistrement automatique du client :

`https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp`

Aucun collage de clé API, client ID ou client secret n’est nécessaire. La personne se connecte
à SosoAPI et choisit ses espaces/actions. Les applications personnalisées ChatGPT dépendent de
son forfait et de l’accès au mode développeur. Réutilisez une connexion locale ou distante fonctionnelle
si elle est déjà configurée.

X prend en charge les textes originaux et les liens. Chaque organisation partage 10 crédits X Free
une fois, ou 100 par période de facturation Pro. Un texte simple coûte 1 ; un Post contenant une URL
coûte 10. Lisez `sosoapi_get_x_usage` avec workspace_id avant de planifier l’usage de X.
Aucun dépassement n’est facturé automatiquement ; une publication incertaine conserve sa réservation de
crédits et doit être réconciliée avant un autre envoi.

## 2. Se connecter sans clé API

Le premier appel MCP authentifié ouvre le parcours existant de connexion dans le navigateur et de
consentement à l’agent. La personne peut utiliser Google ou s’inscrire et vérifier son e-mail.
Laissez-la choisir son espace et décider si l’assistant peut uniquement préparer
le contenu ou aussi programmer et publier. Ne lui demandez pas de copier des identifiants.
Le consentement de publication est continu dans le périmètre choisi, pas un écran
d’approbation obligatoire par publication. Gardez la gestion des clés désactivée pour la publication ordinaire.

L’inscription et la connexion par e-mail utilisent une vérification de sécurité en arrière-plan, sans
case à cocher. Si la vérification échoue, indiquez l’erreur
réelle et utilisez l’action de nouvelle tentative disponible ; ne demandez pas à la personne de chercher ou cliquer
une case CAPTCHA. L’option existante **Continue with Google** est aussi disponible
si la personne souhaite utiliser Google ; Google peut exiger sa propre vérification d’identité.
Laissez la personne choisir son compte et approuver l’accès.
Conservez le lien actuel de connexion/approbation et sa destination de retour ; ne le remplacez pas
par une simple URL d’inscription et ne basculez pas silencieusement sur l’identité d’un mainteneur existant.
Une erreur de connexion ne prouve pas l’indisponibilité de toutes les méthodes.

Suspendez uniquement l’étape nécessitant l’identité ou le consentement de la personne. Pendant qu’elle
la termine, finalisez les vérifications d’installation et préparez le brouillon d’origine sans
inventer de compte ou d’espace. Expliquez ce qui est prêt et l’unique
action suivante requise. Après connexion, relisez le contexte authentifié et reprenez la
même tâche. Ne désactivez pas CAPTCHA, n’utilisez pas les API d’inscription administrateur, ne demandez pas de jetons
et n’annoncez pas le compte ou la connexion comme prêt avant la fin réelle du parcours.

Si les outils MCP nécessitent un rechargement de l’hôte, la CLI locale est aussi disponible pour cet
assistant. Exécutez `npx -y sosoapi auth status` d’abord ; utilisez
`npx -y sosoapi auth login` uniquement si une connexion est nécessaire. Ne lisez jamais le
fichier d’identifiants et n’affichez pas de jetons. Si la connexion ouvre le mauvais profil navigateur, arrêtez
cette connexion en attente avant de démarrer une nouvelle `npx -y sosoapi auth login --no-open`.
La personne ouvre le nouveau lien affiché dans le profil souhaité et vérifie
l’identité connectée avant d’approuver. N’utilisez jamais deux profils simultanément sur le même lien.
Utilisez `--help` d’abord pour confirmer la présence de cette option de récupération dans la CLI installée ;
si elle manque, expliquez la limite de version plutôt que d’inventer une option fonctionnelle.
La CLI peut examiner ses contrats intégrés :

```sh
npx -y sosoapi api contract --summary
npx -y sosoapi api contract --route /studio-api/scheduled-posts/
```

La syntaxe des requêtes CLI est `sosoapi api post </allowlisted-route> < request.json`.
Écrivez le JSON avec votre outil de fichiers ; n’interpolez pas le contenu utilisateur dans des commandes
shell. Lisez http_status et le corps de réponse, pas seulement le code de sortie du
processus. Une erreur API n’est pas une réussite. Utilisez uniquement les routes et schémas du
contrat intégré ; n’inventez pas de noms et ne contournez pas une capacité manquante.

## 3. Connecter le compte social de la personne

Résolvez l’organisation et l’espace authentifiés depuis le contexte SosoAPI.
Ne devinez jamais les identifiants et ne substituez pas silencieusement un autre espace. Si
plusieurs marques conviennent, demandez laquelle la personne souhaite utiliser.

Réutilisez une connexion existante saine. Sinon, exécutez
`npx -y sosoapi connect <platform>` (instagram, threads, facebook, youtube ou x)
ou donnez à la personne https://app.sosoapi.ai/connect. Elle effectue le
consentement fournisseur et vérifie le compte exact dans le navigateur. À son retour,
relisez les comptes et capacités de publication. Un callback de connexion ne
prouve pas l’autorisation de publier. Réutilisez le brouillon d’origine ; ne demandez pas à la
personne de copier un identifiant interne ou de recréer son contenu.

## 4. Terminer la tâche de publication d’origine

Utilisez la demande existante ou demandez ce que la personne souhaite promouvoir. N’inventez pas
de publication de test. Montrez le compte de destination exact, le contenu, les médias et
la date/heure locale avant le premier envoi. Confirmez le fuseau horaire s’il est
inconnu. Lisez les capacités actuelles du compte ; un compte Instagram personnel ou des autorisations
fournisseur manquantes peuvent nécessiter un type de compte compatible ou une reconnexion.

X accepte uniquement les textes originaux et liens ; laissez media vide. Les médias X, réponses,
citations, republications et fils ne sont pas pris en charge.

Pour les destinations acceptant les médias, enregistrez-les avant de programmer : pour un fichier local, utilisez sosoapi_upload_asset
dans les dossiers autorisés ; pour une URL externe, utilisez sosoapi_import_asset_url
et vérifiez sosoapi_get_asset_import_status avec include_asset=true jusqu’à ce que
l’importation bornée soit prête. asset.id prêt devient media.asset_id et
asset.asset_url devient media.url ; aucun appel get_asset distinct n’est nécessaire.
Gardez la même identité d’importation, respectez les consignes de nouvelle tentative et arrêtez en cas d’échec
final. Une requête réussie ne prouve pas que le décodage ou l’importation est terminé.
Si la progression se bloque, lisez sosoapi_job_status avec le job_id de cette importation avant
d’attendre à nouveau. Une tâche en attente peut déjà contenir une erreur d’exécution. Une erreur de
configuration de service nécessite une intervention opérateur, pas une autre importation, une nouvelle connexion
sociale ou une autorisation de la personne. Signalez le blocage sans prétendre
que l’image est prête.
Utilisez ensemble l’identifiant de ressource enregistré et l’URL média canonique renvoyés. Ne programmez jamais
l’URL externe d’origine ou une URL temporaire d’aperçu à leur place.
Réutilisez une ressource prête uniquement après avoir vérifié son espace et son identité.

Utilisez sosoapi_get_scheduled_post_eligibility lorsqu’un aperçu indicatif est utile ;
il est facultatif et ne remplace pas la validation canonique de création/exécution.
Utilisez les outils canoniques Scheduled Post
. Une publication correspond à une destination. Réutilisez la même idempotency_key pour réessayer
la même requête exacte ; un brouillon modifié est une nouvelle requête. Après une expiration,
lisez la publication existante avant d’agir. Ne renvoyez jamais aveuglément une
écriture fournisseur incertaine. Les modifications, annulations et nouvelles tentatives explicites utilisent la
version actuelle et l’éligibilité des actions définie par le serveur.

Le résultat doit distinguer :

- Programmée : acceptée pour l’heure indiquée ; pas encore publiée.
- En cours ou en réconciliation : résultat final non confirmé ; ne pas renvoyer.
- Publiée : un résultat final étayé par le fournisseur confirme la publication exacte ;
  renvoyez son lien public s’il est disponible.
- Échec ou intervention requise : indiquez les faits connus et la prochaine action autorisée ;
  reconnectez uniquement le compte concerné si la personne doit accorder l’accès à nouveau.

Pour plusieurs destinations, indiquez chacune séparément. N’annoncez pas toute la tâche comme
réussie si seules certaines plateformes ont réussi. Pour une programmation future, renvoyez
les identifiants et heures acceptées ; ne laissez pas la conversation attendre jusqu’à
l’échéance et ne créez pas de boucle d’interrogation. Au retour, relisez les mêmes publications.
La personne peut aussi revoir le résultat exact à
https://app.sosoapi.ai/scheduled-posts/<post-id>, avec l’identifiant réel renvoyé
par SosoAPI. Cette page nécessite sa propre connexion autorisée. Pour un environnement
personnalisé, utilisez plutôt l’origine d’application explicitement configurée.
Ne promettez pas de réveiller un assistant fermé ou d’envoyer une notification de réussite qui
n’a pas été configurée et vérifiée.

## Références

- Guide de démarrage pour les personnes : https://app.sosoapi.ai/start
- Guide produit : https://sosoapi.ai/fr/docs/quickstart
- Périmètre pris en charge : Instagram, Threads, Facebook Pages, YouTube et textes originaux
  et liens X. Les formats et autorisations varient selon le compte ; les autres plateformes ne deviennent pas
  disponibles simplement parce que la personne les demande.