Przewodnik konfiguracji MCP
Połącz AdaptlyPost z asystentem AI w niecałą minutę. Wklej adres URL, zaloguj się na żądanie i zacznij publikować.
Wymagania
Aktywne konto AdaptlyPost zarejestruj się
Co najmniej jedno połączone konto społecznościowe
Opcjonalnie: token API dla agentów bez interfejsu i klientów bez OAuth, dostępny w sekcji Zarządzanie > API i agenci AI
Konfiguracja dla Claude Code i Cursor
Dodaj to do ustawień MCP i zaloguj się, gdy otworzy się przeglądarka. Claude Code: ~/.claude/settings.json. Cursor: .cursor/mcp.json.
MCP config
{
"mcpServers": {
"adaptlypost": {
"type": "http",
"url": "https://mcp.adaptlypost.com/mcp"
}
}
}Claude Code CLI
claude mcp add --transport http adaptlypost https://mcp.adaptlypost.com/mcpAlbo użyj jednowierszowego polecenia Claude Code CLI. Przy pierwszym użyciu otworzy stronę logowania:
Alternatywa: klucz API
{
"mcpServers": {
"adaptlypost": {
"type": "http",
"url": "https://mcp.adaptlypost.com/mcp",
"headers": {
"Authorization": "Bearer adaptly_your_key"
}
}
}
}W przypadku agentów bez interfejsu lub klientów bez OAuth dodaj nagłówek Authorization z tokenem ze strony API i agenci AI. Klucze zaczynają się od adaptly_.
Konfiguracja dla Claude Desktop
Claude Desktop łączy się przez mostek mcp-remote, który otwiera stronę logowania. Dodaj to do pliku claude_desktop_config.json:
claude_desktop_config.json
{
"mcpServers": {
"adaptlypost": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.adaptlypost.com/mcp"]
}
}
}Konfiguracja dla innych klientów MCP
Każdy klient MCP obsługujący transport HTTP może połączyć się bezpośrednio.
Endpoint
https://mcp.adaptlypost.com/mcp
Uwierzytelnianie
Zaloguj się na żądanie (OAuth) lub wyślij Authorization: Bearer adaptly_your_key
Transport
HTTP (Streamable HTTP)
Bez nagłówka Bearer serwer odpowiada kodem 401 z nagłówkiem WWW-Authenticate, dzięki czemu klienci obsługujący OAuth sami otwierają stronę logowania.
W przypadku klientów obsługujących tylko transport stdio użyj mostka mcp-remote, jak w sekcji Claude Desktop.
Alternatywa: Agent Skill
W Claude Code, Cursor, Windsurf i Codex można też zainstalować AdaptlyPost jako skill agenta, bez konfiguracji MCP.
npx skills add adaptlypost/agentInstaluje plik SKILL.md i skrypt CLI, które uczą agenta obsługi API AdaptlyPost. Zobacz na GitHubie
Opis narzędzi
Serwer MCP udostępnia 80 narzędzi, a najważniejsze z nich wymieniono poniżej. AI wykrywa je automatycznie, wystarczy poprosić zwykłym językiem.
| Narzędzie | Opis | Główne parametry |
|---|---|---|
| list_workspaces | Wyświetla obszary robocze dostępne dla zalogowanego konta. Przekaż id jako workspaceId do dowolnego innego narzędzia, aby pracować w danym obszarze. | None |
| list_accounts | Wyświetla połączone konta społecznościowe z identyfikatorami, platformami, nazwami użytkowników i statusem. Konto oznaczone jako unauthorized trzeba połączyć ponownie, zanim będzie mogło publikować. | None |
| list_pinterest_boards | Wyświetla tablice konta Pinterest z id, nazwą, prywatnością i liczbą pinów. Przekaż id tablicy jako pinterestConfigs[].boardId. | accountId |
| list_wordpress_categories | Wyświetla kategorie witryny WordPress z id, nazwą i id kategorii nadrzędnej. Przekaż id jako wordpressConfigs[].categoryIds. | accountId |
| upload_media | Przesyła multimedia z adresów URL lub danych base64. Zwraca mediaUrls dla create_post. | urls?, files? |
| get_upload_urls | Pobiera wstępnie podpisane adresy URL do bezpośredniego przesyłania plików do magazynu. | files (fileName + mimeType) |
| open_upload_widget | Wyświetla pole przesyłania w ChatGPT lub Claude, aby użytkownik mógł dodać zdjęcia, filmy lub dokumenty ze swojego urządzenia. Po zakończeniu pole zwraca mediaUrls. | None |
| get_upload_ticket | Wywoływane przez pole przesyłania raz na plik. Ukryte przed AI. | None |
| create_post | Tworzy post na jedną lub więcej platform: publikacja od razu, zaplanowanie, zapis wersji roboczej lub powtarzanie codziennie, co tydzień, co miesiąc albo co rok. platformMedia pozwala wysłać inne multimedia na wybraną platformę. | platforms, contentType, timezone, text?, scheduledAt?, saveAsDraft?, recurrence?, mediaUrls?, mediaAltTexts?, platformMedia?, platformTexts?, *ConnectionIds, pageIds?, *Configs? |
| get_post | Pobiera pełne dane pojedynczego posta według ID. | id |
| list_posts | Wyświetla posty z opcjonalnymi filtrami platformy, statusu lub zakresu dat. | statuses?, platforms?, startDate?, endDate?, sortOrder?, limit?, offset? |
| update_post | Aktualizuje opis, termin, multimedia lub konfigurację platform zaplanowanego lub roboczego posta. | id, text?, platforms?, contentType?, scheduledAt?, timezone?, mediaUrls?, mediaAltTexts?, platformMedia?, platformTexts?, *ConnectionIds, *Configs? |
| delete_post | Usuwa post. Zaplanowany post nie zostanie opublikowany, a opublikowany pozostanie w sieciach. | id |
| unschedule_post | Zdejmuje zaplanowany post z kalendarza i zachowuje go jako wersję roboczą bez daty. | id |
| publish_draft | Publikuje wersję roboczą od razu lub planuje ją na później. | id, timezone, scheduledAt? |
| list_post_results | Sprawdza wyniki publikacji na poszczególnych platformach: sukces lub błąd ze szczegółami. | id |
| retry_failed_platforms | Ponawia publikację na platformach, na których się nie powiodła. | id, platformIds? |
| bulk_schedule_posts | Planuje wiele postów naraz ze wspólnymi platformami i identyfikatorami połączeń. | platforms, timezone, posts[], *ConnectionIds, pageIds?, *Configs? |
| list_recurring_posts | Wyświetla posty cykliczne (serie) ze statusem, harmonogramem i następną publikacją. | statuses?, limit?, offset? |
| get_recurring_post | Pobiera post cykliczny według ID, wraz z powodem wstrzymania i terminem następnej publikacji. | id |
| pause_recurring_post | Wstrzymuje serię i usuwa jej nadchodzący zaplanowany post. | id |
| resume_recurring_post | Wznawia wstrzymaną serię od najbliższego terminu. Pominięte terminy nie są nadrabiane. | id |
| delete_recurring_post | Kończy serię na stałe. Opublikowane już posty pozostają. | id |
| get_analytics_overview | Wyświetlenia, polubienia, komentarze, udostępnienia, obserwujący i wskaźnik zaangażowania w wybranym okresie, w porównaniu z poprzednim. | from, to, platforms? |
| get_analytics_timeseries | Te same wskaźniki w podziale na dni, tygodnie lub miesiące, do pytań o trendy. | from, to, platforms?, granularity? |
| get_platform_breakdown | Te same wskaźniki w podziale na platformy, wraz z danymi raportowanymi przez każdą z nich. | from, to |
| list_post_analytics | Wskaźniki poszczególnych postów z sortowaniem po dowolnym z nich. Najlepsze posty i pytania typu „jak poradził sobie ten post”. | from, to, platforms?, sortBy?, page?, limit? |
| get_analytics_sync_status | Kiedy każde konto było ostatnio synchronizowane i czy wymaga ponownego połączenia na potrzeby analityki. | None |
| trigger_analytics_sync | Odświeża analitykę od razu. Raz na 10 minut na obszar roboczy. | None |
| generate_caption | Pisze opis na podstawie polecenia, w limicie znaków wybranej platformy. Koszt: 2 kredyty AI. | prompt, platform? |
| refine_caption | Przepisuje istniejący opis według instrukcji, np. „skróć go”, lub kończy częściowo napisany. Koszt: 2 kredyty AI. | prompt, originalText, partialText?, platform? |
| generate_image | Uruchamia generowanie obrazu AI i od razu zwraca ID zadania. 2 kredyty AI za standard, 4 za premium, zwracane w razie niepowodzenia. | prompt, aspectRatio?, model?, quality?, sessionId?, referenceImages? |
| get_image_job | Sprawdza zadanie obrazu do momentu ukończenia, z publicznym adresem URL gotowym do użycia w poście, lub niepowodzenia. | jobId |
Zarządzanie dostępem
Zalogowani agenci tracą dostęp po usunięciu konektora w kliencie lub wylogowaniu. Tokeny API można w każdej chwili przeglądać i unieważniać na stronie API i agenci AI. Unieważnienie tokenu natychmiast odłącza każdego agenta, który z niego korzysta.
Gotowi na połączenie?
Wklej adres URL do ustawień MCP, zaloguj się raz i zacznij publikować z poziomu AI.