MCP

Collega i client IA agli account, ai contenuti multimediali, alle revisioni, alla programmazione e alle statistiche disponibili di Influence.

Scegli l’endpoint in base al compito. Gli strumenti del prodotto richiedono uno spazio di lavoro Influence autorizzato; il server della documentazione legge soltanto le guide pubbliche.

Collegati e individua gli strumenti

Usa il flusso OAuth di Influence del client oppure una chiave API con ambiti di autorizzazione limitati, se il client supporta l’autenticazione Bearer. App e automazioni fornisce la configurazione specifica per client. Conserva le chiavi API nell’ambiente segreto del client.

Leggi profileGet per verificare l’email e lo spazio di lavoro Influence (nickname), poi connectionStatusGet per gli ambiti di autorizzazione e la quota di programmazione con IA. L’accesso del client IA può usare un’email diversa. Durante l’autorizzazione, seleziona l’identità Influence desiderata.

Il rinnovo OAuth richiede il consenso esplicito a offline_access. Per un nuovo collegamento personalizzato di ChatGPT, le istruzioni di configurazione specificano anche quell’ambito di autorizzazione di base. Aggiornare gli strumenti non aggiunge autorizzazioni né aggiorna gli ambiti di autorizzazione di base di un vecchio collegamento.

Usa tools/list e il riferimento degli strumenti MCP. Il rilevamento può mostrare strumenti i cui ambiti di autorizzazione non sono ancora stati concessi; ogni chiamata applica comunque le autorizzazioni. Le funzionalità abilitate e il supporto del client influiscono sulla disponibilità. Gli endpoint generale e Claude sono diversi; scaricare una skill o un plugin non dimostra che il client installato ne abbia caricato gli strumenti.

Prepara i contenuti finiti

1. Leggi accountList, poi integrationSchema per le impostazioni obbligatorie e i limiti multimediali di ogni account selezionato. Usa gli strumenti di ricerca specifici del fornitore per bacheche, canali e destinazioni simili.
2. Importa un file HTTPS accessibile con mediaImport, usando url e l’eventuale name. Un vero file dell’host usa l’oggetto separato file; non inventare ID di file. Per i file locali, usa gli strumenti di caricamento multipart o la funzione SDK/CLI esistente. Rispetta i limiti multimediali e verifica che i file siano pronti.
3. Per 1–10 post finiti da programmare, usa campaignScheduleBatchReview con un itemKey stabile e draft e scheduledFor per ogni elemento. Salva insieme bozze e revisioni in attesa, con testo e contenuti multimediali per ogni destinazione e un massimo di 50 invii alle destinazioni. Per lavorare soltanto sulle bozze o modificarle, usa campaignDraftSave; campaignReview prepara l’azione prevista per una campagna salvata.
4. Presenta la revisione salvata completa. Una scheda caricata e visualizzata presenta già questi dettagli; senza una scheda, mostra gli account esatti, il testo, le anteprime o i link dei contenuti multimediali, le impostazioni, l’orario programmato e il fuso orario. Leggi campaignReviewGet se la revisione manca, è obsoleta o incerta.
5. Ottieni una nuova approvazione umana esplicita prima dell’esecuzione. Una scheda supportata ha il proprio pulsante di approvazione. Per i post social idonei, l’approvazione in chat viene inviata tramite campaignReviewExecute o campaignScheduleBatchExecute. Il modello non deve chiamare l’azione UI privata campaignReviewApprove.

TikTok Direct supporta il flusso in chat. Leggi tiktokCreatorInfoGet, poi poni 1 domanda che raggruppi le scelte ancora irrisolte su visibilità, interazioni, promozione e, dove applicabili, IA e musica. Mostra il testo di consenso e i link applicabili; non dedurre il consenso e non abilitare interazioni soggette a restrizioni. Salva le scelte complete della persona con campaignReview, usando reviewId e voci tiktokSettings che contengono connectionId e settings. Questo restituisce una nuova revisione in attesa, non un’approvazione. Presenta quella revisione esatta e attendi una nuova approvazione esplicita prima dell’esecuzione. Una scheda di revisione supportata resta facoltativa. La pubblicazione tramite la casella di posta TikTok si completa in TikTok.

Il consenso TikTok riguarda la revisione esatta; il consenso salvato su una bozza non completa questo passaggio. Salvare le scelte della revisione crea una nuova versione della bozza e rende obsoleta la revisione precedente, anche se le impostazioni sono invariate.

Conferma e recupero

Gli strumenti indicati come soggetti a conferma vengono prima preparati senza _confirmationCapability o _idempotencyKey. Conferma l’input operativo identico con la capability restituita e una chiave di idempotenza stabile generata dal chiamante. Questo scambio salva o esegue l’azione dichiarata dallo strumento; è separato dall’approvazione umana della pubblicazione. Rispetta le richieste di autorizzazione dell’host.

mediaUploadPart, mediaUploadComplete e mediaUploadAbort proseguono direttamente un caricamento autorizzato. Trasferisci i byte del file agli URL di archiviazione restituiti, non nel JSON dello strumento. Dopo un’interruzione, leggi lo stato del caricamento e riprendi con lo stesso file e lo stesso clientKey.

L’expiresAt di un caricamento è la sua scadenza attuale di trasferimento o elaborazione: inizialmente 24 ore, poi 15 minuti dopo che il completamento avvia l’elaborazione. I contenuti multimediali pronti non scadono con questo termine; riutilizza il loro assetId dalla raccolta multimediale.

Conserva i valori di conferma e nuovo tentativo dopo un esito incerto. Leggi la revisione o la campagna salvata prima di riprovare un’azione di pubblicazione; non presumere mai che un timeout significhi che non è successo nulla. Una revisione modificata o scaduta richiede una nuova revisione e approvazione.

I limiti di programmazione con IA si applicano ai client MCP e a Influence IQ. L’automazione ordinaria HTTP/CLI e la programmazione manuale sul web sono escluse. La copertura e l’aggiornamento delle statistiche sono descritti in Statistiche. Le iscrizioni facoltative agli eventi richiedono un supporto separato dell’host abilitato; non sono una promessa generale di notifiche in background in ogni client.