Serveur MCP

Qu'est-ce que le serveur MCP SocialGO ?

Le serveur MCP SocialGO expose le panel sous forme d'un ensemble d'outils pour agents IA via le Model Context Protocol. Une fois connecté, un assistant peut parcourir le catalogue de services, passer et suivre des commandes, demander des recharges et gérer le solde, sans aucun code de liaison personnalisé. C'est une fine couche de lecture et d'action posée sur la même API que celle utilisée par votre tableau de bord, de sorte que les agents restent dans les limites et les tarifs de votre compte.

Il fonctionne avec tout client compatible MCP, y compris Claude Desktop, Claude Code, Cursor et vos propres agents construits sur un SDK MCP.

Ajoutez-le à votre client

Le serveur est distribué sous forme du paquet @socialgo/mcp et s'exécute via stdio avec npx, donc il n'y a rien à installer ni à héberger soi-même. Ajoutez l'entrée suivante à la configuration de votre client MCP :

{
  "mcpServers": {
    "socialgo": {
      "command": "npx",
      "args": ["-y", "@socialgo/mcp"],
      "env": {
        "SOCIALGO_API_KEY": "your_api_key_here"
      }
    }
  }
}

Avec Claude Code, vous pouvez l'enregistrer en une seule commande depuis votre terminal :

claude mcp add socialgo -- npx @socialgo/mcp

Après l'avoir ajouté, n'oubliez pas de définir SOCIALGO_API_KEY dans l'environnement pour que la commande ci-dessus puisse la récupérer.

Authentification

Le serveur lit une seule variable d'environnement, SOCIALGO_API_KEY. Générez une clé depuis les paramètres de votre compte, gardez-la secrète et ne la commitez jamais dans le contrôle de version. Chaque appel d'outil est authentifié et autorisé avec cette clé, et les commandes sont facturées sur le solde du compte correspondant. Faites pivoter la clé depuis votre tableau de bord à tout moment pour révoquer l'accès.

Outils principaux

Le serveur conserve une surface d'outils petite et stable qui couvre tout le cycle de vie d'une commande :

• search_services — Trouvez des services par plateforme, type ou mot-clé, le point d'entrée de chaque workflow.
• get_service — Récupérez tous les détails d'un service : tarif, quantité min/max et options prises en charge.
• create_order — Passez une commande pour un service vers un lien ou un nom d'utilisateur cible.
• order_status — Vérifiez le statut en direct, la progression et la quantité restante d'une commande.
• balance — Consultez le solde actuel du compte et la devise.
• refill — Demandez une recharge sur une commande éligible passée en dessous de la quantité livrée.
• cancel — Annulez une commande encore annulable et récupérez les fonds restants.
• list_orders — Parcourez les commandes récentes avec leur statut actuel.
• add_funds — Créez une intention de rechargement pour ajouter du solde au compte.

La conception « rechercher puis agir »

Un panel SMM typique propose des milliers de services répartis sur des dizaines de plateformes. Enregistrer un outil par service inonderait la liste d'outils de l'agent, ferait exploser la fenêtre de contexte et rendrait le modèle plus lent et moins précis. SocialGO évite cela entièrement.

À la place, le catalogue se trouve derrière un unique outil de découverte. L'agent appelle d'abord search_services pour réduire des milliers d'options à une poignée de correspondances pertinentes, en inspecte une avec get_service, puis agit seulement ensuite avec create_order. Les mêmes neuf outils couvrent l'intégralité du catalogue, peu importe sa croissance. Ajouter de nouveaux services côté backend ne change jamais la surface d'outils que voit l'agent.

Un flux complet ressemble à ceci :

1. search_services({ query: "instagram followers" })
   → returns a short list of matching services with ids + rates

2. get_service({ id: "<id>" })
   → confirms rate, min/max and options before spending

3. create_order({ id: "<id>", link: "<target>", quantity: 1000 })
   → returns an order id

4. order_status({ id: "<order_id>" })
   → poll until completed

Cela maintient la liste d'outils minuscule et prévisible, permet au catalogue de monter en charge jusqu'à des milliers de services, et offre à l'agent une étape fiable de confirmation avant dépense à chaque fois.