MCP

Połącz klientów AI z kontami, multimediami, przeglądami, planowaniem publikacji i dostępnymi Statystykami w Influence.

Wybierz punkt końcowy odpowiedni do zadania. Narzędzia produktu wymagają autoryzowanego obszaru roboczego Influence; serwer dokumentacji odczytuje tylko publiczne przewodniki.

Połącz się i wykrywaj narzędzia

Użyj procesu OAuth Influence w kliencie lub klucza API o ograniczonych uprawnieniach, jeśli klient obsługuje uwierzytelnianie Bearer. Sekcja Aplikacje i automatyzacje zawiera konfigurację właściwą dla klienta. Przechowuj klucze API w środowisku klienta przeznaczonym na sekrety.

Odczytaj profileGet, aby sprawdzić adres e-mail Influence i obszar roboczy (nickname), a następnie connectionStatusGet, aby sprawdzić zakresy uprawnień i limit planowania publikacji przez AI. Logowanie do samego klienta AI może używać innego adresu e-mail. Podczas autoryzacji wybierz właściwą tożsamość Influence.

Odnawianie OAuth wymaga wyraźnej zgody na offline_access. W przypadku nowego niestandardowego połączenia ChatGPT instrukcje konfiguracji również wskazują ten zakres Base. Odświeżenie narzędzi nie dodaje uprawnień ani nie rozszerza zakresów Base starego połączenia.

Korzystaj z tools/list i dokumentacji narzędzi MCP. Wykrywanie może udostępniać narzędzia, dla których nie przyznano jeszcze zakresów uprawnień; każde wywołanie nadal sprawdza wymagane uprawnienia. Włączone funkcje i obsługa przez klienta wpływają na dostępność. Ogólny punkt końcowy i punkt dla Claude różnią się; pobranie umiejętności lub wtyczki nie dowodzi, że zainstalowany klient wczytał jej narzędzia.

Przygotuj gotowe treści

1. Odczytaj accountList, a następnie integrationSchema, aby poznać wymagane ustawienia i limity multimediów dla każdego wybranego konta. Używaj wskazanych narzędzi dostawcy do wyszukiwania tablic, kanałów i podobnych miejsc docelowych.
2. Zaimportuj dostępny plik HTTPS za pomocą mediaImport, używając url i opcjonalnego name. Rzeczywisty plik udostępniany przez hosta używa odrębnego obiektu file; nie wymyślaj identyfikatorów plików. Dla plików lokalnych używaj narzędzi przesyłania wieloczęściowego lub istniejącej funkcji pomocniczej SDK/CLI. Obowiązują limity i gotowość multimediów.
3. Dla 1–10 gotowych postów do zaplanowania użyj campaignScheduleBatchReview ze stałym itemKey, draft i scheduledFor dla każdej pozycji. Zapisuje ono razem wersje robocze i oczekujące przeglądy, z tekstem i multimediami dla poszczególnych miejsc docelowych oraz maksymalnie 50 dostarczeniami. Do pracy tylko nad wersjami roboczymi lub ich edycji użyj campaignDraftSave; campaignReview przygotowuje zamierzone działanie dla zapisanej kampanii.
4. Przedstaw kompletny zapisany przegląd. Pokazana, wczytana karta zapewnia taką prezentację; bez niej pokaż dokładne konta, tekst, podglądy multimediów lub linki do nich, ustawienia, zaplanowany czas i strefę czasową. Odczytaj campaignReviewGet, gdy przeglądu brakuje, jest nieaktualny lub jego stan jest niepewny.
5. Uzyskaj nowe, wyraźne zatwierdzenie przez człowieka przed wykonaniem działania. Obsługiwana karta ma własny przycisk zatwierdzania. Dla kwalifikujących się postów społecznościowych zatwierdzenie z czatu jest przesyłane przez campaignReviewExecute lub campaignScheduleBatchExecute. Model nie może wywoływać prywatnego działania interfejsu campaignReviewApprove.

TikTok Direct obsługuje zwykły czat. Odczytaj tiktokCreatorInfoGet, a następnie zadaj jedno zbiorcze pytanie o nierozstrzygnięte wybory widoczności, interakcji, promocji oraz mające zastosowanie ustawienia AI i muzyki. Pokaż odpowiednią treść zgody i linki; nie domyślaj się zgody ani nie włączaj ograniczonych interakcji. Zapisz komplet wyborów osoby za pomocą campaignReview, używając reviewId i wpisów tiktokSettings zawierających connectionId oraz settings. Zwraca to nowy oczekujący przegląd, a nie zatwierdzenie. Przedstaw dokładnie ten przegląd i poczekaj na nowe, wyraźne zatwierdzenie przed wykonaniem działania. Obsługiwana karta weryfikacji pozostaje opcjonalna. Publikowanie przez skrzynkę odbiorczą TikTok kończy się w TikTok.

Zgoda TikTok dotyczy konkretnego przeglądu; zgoda zapisana w wersji roboczej nie kończy tego kroku. Zapisanie wyborów w przeglądzie tworzy nową wersję roboczą i sprawia, że poprzedni przegląd staje się nieaktualny, nawet gdy ustawienia się nie zmieniły.

Potwierdzenie i odzyskiwanie po błędach

Narzędzia oznaczone jako wymagające potwierdzenia najpierw przygotowują działanie bez _confirmationCapability ani _idempotencyKey. Potwierdź identyczne dane wejściowe operacji ze zwróconą wartością confirmationCapability i stałym kluczem idempotencji wygenerowanym przez wywołującego. Ta wymiana zapisuje lub wykonuje opisane działanie narzędzia; jest oddzielna od zatwierdzenia publikacji przez człowieka. Respektuj prośby hosta o nadanie uprawnień.

mediaUploadPart, mediaUploadComplete i mediaUploadAbort bezpośrednio kontynuują autoryzowane przesyłanie. Przesyłaj bajty pliku pod zwrócone adresy URL magazynu, a nie w JSON narzędzia. Po przerwaniu odczytaj status przesyłania i wznów ten sam plik z tym samym clientKey.

expiresAt przesyłania oznacza jego aktualny termin transferu lub przetwarzania: początkowo 24 godziny, a po zakończeniu przesyłania i rozpoczęciu przetwarzania — 15 minut. Gotowe multimedia nie wygasają z tym terminem; używaj ponownie ich assetId z biblioteki multimediów.

Zachowuj wartości potwierdzenia i ponowienia po niepewnym wyniku. Przeczytaj zapisany przegląd lub kampanię przed ponowieniem działania publikującego; nigdy nie zakładaj, że przekroczenie czasu oczekiwania oznacza, że nic się nie wydarzyło. Zmieniony lub wygasły przegląd wymaga nowego przeglądu i zatwierdzenia.

Limity planowania publikacji przez AI obowiązują łącznie klientów MCP i Influence IQ. Zwykła automatyzacja przez HTTP/CLI i ręczne planowanie w aplikacji internetowej są wyłączone z tego limitu. Zakres Statystyk i sposób ich odświeżania opisano w Statystykach. Opcjonalne subskrypcje zdarzeń wymagają odrębnej obsługi włączonej po stronie hosta; nie są ogólną obietnicą powiadomień w tle w każdym kliencie.