Donner à une équipe d'agents CrewAI des outils Instagram, TikTok et WhatsApp
Une équipe CrewAI reçoit Instagram, TikTok, WhatsApp et d'autres canaux sous forme d'outils lorsque la liste mcps de chaque agent contient un MCPServerHTTP pointant vers https://easycoexistence.com/api/mcp, avec un token d'accès OAuth easyCoexistence dans son en-tête Authorization. Le client MCP de CrewAI envoie des en-têtes au lieu d'effectuer une connexion, donc l'équipe renouvelle le token à chaque kickoff, et des outils personnalisés peuvent joindre l'API de posts avec une clé à la place.
Le dictionnaire facultatif d'en-têtes HTTP de MCPServerHTTP, dans lequel la documentation de CrewAI place un token porteur Authorization.
Les listes d'autorisation et de blocage des outils d'un serveur MCP, importées depuis crewai.mcp.filters.
Le délai par défaut de CrewAI pour une connexion MCP ; un serveur injoignable est consigné en avertissement et l'agent conserve ses autres outils.
La durée de vie d'un token d'accès MCP d'easyCoexistence ; un token de rafraîchissement, valable 60 jours, délivre une nouvelle paire.
L'horizon de programmation de l'API de posts d'easyCoexistence, à partir de 1 minute à l'avance, avec copie du média au moment de la mise en file.
Comment un agent CrewAI charge-t-il les outils d'easyCoexistence ?
Par le champ mcps, avec un MCPServerHTTP par agent. La connexion passe par Streamable HTTP, valeur par défaut de CrewAI pour cette classe, et envoie les en-têtes que vous indiquez, ici un en-tête Authorization contenant un token d'accès easyCoexistence. Un filtre statique d'outils, créé avec create_static_tool_filter, ne donne à chaque agent que les outils de sa tâche, et cache_tools_list conserve la liste après la première connexion. CrewAI se connecte à la demande et, si un serveur est injoignable, consigne un avertissement et laisse l'agent poursuivre avec ses autres outils ; lisez donc le journal dès la première exécution. Le token d'accès provient de l'assistant de la section suivante.
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>"})D'où vient le token d'accès de l'équipe ?
D'une seule connexion dans le navigateur, puis d'un renouvellement à chaque kickoff. Le serveur MCP d'easyCoexistence n'accepte que des tokens OAuth : enregistrement dynamique du client, code d'autorisation avec PKCE, tokens d'accès valables une heure et tokens de rafraîchissement valables 60 jours. Exécutez une fois OAuthClientProvider du MCP Python SDK sur une machine avec navigateur, puis enregistrez l'inscription et les tokens qu'il renvoie ; l'assistant ci-dessous utilise la ligne 1.x du SDK, que CrewAI installe. Avant chaque kickoff, fresh_token échange le token de rafraîchissement enregistré contre une nouvelle paire auprès de l'endpoint de token d'easyCoexistence et la stocke. Ainsi, une équipe qui tourne au moins une fois tous les 60 jours n'a jamais besoin du navigateur à nouveau. Conservez le fichier enregistré dans un coffre de secrets, et non dans le dépôt.
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())Comment une équipe peut-elle publier sans le serveur MCP ?
Avec un outil personnalisé qui appelle l'API de posts d'easyCoexistence, ce qui convient à une équipe lancée par un planificateur sans personne présente. Créez une clé d'API partenaire dans le dashboard ; elle commence par ec_live_. L'outil ci-dessous envoie POST /api/v1/channels/:id/posts avec le texte, le lien du média et son type, ainsi que publish_at. easyCoexistence copie le média au moment de la mise en file, refuse un lien qui renvoie une page web ou un format incorrect à cet instant, et publie le post à son heure. L'en-tête Idempotency-Key empêche qu'un appel relancé ne le mette en file deux fois. La même clé lit les tokens réseau à jour 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 refusedQuels outils chaque agent de l'équipe doit-il détenir ?
Le moins possible pour qu'il puisse finir sa tâche, car un agent peut appeler tout outil qu'il détient. Une équipe qui planifie et publie une semaine de contenu répartit le travail pour que la lecture, la rédaction et la publication reviennent à des agents différents, et un seul d'entre eux peut mettre quoi que ce soit en ligne. Ne donnez aucun outil easyCoexistence au rédacteur : il travaille à partir des conclusions de l'analyste et du brief, et ses légendes parviennent au planificateur comme sortie de tâche. Les outils de publication acceptent scheduled_at, si bien que le planificateur met les posts en file pour leurs heures au lieu de publier à l'instant de l'exécution, et list_scheduled_posts lui permet de vérifier ce qui attend. Les posts LinkedIn restent hors des équipes : un agent rédige chacun sur demande, par exemple dans Claude ou ChatGPT, et une personne l'approuve avant sa mise en ligne.
Que demandent les réseaux pour les posts et les réponses de l'équipe ?
Les règles de l'API de chaque réseau, à placer dans les goals et les backstories des agents :
- Média : un lien HTTPS public par fichier. Instagram accepte les images JPEG, les posts photo TikTok acceptent JPEG ou WebP, et une publication sur une Page Facebook prend une photo ou une vidéo.
- Horaires : ISO 8601 avec un fuseau horaire, par exemple 2026-11-20T09:00:00-03:00, de 1 minute à 90 jours à l'avance.
- Commentaires : les réponses TikTok sont publiques et exigent l'ID de la vidéo comme
post_id; un commentaire Instagram ou Facebook peut recevoir une réponse privée dans les 7 jours. - Messages privés : Instagram et Messenger acceptent les réponses dans les 24 heures suivant le dernier message de la personne ;
send_messagede WhatsApp respecte la même fenêtre, etsend_templateatteint les autres. - Événements : un commentaire ou un message privé n'atteint l'équipe que par votre propre route, réglée avec
set_social_webhook_destination, qui peut appeler crew.kickoff avec l'événement.
Erreurs courantes
- Démarrer une équipe avec le token de la veille. Un token d'accès easyCoexistence expire une heure après son émission, et CrewAI poursuit sans un serveur qu'il ne peut joindre, avec seulement un avertissement dans le journal ; appelez fresh_token à chaque kickoff.
- Donner à chaque agent le serveur entier. Sans tool_filter, un analyste voit aussi les outils de publication ; passez create_static_tool_filter avec les noms dont sa tâche a besoin.
- Écrire publish_at ou scheduled_at sans décalage. easyCoexistence refuse une heure sans fuseau horaire ; terminez-la par Z ou par un décalage comme -03:00.
- Committer le fichier de connexion enregistré. Son token de rafraîchissement donne à quiconque le détient les outils du compte pendant jusqu'à 60 jours ; conservez-le dans un coffre de secrets.
easyCoexistence donne à vos agents CrewAI accès à vos clients sur WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn et d'autres canaux, chacun via son API officielle : plus de 35 outils MCP pour la liste mcps de chaque agent, une API de posts qui met en file jusqu'à 90 jours à l'avance, et des événements signés pour les commentaires et les messages privés, avec chaque connexion surveillée 24/7. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec 3 jours d'essai gratuit.
Questions fréquemment posées
Le client MCP de CrewAI effectue-t-il lui-même la connexion OAuth ?
Sa documentation montre des en-têtes, des variables d'environnement et des paramètres de requête pour l'authentification, sans flux OAuth. L'équipe envoie donc un token porteur qu'elle détient déjà, que fournit une seule connexion avec le MCP Python SDK.
Une équipe peut-elle répondre aux commentaires selon son propre calendrier ?
Oui. Un agent gestionnaire de communauté doté de list_social_posts, list_social_comments et reply_to_comment peut traiter les nouveaux commentaires à chaque exécution, ce qui permet aussi de lire les commentaires YouTube et LinkedIn, puisqu'aucun des deux ne transmet d'événements.
L'équipe peut-elle envoyer des messages WhatsApp ?
Oui, avec list_numbers, send_message et send_template dans le filtre d'outils d'un agent. send_message répond aux clients qui ont écrit dans les 24 dernières heures, et send_template envoie un template approuvé à tous les autres.
Combien coûte easyCoexistence pour une équipe CrewAI ?
De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, et le même tarif sur chaque réseau. Le serveur MCP, l'API de posts et les événements transmis sont inclus, avec 3 premiers jours d'essai gratuit.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le