Spring til indhold
Influence
Esc
↑↓navigér↵åbn⌘Jforhåndsvis
På denne side

MCP

Forbind AI-klienter til Influence-konti, medier, gennemgange, planlægning af udgivelse og tilgængelig Indsigt.

Vælg endpointet til opgaven. Produktværktøjer kræver et autoriseret Influence-arbejdsområde. Dokumentationsserveren læser kun offentlige vejledninger.

Endpoint Formål
https://influence.so/api/mcp Generel produktforbindelse, herunder aktiverede værktøjer til planlægning, billeder og research.
https://influence.so/api/mcp/claude Claude-forbindelse. Omfatter upload af medier, kladder, gennemgange, planlægning af udgivelse, indholdsplanlægning og Indsigt. Udelader billedgenereringsværktøjer og search/fetch.
https://docs.influence.so/mcp Søgning og læsning i offentlig dokumentation. Kræver ingen produktkonto og kan ikke tilgå arbejdsområdets data eller udgive.

Opret forbindelse, og find værktøjer

Brug klientens Influence-OAuth-forløb eller en API-nøgle med afgrænsede tilladelser, hvor klienten understøtter bearer-autentificering. Apps og automatiseringer viser opsætningen til den enkelte klient. Opbevar API-nøgler i klientens hemmelige miljøvariabler.

Læs profileGet for at kontrollere Influence-e-mailadressen og arbejdsområdet (nickname). Læs derefter connectionStatusGet for scopes og kvoten for AI-planlagt udgivelse. AI-klientens eget login kan bruge en anden e-mailadresse. Vælg den tilsigtede Influence-identitet under autorisationen.

Fornyelse af OAuth kræver udtrykkeligt samtykke til offline_access. For en ny tilpasset ChatGPT-forbindelse angiver opsætningsvejledningen også dette Base-scope. Opdatering af værktøjer tilføjer ikke tilladelser og opgraderer ikke en gammel forbindelses Base-scopes.

Brug tools/list og MCP-værktøjsreferencen. Listen kan vise værktøjer, hvis scopes endnu ikke er tildelt. Hvert kald håndhæver stadig tilladelserne. Aktiverede funktioner og klientunderstøttelse påvirker tilgængeligheden. Det generelle endpoint og Claude-endpointet er forskellige. Download af en skill eller et plugin beviser ikke, at den installerede klient har indlæst værktøjerne.

Forbered færdigt indhold

  1. Læs accountList og derefter integrationSchema for hver valgt kontos krævede indstillinger og mediegrænser. Brug de navngivne opslagsværktøjer til udbyderen for opslagstavler, kanaler og lignende destinationer.
  2. Importér en tilgængelig HTTPS-fil med mediaImport ved hjælp af url og eventuelt name. En reel fil fra værtsmiljøet bruger det særskilte file-objekt. Opfind ikke fil-ID’er. Brug værktøjerne til multipart-upload eller den eksisterende SDK/CLI-hjælper til lokale filer. Mediegrænser og krav om, at mediet er klar gælder.
  3. Brug campaignScheduleBatchReview til 1–10 færdige opslag med planlagt udgivelse, med en stabil itemKey, draft og scheduledFor pr. element. Det gemmer kladder og afventende gennemgange samlet med tekst/medier pr. destination og højst 50 leveringer. Brug campaignDraftSave til arbejde, der kun omfatter kladder, eller til redigeringer. campaignReview forbereder den tilsigtede handling for en gemt kampagne.
  4. Vis hele den gemte gennemgang. Et indlæst kort, der vises, leverer denne præsentation. Uden et sådant kort skal du vise de præcise konti, tekst, medieforhåndsvisninger eller links, indstillinger, planlagt tidspunkt og tidszone. Læs campaignReviewGet, når gennemgangen mangler, er forældet eller usikker.
  5. Indhent en ny, udtrykkelig godkendelse fra et menneske før udførelse. Et understøttet kort har sin egen godkendelsesknap. For kvalificerede opslag på sociale medier indsendes godkendelsen fra chatten via campaignReviewExecute eller campaignScheduleBatchExecute. Modellen må ikke kalde den private UI-handling campaignReviewApprove.

TikTok Direct understøtter almindelig chat. Læs tiktokCreatorInfoGet, og stil derefter 1 samlet spørgsmål om uafklarede valg for synlighed, interaktioner, promovering og relevante AI-/musikvalg. Vis den relevante samtykketekst og de tilhørende links. Udled ikke samtykke, og aktivér ikke begrænsede interaktioner. Gem personens samlede valg med campaignReview ved hjælp af reviewId og tiktokSettings-elementer med connectionId og settings. Dette returnerer en ny afventende gennemgang, ikke en godkendelse. Vis netop denne gennemgang, og vent på en ny, udtrykkelig godkendelse før udførelse. Et understøttet gennemgangskort er fortsat valgfrit. Udgivelse via TikTok-indbakken afsluttes i TikTok.

TikTok-samtykke hører til den præcise gennemgang. Samtykke, der er gemt på en kladde, fuldfører ikke dette trin. Når gennemgangens valg gemmes, oprettes en ny kladdeversion, og den forrige gennemgang bliver forældet, selv når indstillingerne er uændrede.

Bekræftelse og genopretning

Værktøjer, der er markeret som krævende bekræftelse, forbereder først uden _confirmationCapability eller _idempotencyKey. Bekræft identisk forretningsinput med den returnerede capability og en stabil idempotensnøgle, som er genereret af den kaldende klient. Denne udveksling gemmer eller udfører værktøjets angivne handling. Den er adskilt fra et menneskes godkendelse til udgivelse. Respektér værtsmiljøets anmodninger om tilladelse.

mediaUploadPart, mediaUploadComplete og mediaUploadAbort fortsætter en autoriseret upload direkte. Overfør filens bytes til de returnerede lager-URL’er, ikke i værktøjets JSON. Læs uploadstatus efter en afbrydelse, og fortsæt med samme fil og clientKey.

Uploadens expiresAt er dens aktuelle frist for overførsel eller behandling: først 24 timer, derefter 15 minutter, når fuldførelsen starter behandlingen. Medier, der er klar til brug, udløber ikke ved denne frist. Genbrug deres assetId fra mediebiblioteket.

Behold værdier til bekræftelse og nye forsøg efter et usikkert resultat. Læs den gemte gennemgang eller kampagne, før du prøver en udgivelseshandling igen. Antag aldrig, at en timeout betyder, at intet skete. En ændret eller udløbet gennemgang kræver en ny gennemgang og godkendelse.

Grænser for AI-planlagt udgivelse gælder på tværs af MCP-klienter og Influence IQ. Almindelig HTTP/CLI-automatisering og manuel planlægning af udgivelse på nettet er undtaget. Dækning og opdatering af Indsigt er beskrevet under Indsigt. Valgfrie eventabonnementer kræver særskilt understøttelse i et aktiveret værtsmiljø. De er ikke et generelt løfte om baggrundsnotifikationer i alle klienter.