Connecter un agent

Un point d'entrée unique auquel votre client agent parle. Il peut lire vos marques et vos canaux, générer de la vidéo et du texte, envoyer des fichiers, programmer et publier, puis relire les résultats.

Il ne peut ni connecter un réseau social ni changer votre offre. Ce qu'il peut dépenser est borné par ses portées, le plafond mensuel de crédits de son jeton, et des clés d'idempotence qui empêchent un nouvel essai de payer deux fois. Connecter un canal passe par une connexion navigateur, donc cela reste dans l'application.

Créez un jeton d'accès personnel dans vos réglages. Le secret n'est montré qu'une fois et ne fonctionne que sur ce point d'entrée.

• Les portées décident de ce que le jeton peut faire — lecture seule, plus génération pour tout ce qui consomme des crédits, plus publication pour publier.
• Limitez-le à une marque et il ne verra que les canaux, les générations, les publications et les textes de cette marque. Le portefeuille de crédits, les fichiers envoyés, les acteurs et les produits restent partagés dans tout le compte.
• Fixez un plafond mensuel de crédits et le jeton n'engage plus aucun appel payant une fois que la dépense du mois l'atteint. Une écriture de texte déjà lancée se règle à son coût réel, qui peut le dépasser un peu.

1POST https://www.socialfaktory.com/mcp

Streamable HTTP, version de protocole 2025-06-18, authentification bearer dans l'en-tête Authorization. Aucun identifiant de session à transporter : le jeton est la session. Un GET répond 405.

Claude Desktop lance des serveurs locaux depuis son fichier de configuration, cette entrée lance donc mcp-remote via npx comme pont vers le point d'entrée, et Node.js doit être installé. claude.ai et Cowork n'y accèdent que si un administrateur de l'organisation l'ajoute comme connecteur avec le jeton en en-tête de requête, une fonction bêta côté Anthropic qui partage le jeton dans toute l'organisation.

1{
2  "mcpServers": {
3    "socialfaktory": {
4      "command": "npx",
5      "args": ["-y", "mcp-remote", "https://www.socialfaktory.com/mcp", "--header", "Authorization:${SOCIALFAKTORY_AUTH}"],
6      "env": { "SOCIALFAKTORY_AUTH": "Bearer sfp_…" }
7    }
8  }
9}

Envoyez du JSON-RPC 2.0 en POST. Acceptez à la fois le JSON et le type event-stream, et indiquez la version du protocole à chaque requête.

1POST https://www.socialfaktory.com/mcp
2Authorization: Bearer sfp_…
3Content-Type: application/json
4Accept: application/json, text/event-stream
5MCP-Protocol-Version: 2025-06-18
6
7{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }

Chaque outil indique la portée dont il a besoin. Un jeton sans cette portée est refusé avant que l'outil ne s'exécute. quote_generation est une vérification de prix facultative pour une vidéo, et generate_text réserve quelques crédits d'avance puis règle ce que la rédaction a réellement consommé.

Passez cet argument à chaque appel qui dépense ou publie. Un rejeu dans les 24 heures renvoie le résultat d'origine, marqué comme rejoué, au lieu de refaire le travail.

• 120 appels par minute et par jeton, et 300 requêtes toutes les 5 minutes par adresse.
• Cloner une vidéo depuis un lien, et générer des images fixes ou des carrousels, ne sont pas encore accessibles à un agent.