ログイン無料トライアルを開始
easyCoexistence 公式 API

CrewAI のクルーに Instagram、TikTok、WhatsApp のツールを追加する

各エージェントの mcps リストに、https://easycoexistence.com/api/mcp を指す MCPServerHTTP と、Authorization ヘッダーに入れた easyCoexistence の OAuth アクセストークンがあれば、CrewAI のクルーは Instagram、TikTok、WhatsApp などのチャネルをツールとして利用できます。CrewAI の MCP クライアントはサインインを行わず、ヘッダーを送るだけなので、クルーは kickoff のたびにトークンを更新します。カスタムツールは代わりに API キーで投稿 API を呼び出せます。

headers

MCPServerHTTP の任意の HTTP ヘッダー辞書。CrewAI のドキュメントでは、Authorization の Bearer トークンを渡す例が示されている。

create_static_tool_filter

crewai.mcp.filters から読み込む、MCP サーバーのツールに対する許可リストと拒否リスト。

30 seconds

CrewAI が MCP 接続を待つ既定の時間。到達できないサーバーは警告としてログに記録され、エージェントはほかのツールを使い続ける。

1 hour

easyCoexistence の MCP アクセストークンの有効期間。リフレッシュトークン(有効期間 60 日)から新しいペアが発行される。

90 days

easyCoexistence の投稿 API が投稿を予約できる期間。1 分先から設定でき、キューに入れる時点でメディアをコピーする。

CrewAI のエージェントは easyCoexistence のツールをどのように読み込みますか?

エージェントごとに 1 つの MCPServerHTTP を、mcps フィールドで指定します。接続には Streamable HTTP を使います。これは CrewAI でこのクラスの既定の方式で、渡したヘッダー(ここでは easyCoexistence のアクセストークンを入れた Authorization ヘッダー)を送信します。create_static_tool_filter で作る静的ツールフィルターにより、各エージェントはタスクに必要なツールだけを使えます。cache_tools_list を設定すると、最初の接続後もツール一覧を保持します。CrewAI はオンデマンドで接続し、サーバーに到達できない場合は警告をログに出して、エージェントはほかのツールで作業を続けます。そのため、初回実行時にはログを確認してください。アクセストークンは次のセクションのヘルパーで取得します。

A two-agent crew, each with its own slice of the tools
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 回以上実行されるクルーは、二度とブラウザを必要としません。保存したファイルはリポジトリではなく、シークレットストアに保管してください。

easycoexistence_token.py: sign in once, refresh per kickoff
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 を呼ぶと、ネットワークの新しいトークンを取得できます。

A CrewAI tool that queues a post through the posts API
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)、人が承認してから公開します。

Analystlist_social_accounts, list_social_posts, get_social_insights, get_youtube_analytics
WriterNo easyCoexistence tools; drafts captions from the brief and the analyst's findings
Schedulerpublish_instagram_post, publish_tiktok_post, publish_facebook_post, list_scheduled_posts
Community managerlist_social_comments, reply_to_comment, hide_comment, send_social_dm

各ネットワークは、クルーの投稿と返信に何を求めますか?

各ネットワークの 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 で実現する

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 監視

確認日