Geef een CrewAI-crew tools voor Instagram, TikTok en WhatsApp
Een CrewAI-crew krijgt Instagram-, TikTok-, WhatsApp- en meer kanalen als tools wanneer de mcps-lijst van elke agent een MCPServerHTTP bevat voor https://easycoexistence.com/api/mcp, met een easyCoexistence OAuth-toegangstoken in de Authorization-header. De MCP-client van CrewAI stuurt headers en voert geen inlogprocedure uit, dus het crew vernieuwt het token bij elke kickoff. Aangepaste tools kunnen in plaats daarvan met een sleutel de posts-API bereiken.
Het optionele woordenboek met HTTP-headers van MCPServerHTTP, waarin de documentatie van CrewAI een Authorization-bearertoken laat zien.
De toestaan- en blokkeerlijsten van CrewAI voor de tools van een MCP-server, geïmporteerd uit crewai.mcp.filters.
De standaard wachttijd van CrewAI voor een MCP-verbinding; een server die het niet kan bereiken wordt als waarschuwing gelogd en de agent behoudt zijn andere tools.
Hoe lang een easyCoexistence MCP-toegangstoken geldig is; een refreshtoken, geldig 60 dagen, levert een nieuw paar op.
Hoe ver vooruit de posts-API van easyCoexistence een post kan inplannen, vanaf 1 minuut, waarbij de media worden gekopieerd wanneer de post in de wachtrij wordt gezet.
Hoe laadt een CrewAI-agent de easyCoexistence-tools?
Via het veld mcps, met één MCPServerHTTP per agent. De verbinding gaat via Streamable HTTP, de standaard van CrewAI voor deze klasse, en stuurt de headers die je opgeeft, hier een Authorization-header met een easyCoexistence-toegangstoken. Een statisch tool-filter, gemaakt met create_static_tool_filter, geeft elke agent alleen de tools die zijn taak nodig heeft, en cache_tools_list bewaart de lijst na de eerste verbinding. CrewAI maakt de verbinding op verzoek en, als een server niet bereikbaar is, logt het een waarschuwing en laat het de agent doorgaan met zijn andere tools. Lees daarom het log bij de eerste run. Het toegangstoken komt van de helper in de volgende sectie.
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>"})Waar komt het toegangstoken van het crew vandaan?
Uit één keer inloggen in de browser, daarna een vernieuwing bij elke kickoff. De MCP-server van easyCoexistence accepteert alleen OAuth-tokens: dynamische clientregistratie, een autorisatiecode met PKCE, toegangstokens die een uur geldig zijn en refreshtokens die 60 dagen geldig zijn. Draai de OAuthClientProvider van de MCP Python SDK één keer, op een machine met browser, en bewaar de registratie en tokens die hij teruggeeft. De onderstaande helper gebruikt de 1.x-lijn van de SDK, die CrewAI installeert. Vóór elke kickoff ruilt fresh_token het opgeslagen refreshtoken bij het tokenendpoint van easyCoexistence in voor een nieuw paar en slaat dat op. Zo heeft een crew dat minstens één keer in de 60 dagen draait nooit de browser opnieuw nodig. Bewaar het opgeslagen bestand in een geheimenkluis, niet in de repository.
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())Hoe kan een crew publiceren zonder de MCP-server?
Met een aangepaste tool die de posts-API van easyCoexistence aanroept. Dat past bij een crew die door een planner wordt gestart zonder dat er iemand bij is. Maak in het dashboard een Partner-API-sleutel aan, die begint met ec_live_. De onderstaande tool stuurt POST /api/v1/channels/:id/posts met de tekst, de medialink, het type en publish_at. easyCoexistence kopieert de media wanneer de post in de wachtrij komt, weigert op dat moment een link die een webpagina of het verkeerde formaat teruggeeft, en publiceert de post op zijn tijd. De Idempotency-Key-header voorkomt dat een herhaalde aanroep hem dubbel in de wachtrij zet. Dezelfde sleutel leest verse netwerktokens via 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 refusedWelke agent in het crew moet welke tools hebben?
De minste waarmee hij zijn taak kan afronden, want een agent kan elke tool aanroepen die hij heeft. Een crew dat een week aan content plant en plaatst, verdeelt het werk zo dat lezen, schrijven en publiceren bij verschillende agents liggen, en slechts één van hen kan iets live zetten. Geef de schrijver helemaal geen tools van easyCoexistence: hij werkt met de bevindingen van de analist en de briefing, en zijn bijschriften bereiken de planner als taakuitvoer. De publicatietools nemen scheduled_at, dus de planner zet posts in de wachtrij voor hun tijdstip in plaats van ze op het moment van de run te plaatsen. Met list_scheduled_posts controleert hij wat er wacht. LinkedIn-posts blijven buiten crews: een agent stelt er op verzoek één op, bijvoorbeeld in Claude of ChatGPT, en een persoon keurt hem goed voordat hij uitgaat.
Wat eisen de netwerken van de posts en reacties van het crew?
De regels van de API van elk netwerk, die in de doelen en achtergronden van de agents horen:
- Media: een openbare HTTPS-link per bestand. Instagram accepteert JPEG-afbeeldingen, TikTok-fotoposts accepteren JPEG of WebP, en een Facebook-pagina-post accepteert één foto of één video.
- Tijdstippen: ISO 8601 met een tijdzone, zoals 2026-11-20T09:00:00-03:00, van 1 minuut tot 90 dagen vooruit.
- Reacties: TikTok-antwoorden zijn openbaar en hebben de ID van de video nodig als
post_id. Een Instagram- of Facebook-reactie kan binnen 7 dagen één privé-antwoord krijgen. - Berichten: Instagram en Messenger accepteren antwoorden binnen 24 uur na het laatste bericht van de persoon.
send_messagevan WhatsApp houdt zich aan hetzelfde venster, ensend_templatebereikt iedereen anders. - Gebeurtenissen: een reactie of direct bericht bereikt het crew alleen via je eigen route, ingesteld met
set_social_webhook_destination. Die route kan crew.kickoff met de gebeurtenis aanroepen.
Veelgemaakte fouten
- Een crew starten met het token van gisteren. Een toegangstoken van easyCoexistence verloopt een uur nadat het is uitgegeven. CrewAI gaat dan door zonder een server die het niet kan bereiken, met alleen een waarschuwing in het log. Roep bij elke kickoff fresh_token aan.
- Elke agent de hele server geven. Zonder tool_filter ziet een analist ook de publicatietools. Geef create_static_tool_filter door met de namen die zijn taak nodig heeft.
- publish_at of scheduled_at schrijven zonder offset. easyCoexistence weigert een tijdstip zonder tijdzone, dus eindig het met Z of een offset zoals -03:00.
- Het opgeslagen inlogbestand committen. Het refreshtoken geeft wie het bezit de tools van het account tot 60 dagen lang, dus bewaar het in een geheimenkluis.
easyCoexistence geeft je CrewAI-agents bereik bij klanten op WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn en meer kanalen, elk via zijn officiële API: meer dan 35 MCP-tools voor de mcps-lijst van elke agent, een posts-API die tot 90 dagen vooruit in de wachtrij zet, en ondertekende gebeurtenissen voor reacties en directe berichten. Elke verbinding wordt 24/7 bewaakt. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Voert de MCP-client van CrewAI de OAuth-inlog zelf uit?
De documentatie toont headers, omgevingsvariabelen en queryparameters voor authenticatie, zonder OAuth-flow. Het crew stuurt dus een bearertoken dat het al heeft, wat één keer inloggen met de MCP Python SDK oplevert.
Kan een crew op eigen schema op reacties antwoorden?
Ja. Een community manager-agent met list_social_posts, list_social_comments en reply_to_comment kan bij elke run nieuwe reacties verwerken. Zo worden ook YouTube- en LinkedIn-reacties gelezen, omdat geen van beide gebeurtenissen doorstuurt.
Kan het crew WhatsApp-berichten versturen?
Ja, met list_numbers, send_message en send_template in het tool-filter van een agent. send_message antwoordt op klanten die in de afgelopen 24 uur hebben geschreven, en send_template stuurt een goedgekeurd template naar iedereen anders.
Wat kost easyCoexistence voor een CrewAI-crew?
US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, en hetzelfde op elk netwerk. De MCP-server, de posts-API en de doorgestuurde gebeurtenissen zijn inbegrepen, met de eerste 3 dagen gratis.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op