--- sidebar: order: 4 title: MCP description: >- 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. | Endpoint | Scopo | | --- | --- | | `https://influence.so/api/mcp` | Collegamento generale al prodotto, inclusi gli strumenti di pianificazione, immagini e ricerca abilitati. | | `https://influence.so/api/mcp/claude` | Collegamento per Claude. Include caricamento di contenuti multimediali, bozze, revisioni, programmazione, pianificazione e statistiche; esclude gli strumenti di generazione di immagini e `search`/`fetch`. | | `https://docs.influence.so/mcp` | Ricerca e lettura della documentazione pubblica. Non serve un account del prodotto; non può accedere ai dati dello spazio di lavoro né pubblicare. | ## Collegati e individua gli strumenti [#connect-and-discover] 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](https://influence.so/sign-in?next=%2Fapp%2Fsettings%2Faccount%23settings-developer) 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](/it/developers/mcp-tools). 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 [#prepare-finished-content] 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](/it/help/media). 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 [#confirmation-and-recovery] 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](/it/help/ai-assistants#scheduling-allowance) 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](/it/help/insights). Le iscrizioni facoltative agli eventi richiedono un supporto separato dell’host abilitato; non sono una promessa generale di notifiche in background in ogni client.