---
sidebar:
  order: 4
title: MCP
description: >-
  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.

| Punkt końcowy | Cel |
| --- | --- |
| `https://influence.so/api/mcp` | Ogólne połączenie z produktem, w tym włączone narzędzia planowania, pracy z obrazami i wyszukiwania informacji. |
| `https://influence.so/api/mcp/claude` | Połączenie z Claude. Obejmuje przesyłanie multimediów, wersje robocze, przeglądy, planowanie publikacji, planowanie treści i Statystyki; pomija narzędzia generowania obrazów oraz `search`/`fetch`. |
| `https://docs.influence.so/mcp` | Wyszukiwanie i odczytywanie publicznej dokumentacji. Nie wymaga konta produktu; nie może uzyskać dostępu do danych obszaru roboczego ani publikować. |

## Połącz się i wykrywaj narzędzia [#connect-and-discover]

Użyj procesu OAuth Influence w kliencie lub klucza API o ograniczonych uprawnieniach, jeśli klient obsługuje uwierzytelnianie Bearer. Sekcja [Aplikacje i automatyzacje](https://influence.so/sign-in?next=%2Fapp%2Fsettings%2Faccount%23settings-developer) 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](/pl/developers/mcp-tools). 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 [#prepare-finished-content]

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](/pl/help/media).
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 [#confirmation-and-recovery]

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](/pl/help/ai-assistants#scheduling-allowance) 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](/pl/help/insights). 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.
