CrewAI のクルーに Instagram、TikTok、WhatsApp のツールを追加する
各エージェントの mcps リストに、https://easycoexistence.com/api/mcp を指す MCPServerHTTP と、Authorization ヘッダーに入れた easyCoexistence の OAuth アクセストークンがあれば、CrewAI のクルーは Instagram、TikTok、WhatsApp などのチャネルをツールとして利用できます。CrewAI の MCP クライアントはサインインを行わず、ヘッダーを送るだけなので、クルーは kickoff のたびにトークンを更新します。カスタムツールは代わりに API キーで投稿 API を呼び出せます。
MCPServerHTTP の任意の HTTP ヘッダー辞書。CrewAI のドキュメントでは、Authorization の Bearer トークンを渡す例が示されている。
crewai.mcp.filters から読み込む、MCP サーバーのツールに対する許可リストと拒否リスト。
CrewAI が MCP 接続を待つ既定の時間。到達できないサーバーは警告としてログに記録され、エージェントはほかのツールを使い続ける。
easyCoexistence の MCP アクセストークンの有効期間。リフレッシュトークン(有効期間 60 日)から新しいペアが発行される。
easyCoexistence の投稿 API が投稿を予約できる期間。1 分先から設定でき、キューに入れる時点でメディアをコピーする。
CrewAI のエージェントは easyCoexistence のツールをどのように読み込みますか?
エージェントごとに 1 つの MCPServerHTTP を、mcps フィールドで指定します。接続には Streamable HTTP を使います。これは CrewAI でこのクラスの既定の方式で、渡したヘッダー(ここでは easyCoexistence のアクセストークンを入れた Authorization ヘッダー)を送信します。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>"})クルーのアクセストークンはどこから取得しますか?
最初に 1 回ブラウザでサインインし、その後は kickoff のたびにリフレッシュします。easyCoexistence の MCP サーバーは OAuth トークンのみを受け付けます。動的クライアント登録、PKCE 付きの認可コード、有効期間 1 時間のアクセストークン、有効期間 60 日のリフレッシュトークンを使います。ブラウザのある端末で MCP Python SDK の OAuthClientProvider を一度実行し、返される登録情報とトークンを保存してください。以下のヘルパーは、CrewAI がインストールする SDK の 1.x 系を使います。各 kickoff の前に fresh_token が、保存済みのリフレッシュトークンを easyCoexistence のトークンエンドポイントで新しいペアと交換して保存します。そのため、60 日以内に 1 回以上実行されるクルーは、二度とブラウザを必要としません。保存したファイルはリポジトリではなく、シークレットストアに保管してください。
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 サーバーを使わずにクルーから投稿するには?
スケジューラーによって起動され、誰も見ていないクルーには、easyCoexistence の投稿 API を呼び出すカスタムツールが適しています。ダッシュボードで Partner API キーを作成します(キーは ec_live_ で始まります)。以下のツールは、テキスト、メディアのリンク、タイプ、publish_at を含めて POST /api/v1/channels/:id/posts を送信します。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クルー内のどのエージェントにどのツールを持たせるべきですか?
タスクを完了できる最小限のツールです。エージェントは保有するどのツールでも呼び出せるためです。1 週間分のコンテンツを計画して投稿するクルーでは、読み取り、執筆、公開を別々のエージェントに分担させ、実際に公開できるのは 1 つだけにします。ライターには easyCoexistence のツールを一切渡しません。アナリストの調査結果とブリーフから作業し、キャプションはタスク出力としてスケジューラーに渡します。公開ツールは scheduled_at を受け取るため、スケジューラーは実行した瞬間に投稿せず、指定時刻のために投稿をキューに入れられます。list_scheduled_posts で待機中の投稿を確認できます。LinkedIn の投稿はクルーに含めません。エージェントが依頼に応じて 1 件ずつ下書きし(例:Claude や ChatGPT)、人が承認してから公開します。
各ネットワークは、クルーの投稿と返信に何を求めますか?
各ネットワークの API の規則です。これらはエージェントの goal と backstory に記載してください。
- メディア:ファイルごとに公開された HTTPS リンクが必要です。Instagram は JPEG 画像を受け付け、TikTok の写真投稿は JPEG または WebP を受け付け、Facebook ページの投稿は写真 1 枚または動画 1 本を受け付けます。
- 時刻:タイムゾーン付きの ISO 8601 形式(例:2026-11-20T09:00:00-03:00)で、1 分先から 90 日先までを指定します。
- コメント:TikTok の返信は公開され、
post_idとして動画の ID が必要です。Instagram や Facebook のコメントには、7 日以内に 1 回だけ非公開の返信を送れます。 - DM:Instagram と Messenger は、相手の最後のメッセージから 24 時間以内に返信できます。WhatsApp の
send_messageも同じ期間に従い、それ以外の相手にはsend_templateで送信します。 - イベント:コメントや DM は、
set_social_webhook_destinationで設定した自社の Webhook 送信先を通じてのみクルーに届きます。この送信先からイベントを付けて crew.kickoff を呼び出せます。
よくある間違い
- 前回のトークンでクルーを開始する。easyCoexistence のアクセストークンは発行から 1 時間で期限切れになります。CrewAI は到達できないサーバーを無視して実行を続け、ログに警告が残るだけです。kickoff のたびに fresh_token を呼び出してください。
- エージェントに MCP サーバー全体を渡す。tool_filter がなければ、アナリストも公開ツールを見てしまいます。タスクに必要な名前を create_static_tool_filter に渡してください。
- publish_at または scheduled_at にオフセットを付けない。easyCoexistence はタイムゾーンのない時刻を拒否するため、Z か -03:00 などのオフセットで終えてください。
- 保存したサインインファイルをコミットする。そのリフレッシュトークンは、持っている人に最大 60 日間アカウントのツールを使わせてしまうため、シークレットストアに保管してください。
easyCoexistence は、公式 API を通じて、CrewAI のエージェントに WhatsApp、Instagram、Facebook、TikTok、YouTube、LinkedIn などのチャネルへのリーチを提供します。エージェントの mcps リストに追加できる 35 以上の MCP ツール、最大 90 日先まで投稿をキューに入れられる投稿 API、コメントと DM の署名付きイベント、そして 24 時間 365 日監視される接続を含みます。料金は接続ごとに月額 US$ 9 から、接続を増やすほど下がって US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
CrewAI の MCP クライアントは、OAuth サインインを自分で実行しますか?
CrewAI のドキュメントは、認証のためのヘッダー、環境変数、クエリパラメータを示しており、OAuth フローは含まれていません。そのため、クルーはすでに保持しているベアラートークンを送信します。そのトークンは、MCP Python SDK による 1 回のサインインで取得できます。
クルーは独自のスケジュールでコメントに返信できますか?
はい。list_social_posts、list_social_comments、reply_to_comment を持つコミュニティマネージャー役のエージェントは、実行のたびに新しいコメントを順に処理できます。YouTube と LinkedIn のコメントも、この方法で読み取ります。どちらのネットワークもイベントを転送しないためです。
クルーは WhatsApp メッセージを送信できますか?
はい。エージェントのツールフィルターに list_numbers、send_message、send_template を入れてください。send_message は過去 24 時間以内に問い合わせてきた顧客に返信し、send_template は承認済みのテンプレートをそれ以外の相手に送信します。
CrewAI のクルーで easyCoexistence を使うと、料金はいくらですか?
接続ごとに月額 US$ 9 から、接続を増やすほど下がって US$ 0.75 まで。どのネットワークでも同じです。MCP サーバー、投稿 API、転送されるイベントを含み、最初の 3 日間は無料です。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日