Дайте команде CrewAI инструменты для Instagram, TikTok и WhatsApp
Команда CrewAI получает Instagram, TikTok, WhatsApp и другие каналы как инструменты, когда в списке mcps каждого агента есть MCPServerHTTP для https://easycoexistence.com/api/mcp с токеном доступа OAuth easyCoexistence в заголовке Authorization. MCP-клиент CrewAI передаёт заголовки и не выполняет вход, поэтому команда обновляет токен при каждом вызове kickoff, а собственные инструменты могут обращаться к API публикаций по ключу.
Необязательный словарь HTTP-заголовков MCPServerHTTP, в котором, как показано в документации CrewAI, передаётся токен Authorization bearer.
Списки разрешённых и заблокированных инструментов MCP-сервера CrewAI, импортируемые из crewai.mcp.filters.
Стандартное время ожидания подключения к MCP в CrewAI: сервер, до которого не удалось достучаться, записывается в журнал как предупреждение, а агент продолжает работу с остальными инструментами.
Срок действия токена доступа MCP easyCoexistence; токен обновления, действующий 60 дней, выдаёт новую пару токенов.
Насколько заранее API публикаций easyCoexistence планирует пост, от 1 минуты; медиа копируется при постановке в очередь.
Как агент CrewAI загружает инструменты easyCoexistence?
Через поле mcps, по одному MCPServerHTTP на агента. Подключение идёт по Streamable HTTP, стандартному для этого класса в CrewAI, и отправляются заданные вами заголовки, здесь заголовок Authorization с токеном доступа easyCoexistence. Статический фильтр инструментов, созданный через create_static_tool_filter, оставляет каждому агенту только инструменты, нужные его задаче, а cache_tools_list сохраняет список после первого подключения. CrewAI подключается по требованию и, если сервер недоступен, записывает предупреждение и позволяет агенту работать с остальными инструментами, поэтому проверьте журнал при первом запуске. Токен доступа берётся из вспомогательной функции в следующем разделе.
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>"})Откуда у команды токен доступа?
Из одного входа через браузер, далее обновление при каждом вызове kickoff. MCP-сервер easyCoexistence принимает только токены OAuth: динамическую регистрацию клиента, код авторизации с PKCE, токены доступа на один час и токены обновления на 60 дней. Один раз запустите OAuthClientProvider из MCP Python SDK на машине с браузером и сохраните регистрацию и токены, которые он вернёт. Вспомогательный код ниже использует ветку 1.x SDK, которую устанавливает CrewAI. Перед каждым вызовом kickoff функция fresh_token обменивает сохранённый токен обновления на новую пару в эндпоинте токенов easyCoexistence и сохраняет её, поэтому команде, которая запускается хотя бы раз в 60 дней, браузер больше не понадобится. Храните сохранённый файл в хранилище секретов, а не в репозитории.
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())Как команда может публиковать без MCP-сервера?
С помощью собственного инструмента, который вызывает API публикаций easyCoexistence. Это подходит для команды, которую запускает планировщик, когда рядом никого нет. Создайте ключ Partner API в панели управления; он начинается с ec_live_. Инструмент ниже отправляет POST /api/v1/channels/:id/posts с текстом, ссылкой на медиа, типом, publish_at. easyCoexistence копирует медиа при постановке публикации в очередь, отклоняет ссылку, которая в этот момент отдаёт веб-страницу или файл не того формата, и публикует пост в указанное время. Заголовок Idempotency-Key не даёт повторному вызову поставить публикацию в очередь дважды. Тот же ключ читает актуальные токены сетей из 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 refusedКакому агенту команды какие инструменты давать?
Минимум, которого хватает для выполнения задачи, поскольку агент может вызвать любой инструмент из своего набора. Команда, которая планирует и публикует контент на неделю, делит работу так, чтобы чтение, написание и публикация были у разных агентов, и только один из них может что-либо опубликовать. Автору не давайте никаких инструментов easyCoexistence: он работает с выводами аналитика и брифом, а его подписи передаются планировщику как результат задачи. Инструменты публикации принимают scheduled_at, поэтому планировщик ставит посты в очередь на нужное время, а не публикует их в момент запуска, а list_scheduled_posts позволяет проверить, что ожидает публикации. Посты LinkedIn в команды не включайте: агент составляет каждый по запросу, например в Claude или ChatGPT, а человек одобряет его перед отправкой.
Какие требования сетей к постам и ответам команды?
Правила API каждой сети; их нужно включить в поля goal и backstory агентов:
- Медиа: публичная ссылка HTTPS на каждый файл. Instagram принимает изображения в JPEG, фотопосты TikTok принимают JPEG или WebP, а публикация на странице Facebook принимает одно фото или одно видео.
- Время: ISO 8601 с часовым поясом, например 2026-11-20T09:00:00-03:00, от 1 минуты до 90 дней вперёд.
- Комментарии: ответы в TikTok публичны и требуют ID видео в
post_id; на комментарий в Instagram или Facebook можно один раз ответить личным сообщением в течение 7 дней. - Личные сообщения: Instagram и Messenger принимают ответы в течение 24 часов после последнего сообщения человека;
send_messageв WhatsApp работает в том же окне, аsend_templateдоходит до всех остальных. - События: комментарий или личное сообщение попадает в команду только через ваш собственный маршрут, который задаётся через
set_social_webhook_destinationи может вызывать crew.kickoff с событием.
Распространённые ошибки
- Запуск команды со вчерашним токеном. Токен доступа easyCoexistence истекает через час после выдачи, а CrewAI продолжает работу без недоступного сервера, оставляя в журнале только предупреждение; вызывайте fresh_token при каждом вызове kickoff.
- Предоставление каждому агенту всего сервера. Без tool_filter аналитик видит и инструменты публикации; передайте create_static_tool_filter с именами, нужными его задаче.
- Указание publish_at или scheduled_at без смещения. easyCoexistence отклоняет время без часового пояса, поэтому завершайте его буквой Z или смещением, например -03:00.
- Коммит сохранённого файла входа в репозиторий. Его токен обновления даёт тому, у кого он есть, доступ к инструментам аккаунта до 60 дней, поэтому храните файл в хранилище секретов.
easyCoexistence даёт вашим агентам CrewAI доступ к клиентам в WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn и других каналах, каждый через официальный API: более 35 инструментов MCP для списка mcps каждого агента, API публикаций, который ставит посты в очередь на 90 дней вперёд, и подписанные события для комментариев и личных сообщений; каждое подключение находится под круглосуточным мониторингом. От US$ 9 до US$ 0,75 за подключение в месяц, снижаясь по мере добавления подключений; первые 3 дня бесплатно.
Часто задаваемые вопросы
Сам ли MCP-клиент CrewAI проводит вход по OAuth?
В его документации показаны заголовки, переменные окружения и параметры запроса для аутентификации, но потока OAuth там нет. Поэтому команда отправляет токен bearer, который у неё уже есть, а его получает один вход через MCP Python SDK.
Может ли команда отвечать на комментарии по собственному расписанию?
Да. Агент-менеджер сообщества с list_social_posts, list_social_comments и reply_to_comment может обрабатывать новые комментарии при каждом запуске. Так же читаются комментарии YouTube и LinkedIn, поскольку ни одна из этих сетей не передаёт события.
Может ли команда отправлять сообщения в WhatsApp?
Да, если в фильтре инструментов агента есть list_numbers, send_message и send_template. send_message отвечает клиентам, которые писали за последние 24 часа, а send_template отправляет одобренный шаблон всем остальным.
Сколько стоит easyCoexistence для команды CrewAI?
От US$ 9 до US$ 0,75 за подключение в месяц, снижаясь по мере добавления подключений, одинаково для каждой сети. Сервер MCP, API публикаций и пересылка событий включены; первые 3 дня бесплатно.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на