Dê a uma equipe CrewAI ferramentas para Instagram, TikTok e WhatsApp
Uma equipe CrewAI recebe Instagram, TikTok, WhatsApp e mais canais como ferramentas quando a lista mcps de cada agente contém um MCPServerHTTP para https://easycoexistence.com/api/mcp com um token de acesso OAuth da easyCoexistence no cabeçalho Authorization. O cliente MCP do CrewAI envia cabeçalhos em vez de executar um login, então a equipe renova o token a cada kickoff, e ferramentas personalizadas podem acessar a API de publicações com uma chave.
O dicionário opcional de cabeçalhos HTTP do MCPServerHTTP, que a documentação do CrewAI mostra carregando um token bearer em Authorization.
As listas de permissão e bloqueio das ferramentas de um servidor MCP do CrewAI, importadas de crewai.mcp.filters.
A espera padrão do CrewAI por uma conexão MCP; um servidor inacessível é registrado como aviso e o agente mantém suas outras ferramentas.
Por quanto tempo dura um token de acesso MCP da easyCoexistence; um token de atualização, válido por 60 dias, traz um novo par.
Com quanta antecedência a API de publicações da easyCoexistence agenda uma publicação, a partir de 1 minuto, copiando a mídia quando ela entra na fila.
Como um agente CrewAI carrega as ferramentas da easyCoexistence?
Pelo campo mcps, com um MCPServerHTTP por agente. Ele se conecta via Streamable HTTP, padrão do CrewAI para essa classe, e envia os cabeçalhos informados, aqui um cabeçalho Authorization com um token de acesso da easyCoexistence. Um filtro estático de ferramentas, criado com create_static_tool_filter, dá a cada agente somente as ferramentas que sua tarefa exige, e cache_tools_list mantém a lista após a primeira conexão. O CrewAI conecta sob demanda e, se um servidor não puder ser acessado, registra um aviso e deixa o agente seguir com suas outras ferramentas, então leia o log na primeira execução. O token de acesso vem do auxiliar da próxima seção.
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>"})De onde vem o token de acesso da equipe?
De um único login no navegador, seguido de renovação a cada kickoff. O servidor MCP da easyCoexistence aceita apenas tokens OAuth: registro dinâmico de cliente, código de autorização com PKCE, tokens de acesso válidos por uma hora e tokens de atualização válidos por 60 dias. Execute o OAuthClientProvider do MCP Python SDK uma vez, em uma máquina com navegador, e salve o registro e os tokens retornados; o auxiliar abaixo usa a linha 1.x do SDK, que o CrewAI instala. Antes de cada kickoff, fresh_token troca o token de atualização salvo no endpoint de token da easyCoexistence por um novo par e o armazena, então uma equipe que executa pelo menos uma vez em 60 dias nunca precisa do navegador novamente. Guarde o arquivo salvo em um cofre de segredos, não no repositório.
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())Como uma equipe pode publicar sem o servidor MCP?
Com uma ferramenta personalizada que chama a API de publicações da easyCoexistence, o que serve a uma equipe iniciada por um agendador sem ninguém por perto. Crie uma chave de API de Parceiro no painel, que começa com ec_live_, e a ferramenta abaixo envia POST /api/v1/channels/:id/posts com o texto, o link e o tipo da mídia e publish_at. A easyCoexistence copia a mídia quando a publicação entra na fila, recusa um link que devolva uma página web ou o formato errado naquele momento, e publica a postagem no horário definido; o cabeçalho Idempotency-Key impede que uma requisição repetida a coloque na fila duas vezes. A mesma chave lê tokens de rede novos em 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 refusedQual agente da equipe deve ter quais ferramentas?
O mínimo que permita a ele concluir a tarefa, porque um agente pode chamar qualquer ferramenta que tenha. Uma equipe que planeja e publica uma semana de conteúdo divide o trabalho para que leitura, escrita e publicação fiquem com agentes diferentes, e só um deles pode colocar algo no ar. Não dê nenhuma ferramenta da easyCoexistence ao redator: ele trabalha a partir das conclusões do analista e do briefing, e suas legendas chegam ao agendador como saída da tarefa. As ferramentas de publicação aceitam scheduled_at, então o agendador coloca as publicações na fila para os seus horários em vez de publicar no momento em que roda, e list_scheduled_posts permite confirmar o que está esperando. Publicações no LinkedIn ficam fora das equipes: um agente redige cada uma sob pedido, por exemplo no Claude ou no ChatGPT, e uma pessoa aprova antes que seja publicada.
O que as redes exigem das publicações e respostas da equipe?
As regras da API de cada rede, que devem estar nos objetivos e nas biografias dos agentes:
- Mídia: um link HTTPS público por arquivo. O Instagram aceita imagens JPEG, publicações de foto no TikTok aceitam JPEG ou WebP, e uma publicação em uma Página do Facebook aceita uma foto ou um vídeo.
- Horários: ISO 8601 com fuso horário, como 2026-11-20T09:00:00-03:00, de 1 minuto a 90 dias à frente.
- Comentários: respostas no TikTok são públicas e precisam do ID do vídeo como
post_id; um comentário no Instagram ou no Facebook pode receber uma resposta privada em até 7 dias. - DMs: o Instagram e o Messenger aceitam respostas em até 24 horas após a última mensagem da pessoa; o
send_messagedo WhatsApp segue a mesma janela de atendimento de 24 horas, e osend_templatealcança qualquer outra pessoa. - Eventos: um comentário ou DM chega à equipe somente pela sua própria rota, definida com
set_social_webhook_destination, que pode chamar crew.kickoff com o evento.
Erros comuns
- Iniciar uma equipe com o token de ontem. Um token de acesso da easyCoexistence expira uma hora após ser emitido, e o CrewAI segue sem um servidor que não consegue alcançar, apenas com um aviso no log; chame fresh_token a cada kickoff.
- Dar a cada agente o servidor inteiro. Sem tool_filter, um analista também vê as ferramentas de publicação; passe create_static_tool_filter com os nomes que sua tarefa exige.
- Escrever publish_at ou scheduled_at sem deslocamento. A easyCoexistence recusa um horário sem fuso, então termine com Z ou com um deslocamento como -03:00.
- Versionar o arquivo de login salvo. Seu token de atualização dá a quem o tiver as ferramentas da conta por até 60 dias, então guarde-o em um cofre de segredos.
A easyCoexistence dá aos seus agentes CrewAI alcance a clientes no WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn e mais canais, cada um pela sua API oficial: mais de 35 ferramentas MCP para a lista mcps de cada agente, uma API de publicações que enfileira até 90 dias à frente, e eventos assinados para comentários e DMs, com cada conexão monitorada 24/7. De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
O cliente MCP do CrewAI executa o login OAuth por conta própria?
A documentação dele mostra cabeçalhos, variáveis de ambiente e parâmetros de consulta para autenticação, sem nenhum fluxo OAuth. Então a equipe envia um token bearer que já possui, o que um login único com o MCP Python SDK fornece.
Uma equipe pode responder a comentários no próprio cronograma?
Sim. Um agente gestor de comunidade com list_social_posts, list_social_comments e reply_to_comment pode processar novos comentários a cada execução, e é assim que os comentários do YouTube e do LinkedIn também são lidos, já que nenhum dos dois encaminha eventos.
A equipe pode enviar mensagens pelo WhatsApp?
Sim, com list_numbers, send_message e send_template no filtro de ferramentas de um agente. O send_message responde a clientes que escreveram nas últimas 24 horas, e o send_template envia um template aprovado a qualquer outra pessoa.
Quanto custa a easyCoexistence para uma equipe CrewAI?
De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, e o mesmo em cada rede. O servidor MCP, a API de publicações e os eventos encaminhados estão incluídos, com os primeiros 3 dias grátis.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em