Publiez depuis vos outils avec l’API et le MCP d’Influence
L’API et les outils MCP d’Influence permettent d’enregistrer des brouillons, de vérifier les posts et de programmer leur publication après approbation. Vos outils peuvent accéder aux comptes connectés et aux résultats enregistrés.
Identifiants, approbation et état de publication
Limitez les droits du client
Approuvez l’action exacte de publication
Consulter l’état de publication
Consultez vos comptes connectés avec MCP
Cet exemple Node.js se connecte à Influence et affiche les comptes sociaux de votre espace de travail. Il lit leurs informations sans créer de brouillon ni publier de contenu.
1. Créez une clé avec un accès en lecture
Dans les paramètres, ouvrez Applications et automatisations → Outils de développement. Cochez Consulter les canaux connectés (integrations:read), décochez toutes les autres autorisations, puis créez la clé API. Enregistrez-la dans votre gestionnaire local de secrets ou dans la variable d’environnement INFLUENCE_API_TOKEN. La clé ne s’affiche qu’une fois ; ne la placez ni dans le code ni dans un chat.
Ouvrir les paramètres des clés API2. Exécutez l’exemple
Avec Node.js et npm installés, installez le SDK MCP dans votre projet. Enregistrez le code ci-dessous dans accounts.mjs, puis lancez node accounts.mjs dans un environnement où INFLUENCE_API_TOKEN est défini. Le SDK gère la connexion et l’initialisation MCP.
npm install @modelcontextprotocol/client@2.3.1accounts.mjs
import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
const token = process.env.INFLUENCE_API_TOKEN;
if (!token) throw new Error("Set INFLUENCE_API_TOKEN first.");
const client = new Client({ name: "influence-quickstart", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(
new URL("https://influence.so/api/mcp"),
{ requestInit: { headers: { Authorization: `Bearer ${token}` } } }
);
try {
await client.connect(transport);
const result = await client.callTool({
name: "accountList",
arguments: { limit: 20 }
});
console.log(JSON.stringify(result.structuredContent, null, 2));
if (result.isError) process.exitCode = 1;
} finally {
await client.close();
}3. Lisez la réponse
Exemple de réponse avec des noms et identifiants fictifs. Votre réponse indique votre espace de travail et les comptes sociaux qui y sont connectés.
{
"ok": true,
"output": {
"cursor": null,
"done": true,
"items": [
{
"connectionId": "account_example_01",
"eligible": true,
"name": "Example studio",
"platform": "bluesky",
"supportsImage": true,
"supportsText": true,
"supportsVideo": true
}
],
"workspaceId": "workspace_example_01",
"workspaceName": "Example workspace"
},
"toolName": "accountList"
}Comprendre le résultat
Des comptes sont renvoyés
connectionId identifie chaque compte. eligible et supportsText, supportsImage et supportsVideo décrivent ses capacités de publication actuelles ; vérifiez-les de nouveau avant de préparer une publication.
Aucun compte n’est renvoyé
ok: true avec items: [] et done: true indique une lecture réussie. Connectez un compte social dans l’espace indiqué par workspaceName, puis relancez l’exemple.
Plusieurs pages de résultats
Si done vaut false, rappelez accountList avec le cursor renvoyé et la même valeur de limit. Continuez jusqu’à ce que done vaille true ; la première page peut contenir moins de 20 comptes.
Accès refusé
Pour une réponse 401, vérifiez que la clé est encore valide et possède l’autorisation integrations:read. Une clé API sans cette autorisation peut aussi renvoyer 401. Une connexion OAuth peut renvoyer 403 insufficient_scope ; reconnectez-la et autorisez la lecture des comptes.
ChatGPT et Claude peuvent se connecter par autorisation dans le navigateur, sans clé. Suivez le guide de l’assistant, puis demandez-lui de lister vos comptes connectés. Cet exemple utilise l’endpoint MCP complet, https://influence.so/api/mcp ; le connecteur de base de Claude possède sa propre configuration.
Outils disponibles et autorisations nécessaires
GET /api/v1/tools liste les outils accessibles avec votre clé. Cette requête affiche les autorisations et les exigences de confirmation pour accountList. La création de brouillons nécessite des autorisations d’écriture supplémentaires.
HTTP API
GET /api/v1/toolsVotre application lit le catalogue et appelle les outils disponibles.
MCP
tools/listUn assistant compatible découvre les outils et suit le même parcours de validation.
1. Préparez un brouillon
Utilisez campaignDraftSave avec les comptes et fichiers de votre espace. Conservez la version et l’identifiant de la requête pour retrouver le résultat si la réponse se perd. L’enregistrement d’un brouillon modifie les données et nécessite une confirmation côté serveur.
2. Préparez la vérification
Utilisez campaignReview pour la version enregistrée et l’action demandée. Affichez les comptes, le contenu, les fichiers, les paramètres, l’heure et la date d’expiration. Cette vérification n’approuve ni n’exécute l’action.
3. Exécutez l’action approuvée
campaignReviewExecute exige l’approbation de cette vérification précise. Pour le texte, une nouvelle réponse doit confirmer la vérification complète ; les fichiers nécessitent une approbation visuelle. L’action passe par le planificateur persistant, sans appel direct au fournisseur.
4. Lisez le résultat avant de réessayer
Consultez le statut de chaque destination et son lien de publication vérifié lorsqu’il est disponible. Un envoi incertain reste À vérifier jusqu’à ce que le résultat soit établi. Ne créez pas un nouveau post pour récupérer une réponse manquante.
Choisissez la connexion adaptée à votre outil
| Connexion | Usage | Accès |
|---|---|---|
| HTTP API | Votre application lit le catalogue et appelle les outils disponibles. | Utilisez un jeton bearer à permissions limitées depuis une variable d’environnement. |
| MCP | Un assistant compatible découvre les outils et suit le même parcours de validation. | Suivez la configuration de votre assistant dans les paramètres d’Influence. La disponibilité dépend du client et des droits accordés. |
Requête du catalogue
curl --fail-with-body 'https://influence.so/api/v1/tools' \
--header "Authorization: Bearer $INFLUENCE_API_TOKEN" \
| jq '{tools: [.tools[] | select(.name == "accountList") | {name, scopes, confirmation, mutability}]}'Exemple de champs du catalogue
{
"tools": [
{
"confirmation": "none",
"mutability": "read",
"name": "accountList",
"scopes": [
"integrations:read"
]
}
]
}Ces champs d’exemple proviennent des définitions d’outils. Le catalogue actuel, les autorisations liées à vos identifiants et les comptes connectés déterminent les opérations disponibles.

Intégrez la publication à vos outils
Publier depuis vos outils de contenu
Préparez des brouillons à partir d’un article, journal des modifications ou annonce communautaire dans vos outils. Présentez comptes, contenu et heure exacts pour vérification avant de demander la programmation à Influence.
Retrouver une demande après une réponse perdue
Conservez la demande originale et la clé d’idempotence, puis consultez le résultat enregistré. Un envoi incertain reste À vérifier jusqu’à confirmation du résultat ; ne créez pas de publication de remplacement.
Rédigez vos brouillons avec Influence IQ
Donnez à Influence IQ un article, des notes de projet ou des nouvelles de la communauté avec votre Charte de marque enregistrée pour des brouillons modifiables. Les outils IA autorisés disponibles utilisent des crédits IQ et conservent leurs exigences de confirmation.
Donnez à Influence IQ vos notes et votre charte de marque enregistrée pour obtenir des brouillons et des propositions de dates. La rédaction et la génération d’images utilisent des crédits IQ. Vérifiez le coût proposé avant de créer une image, puis le contenu final avant publication.
Découvrir Influence IQCommencez avec un assistant IA
Avec une connexion Influence compatible, vous pouvez planifier des campagnes et modifier des brouillons dans ChatGPT ou Claude. Demandez à votre assistant d’importer les images et vidéos auxquelles il a accès, ou de réutiliser les médias prêts dans Influence. S’il ne peut pas accéder au fichier, importez-le d’abord dans Influence. Vérifiez les comptes, le texte, les médias, les réglages et l’heure exacts. Après avoir consulté l’ensemble, approuvez dans une carte compatible du chat ou par un nouveau message d’accord explicite. Pour TikTok Direct, indiquez vos choix de publication et votre consentement dans le chat, puis approuvez la version mise à jour. La carte de validation est facultative. Consultez la configuration et l’état de la connexion dans Paramètres.
Publiez sur vos comptes connectés
Choisissez les comptes disponibles dans votre espace de travail. Adaptez le texte et les médias pris en charge pour chaque destination, puis vérifiez les publications avant de les publier.
Préparez vos prochaines publications
Ajoutez vos comptes, préparez les publications et choisissez les dates. Vérifiez le contenu avant de le programmer.
CommencerQuestions fréquentes
- Que peuvent faire les outils API et MCP ?
- Les outils disponibles permettent de consulter les comptes, de gérer les brouillons et les médias compatibles, de vérifier les posts, de modifier les dates et de consulter l’état de publication. Les fonctions activées et vos autorisations déterminent les outils utilisables.
- Les appels API ou MCP évitent-ils l’approbation ?
- Non. Le serveur applique les exigences de confirmation de chaque outil. Pour publier, vous devez approuver la version actuelle présentée pour vérification. Avant de programmer l’envoi, Influence contrôle l’espace de travail, les droits, les comptes et le contenu.
- Quels médias les assistants acceptent-ils ?
- Demandez à votre assistant d’importer les images et vidéos auxquelles il a accès, ou de réutiliser les médias prêts dans Influence. S’il ne peut pas accéder au fichier, importez-le d’abord dans Influence. Vérifiez les comptes, le texte, les médias, les réglages et l’heure exacts. Après avoir consulté l’ensemble, approuvez dans une carte compatible du chat ou par un nouveau message d’accord explicite. Pour TikTok Direct, indiquez vos choix de publication et votre consentement dans le chat, puis approuvez la version mise à jour. La carte de validation est facultative.
- Comment gérer une réponse perdue ou un envoi incertain ?
- Récupérez le résultat original et vérifiez l’état. Ne répétez pas un envoi ambigu. L’état À vérifier reste non résolu jusqu’à ce qu’une vérification confirme ce qui s’est passé.
- MCP garantit-il que tous les assistants fonctionnent ?
- Non. Connectez-vous, puis ouvrez Paramètres → Applications et automatisations → Connectez votre assistant pour consulter les instructions et l’état actuel de la connexion.
- Une intégration peut-elle modifier un contenu programmé ou publié ?
- Un post programmé peut revenir à l’état de brouillon pour être modifié et revérifié si l’envoi n’a pas commencé et qu’aucun envoi ne reste incertain. L’assistant ne peut ni modifier ni supprimer un contenu déjà publié sur un réseau.