Daj zespołowi agentów CrewAI narzędzia do Instagrama, TikToka i WhatsAppa
Zespół agentów CrewAI otrzymuje narzędzia do Instagrama, TikToka, WhatsAppa i kolejnych kanałów, gdy lista mcps każdego agenta zawiera MCPServerHTTP dla https://easycoexistence.com/api/mcp z tokenem dostępu OAuth easyCoexistence w nagłówku Authorization. Klient MCP CrewAI wysyła nagłówki zamiast przeprowadzać logowanie, więc zespół odświeża token przy każdym kickoffie, a własne narzędzia mogą zamiast tego skorzystać z API postów z kluczem.
Opcjonalny słownik nagłówków HTTP w MCPServerHTTP, w którym dokumentacja CrewAI przekazuje token bearer w nagłówku Authorization.
Listy dozwolonych i zablokowanych narzędzi serwera MCP w CrewAI, importowane z crewai.mcp.filters.
Domyślny czas oczekiwania CrewAI na połączenie z serwerem MCP; serwer, którego nie da się osiągnąć, zostaje zapisany jako ostrzeżenie, a agent zachowuje pozostałe narzędzia.
Jak długo żyje token dostępu MCP easyCoexistence; token odświeżania, ważny przez 60 dni, wydaje nową parę.
Z jakim wyprzedzeniem API postów easyCoexistence planuje post, od 1 minuty, kopiując media w chwili dodania do kolejki.
Jak agent CrewAI ładuje narzędzia easyCoexistence?
Przez pole mcps, z jednym MCPServerHTTP na agenta. Łączy się przez Streamable HTTP, domyślny sposób CrewAI dla tej klasy, i wysyła nagłówki, które podasz, tu nagłówek Authorization z tokenem dostępu easyCoexistence. Statyczny filtr narzędzi, utworzony przez create_static_tool_filter, daje każdemu agentowi tylko narzędzia potrzebne jego zadaniu, a cache_tools_list zachowuje listę po pierwszym połączeniu. CrewAI łączy się na żądanie i jeśli serwera nie da się osiągnąć, zapisuje ostrzeżenie i pozwala agentowi działać dalej z pozostałymi narzędziami, więc przy pierwszym uruchomieniu sprawdź log. Token dostępu pochodzi z pomocnika z następnej sekcji.
from crewai import Agent, Crew, Task
from crewai.mcp import MCPServerHTTP
from crewai.mcp.filters import create_static_tool_filter
from easycoexistence_token import fresh_token
TOKEN = fresh_token() # one per kickoff: an access token lasts an hour
def easycoexistence(*tools: str) -> MCPServerHTTP:
return MCPServerHTTP(
url="https://easycoexistence.com/api/mcp",
headers={"Authorization": f"Bearer {TOKEN}"},
streamable=True,
cache_tools_list=True,
tool_filter=create_static_tool_filter(allowed_tool_names=list(tools)),
)
analyst = Agent(
role="Social analyst",
goal="Find which of last week's Instagram and TikTok posts reached the most people",
backstory="You read the numbers before anyone writes a caption.",
mcps=[easycoexistence("list_social_accounts", "list_social_posts", "get_social_insights")],
)
scheduler = Agent(
role="Scheduler",
goal="Queue next week's posts at the times the analyst recommends",
backstory="You post only what the brief approves, always with scheduled_at.",
mcps=[easycoexistence("list_social_accounts", "publish_instagram_post",
"publish_tiktok_post", "list_scheduled_posts")],
)
crew = Crew(
agents=[analyst, scheduler],
tasks=[
Task(description="Rank last week's posts by reach and views.",
expected_output="A ranked list with the best posting times", agent=analyst),
Task(description="Schedule the three posts in {brief} for next week.",
expected_output="The post_id of each queued post", agent=scheduler),
],
)
crew.kickoff(inputs={"brief": "<THE WEEK'S BRIEF>"})Skąd zespół bierze token dostępu?
Z jednego logowania w przeglądarce, a potem z odświeżenia przy każdym kickoffie. Serwer MCP easyCoexistence przyjmuje wyłącznie tokeny OAuth: dynamiczną rejestrację klienta, kod autoryzacji z PKCE, tokeny dostępu ważne godzinę i tokeny odświeżania ważne 60 dni. Uruchom raz OAuthClientProvider z MCP Python SDK na komputerze z przeglądarką i zapisz rejestrację oraz tokeny, które zwróci; poniższy pomocnik korzysta z linii 1.x SDK, którą instaluje CrewAI. Przed każdym kickoffem fresh_token wymienia zapisany token odświeżania na nową parę w endpoincie tokenów easyCoexistence i ją zapisuje, więc zespół uruchamiany co najmniej raz na 60 dni nigdy nie potrzebuje ponownie przeglądarki. Zapisany plik przechowuj w magazynie sekretów, nie w repozytorium.
import asyncio, json, webbrowser
from pathlib import Path
from urllib.parse import parse_qs, urlparse
import httpx
import requests
from pydantic import AnyUrl
from mcp import ClientSession
from mcp.client.auth import OAuthClientProvider
from mcp.client.streamable_http import streamable_http_client
from mcp.shared.auth import OAuthClientMetadata
URL = "https://easycoexistence.com/api/mcp"
SAVED = Path("easycoexistence-oauth.json") # a secret store in production
class SaveToFile: # the MCP SDK's TokenStorage, writing what the sign-in returns
def __init__(self):
self.saved = {}
async def get_tokens(self): return None
async def get_client_info(self): return None
async def set_tokens(self, tokens): self._put("tokens", tokens)
async def set_client_info(self, info): self._put("client", info)
def _put(self, key, model):
self.saved[key] = model.model_dump(mode="json")
SAVED.write_text(json.dumps(self.saved))
async def open_browser(url: str) -> None:
webbrowser.open(url)
async def code_from_redirect() -> tuple[str, str | None]:
q = parse_qs(urlparse(input("Address after sign-in: ")).query)
return q["code"][0], q.get("state", [None])[0]
async def sign_in_once() -> None:
oauth = OAuthClientProvider(
server_url=URL,
client_metadata=OAuthClientMetadata(
client_name="Acme crew", redirect_uris=[AnyUrl("http://localhost:3030/callback")], scope="mcp"),
storage=SaveToFile(), redirect_handler=open_browser, callback_handler=code_from_redirect,
)
async with httpx.AsyncClient(auth=oauth) as http:
async with streamable_http_client(URL, http_client=http) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize() # completes the sign-in and saves the tokens
def fresh_token() -> str:
"""Trade the saved refresh token for a new pair and return the access token."""
saved = json.loads(SAVED.read_text())
r = requests.post("https://easycoexistence.com/api/oauth/token", data={
"grant_type": "refresh_token",
"refresh_token": saved["tokens"]["refresh_token"],
"client_id": saved["client"]["client_id"],
}, timeout=30)
r.raise_for_status()
saved["tokens"] = r.json() # a new refresh token comes with each refresh
SAVED.write_text(json.dumps(saved))
return saved["tokens"]["access_token"]
if __name__ == "__main__":
asyncio.run(sign_in_once())Jak zespół może publikować bez serwera MCP?
Za pomocą własnego narzędzia, które wywołuje API postów easyCoexistence. Sprawdza się to przy zespole uruchamianym według harmonogramu, gdy nikogo nie ma w pobliżu. W panelu utwórz klucz Partner API, zaczynający się od ec_live_, a poniższe narzędzie wysyła POST /api/v1/channels/:id/posts z tekstem, linkiem do mediów, typem oraz publish_at. easyCoexistence kopiuje media w chwili dodania posta do kolejki, odrzuca link, który zwraca stronę internetową lub niewłaściwy format w tym momencie, i publikuje post o wyznaczonej porze; nagłówek Idempotency-Key chroni przed dodaniem posta do kolejki dwa razy przy ponowionym wywołaniu. Ten sam klucz odczytuje świeże tokeny dostępu do sieci przez GET /api/v1/channels/:id?credentials=1.
import hashlib, os
import requests
from crewai.tools import tool
@tool("Schedule a social post")
def schedule_post(account_id: str, text: str, media_url: str, media_type: str, publish_at: str) -> str:
"""Queue one post on a connected Instagram, TikTok or Facebook account.
media_type is image or video; publish_at is ISO 8601 with a timezone, 1 minute to 90 days ahead."""
key = hashlib.sha256(f"{account_id}|{publish_at}|{media_url}".encode()).hexdigest()
r = requests.post(
f"https://easycoexistence.com/api/v1/channels/{account_id}/posts",
headers={"Authorization": f"Bearer {os.environ['EC_API_KEY']}", "Idempotency-Key": key},
json={"text": text, "media": [{"url": media_url, "type": media_type}], "publish_at": publish_at},
timeout=60,
)
return r.text # the queued post, or why it was refusedKtóre agenty w zespole powinny mieć które narzędzia?
Najmniej, które pozwalają im dokończyć zadanie, bo agent może wywołać każde narzędzie, które posiada. Zespół, który planuje i publikuje tydzień treści, dzieli pracę tak, by czytanie, pisanie i publikowanie były przydzielone różnym agentom, a tylko jeden z nich mógł cokolwiek opublikować. Autorowi tekstów nie dawaj żadnych narzędzi easyCoexistence: pracuje na podstawie ustaleń analityka i briefu, a jego podpisy trafiają do harmonogramu jako wynik zadania. Narzędzia publikujące przyjmują scheduled_at, więc harmonogram kolejkuje posty na ich czas, zamiast publikować w chwili uruchomienia, a list_scheduled_posts pozwala sprawdzić, co czeka w kolejce. Posty na LinkedIn zostają poza zespołami: agent przygotowuje każdy z nich na żądanie, na przykład w Claude lub ChatGPT, a osoba zatwierdza go przed publikacją.
Czego wymagają sieci od postów i odpowiedzi zespołu?
Zasad API każdej sieci, które powinny znaleźć się w celach (goal) i historiach agentów (backstory):
- Media: publiczny link HTTPS do każdego pliku. Instagram przyjmuje obrazy JPEG, posty zdjęciowe TikToka przyjmują JPEG lub WebP, a post na stronie Facebooka przyjmuje jedno zdjęcie albo jedno wideo.
- Czas: ISO 8601 ze strefą czasową, na przykład 2026-11-20T09:00:00-03:00, od 1 minuty do 90 dni naprzód.
- Komentarze: odpowiedzi na TikToku są publiczne i wymagają ID wideo jako
post_id; komentarz na Instagramie lub Facebooku można jednorazowo prywatnie odpowiedzieć w ciągu 7 dni. - Wiadomości prywatne (DM): Instagram i Messenger przyjmują odpowiedzi w ciągu 24 godzin od ostatniej wiadomości danej osoby;
send_messagew WhatsAppie trzyma się tego samego okna, asend_templatedociera do każdego innego. - Zdarzenia: komentarz lub wiadomość prywatna trafia do zespołu wyłącznie przez własny webhook, ustawiony za pomocą
set_social_webhook_destination, który może wywołać crew.kickoff ze zdarzeniem.
Typowe błędy
- Uruchamianie zespołu z wczorajszym tokenem. Token dostępu easyCoexistence wygasa godzinę po wydaniu, a CrewAI idzie dalej bez serwera, którego nie może osiągnąć, z samym ostrzeżeniem w logu; wywołuj fresh_token przy każdym kickoffie.
- Dawanie każdemu agentowi całego serwera. Bez tool_filter analityk widzi również narzędzia publikujące; przekaż create_static_tool_filter z nazwami, których potrzebuje jego zadanie.
- Zapisywanie publish_at lub scheduled_at bez przesunięcia strefy. easyCoexistence odrzuca czas bez strefy czasowej, więc zakończ go literą Z albo przesunięciem, na przykład -03:00.
- Dodanie zapisanego pliku logowania do repozytorium. Jego token odświeżania daje każdemu, kto go posiada, narzędzia konta przez do 60 dni, dlatego trzymaj go w magazynie sekretów.
easyCoexistence daje twoim agentom CrewAI zasięg do klientów na WhatsAppie, Instagramie, Facebooku, TikToku, YouTubie, LinkedIn i kolejnych kanałach, każdym przez oficjalne API: ponad 35 narzędzi MCP dla listy mcps każdego agenta, API postów, które kolejkuje do 90 dni naprzód, oraz podpisane zdarzenia dla komentarzy i wiadomości prywatnych, a każde połączenie jest monitorowane 24/7. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, maleje w miarę dodawania połączeń, z bezpłatnym okresem próbnym wynoszącym 3 dni.
Najczęściej zadawane pytania
Czy klient MCP CrewAI sam przeprowadza logowanie OAuth?
Jego dokumentacja pokazuje nagłówki, zmienne środowiskowe i parametry zapytania do uwierzytelniania, bez przepływu OAuth. Zespół wysyła więc token bearer, który już posiada, a jedno logowanie przez MCP Python SDK go dostarcza.
Czy zespół może odpowiadać na komentarze według własnego harmonogramu?
Tak. Agent menedżera społeczności z list_social_posts, list_social_comments i reply_to_comment może przy każdym uruchomieniu przejrzeć nowe komentarze. Tak też odczytuje się komentarze z YouTube i LinkedIn, bo żadna z tych sieci nie przekazuje zdarzeń.
Czy zespół może wysyłać wiadomości na WhatsAppie?
Tak, z list_numbers, send_message i send_template w filtrze narzędzi agenta. send_message odpowiada klientom, którzy napisali w ciągu ostatnich 24 godzin, a send_template wysyła zatwierdzony szablon do każdego innego.
Ile kosztuje easyCoexistence dla zespołu CrewAI?
Od US$ 9 do US$ 0.75 za połączenie miesięcznie, maleje w miarę dodawania połączeń, tak samo w każdej sieci. Serwer MCP, API postów i przekazywane zdarzenia są wliczone, a bezpłatny okres próbny trwa 3 dni.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w