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

OpenAI Agents SDK のエージェントに Instagram、TikTok、WhatsApp のツールを持たせる

OpenAI Agents SDK のエージェントは、MCPServerStreamableHttp を経由して https://easycoexistence.com/api/mcp に接続し、Instagram、TikTok、WhatsApp などのチャネルをツールとして利用できます。認証ハンドラーには MCP Python SDK の OAuthClientProvider を使います。ツールフィルターで 35+ のツールを用途に合わせて絞り込み、require_approval によって人が承認するまで投稿を保留します。各呼び出しは、それぞれのネットワークの公式 API を通じて実行されます。

httpx2.Auth

MCPServerStreamableHttp は、MCP Python SDK v2 では params["auth"] を受け取り、v1 では httpx.Auth を受け取ります。

mcp>=1.19.0,<3

Agents SDK が依存する mcp パッケージのバージョン範囲。MCP Python SDK の両メジャーバージョンを対象とします。

interruptions

一時停止した実行が承認待ちのツール呼び出しを一覧する場所。RunState で承認または却下してから Runner.run を再開します。

Per request

Responses API の MCP ツールに OAuth トークンを authorization で送信する必要がある頻度。OpenAI は値を保存しません。

40 a minute

承認済みの各アカウントについて、Accounts API の各エンドポイントで TikTok が許可する呼び出し数(コメント返信を含む)。

Agents SDK のエージェントは easyCoexistence にどう接続しますか?

MCPServerStreamableHttp を使い、params["auth"] に MCP Python SDK の OAuthClientProvider を指定します。Agents SDK はこのハンドラーを、自身が作成する HTTP クライアントに渡します。そのためプロバイダーは easyCoexistence の認可サーバーを検出し、エージェントをパブリッククライアントとして登録します。続いて PKCE を使ったブラウザーでのサインインを 1 回行い、1 時間有効のアクセストークンはリフレッシュトークンで更新されます。この例は MCP Python SDK v2 を使っており、ハンドラーは httpx2.Auth である必要がありますが、プロバイダーはこれに該当します。ストレージオブジェクトが登録情報とトークンを実行間で保持します。以下のファイルはシークレットストアの代わりです。create_static_tool_filter はエージェントに見せるツールを指定し、require_approval は人の承認を待つツールを指定します。

The MCP server, signed in over OAuth, with a filter and approvals
import json, webbrowser
from pathlib import Path
from urllib.parse import parse_qs, urlparse

from pydantic import AnyUrl
from mcp.client.auth import AuthorizationCodeResult, OAuthClientProvider
from mcp.shared.auth import OAuthClientInformationFull, OAuthClientMetadata, OAuthToken
from agents.mcp import MCPServerStreamableHttp, create_static_tool_filter

URL = "https://easycoexistence.com/api/mcp"
SAVED = Path("easycoexistence-oauth.json")  # a secret store in production

class SavedSignIn:  # the MCP SDK's TokenStorage: registration and tokens survive restarts
    def _read(self) -> dict:
        return json.loads(SAVED.read_text()) if SAVED.exists() else {}
    def _write(self, key: str, model) -> None:
        data = self._read()
        data[key] = model.model_dump(mode="json")
        SAVED.write_text(json.dumps(data))
    async def get_tokens(self):
        t = self._read().get("tokens")
        return OAuthToken(**t) if t else None
    async def set_tokens(self, tokens): self._write("tokens", tokens)
    async def get_client_info(self):
        c = self._read().get("client")
        return OAuthClientInformationFull(**c) if c else None
    async def set_client_info(self, info): self._write("client", info)

async def open_sign_in(url: str) -> None:
    webbrowser.open(url)

async def code_from_redirect() -> AuthorizationCodeResult:
    q = parse_qs(urlparse(input("Address after sign-in: ")).query)
    return AuthorizationCodeResult(code=q["code"][0], state=q["state"][0])

oauth = OAuthClientProvider(
    server_url=URL,
    client_metadata=OAuthClientMetadata(
        client_name="Social desk agent",  # shown on easyCoexistence's consent screen
        redirect_uris=[AnyUrl("http://localhost:3030/callback")],
        scope="mcp",
    ),
    storage=SavedSignIn(),
    redirect_handler=open_sign_in,
    callback_handler=code_from_redirect,
)

PUBLISH = ["publish_instagram_post", "publish_tiktok_post", "publish_facebook_post"]

def easycoexistence() -> MCPServerStreamableHttp:
    return MCPServerStreamableHttp(
        name="easyCoexistence",
        params={"url": URL, "auth": oauth, "timeout": 60},
        client_session_timeout_seconds=60,  # publishing waits on the network's API
        cache_tools_list=True,
        tool_filter=create_static_tool_filter(allowed_tool_names=[
            "list_social_accounts", "list_social_posts", "list_social_comments",
            "reply_to_comment", "list_scheduled_posts", *PUBLISH,
        ]),
        require_approval={"always": {"tool_names": PUBLISH}},
    )

投稿を人の承認待ちにするにはどうすればよいですか?

サーバー側の require_approval を使います。指定したツールが実行される前に実行を一時停止させます。実行は最終回答ではなく interruptions を返すため、結果を RunState に変換し、保留中の各呼び出しを承認または却下したうえで、同じエージェントと状態を指定して Runner.run を再度呼び出します。always_approve が False のままであれば、承認 1 回は呼び出し 1 件だけを対象にするため、エージェントは 1 回の承認を 2 件目の投稿に流用できません。ループは async with ブロック内で動くため、一時停止中もサーバーは開いたままです。数時間かかるレビューでは、SDK は状態を JSON として保存し、後で RunState.from_json で読み込めます。

Run the agent and resume it after each decision
from agents import Agent, Runner

RULES = "You run Acme's social accounts. Schedule posts with scheduled_at; TikTok replies are public."

async def run(task: str) -> str:
    async with easycoexistence() as server:
        agent = Agent(name="Social desk", instructions=RULES, mcp_servers=[server])
        result = await Runner.run(agent, task)
        while result.interruptions:  # a publish tool is waiting for a decision
            state = result.to_state()
            for item in result.interruptions:
                if await ask_a_person(item):  # your review screen, chat message or queue
                    state.approve(item, always_approve=False)
                else:
                    state.reject(item)
            result = await Runner.run(agent, state)
        return result.final_output

TikTok のコメントや Instagram の DM で実行を開始するには?

エージェントは MCP サーバーに問い合わせた内容しか把握できないため、実行は独自の HTTPS ルートを経由して開始します。set_social_webhook_destination は、アカウントのコメント、メンション、DM をそのルートに向け、署名シークレットを一度だけ返します。TikTok アカウントはコメントを転送します。ルートは X-EC-Signature を検証します。これは、タイムスタンプ、ドット、生のボディを連結した HMAC-SHA256 です。そのうえで easyCoexistence の 8 秒の制限内に応答し、イベントをキューに入れます。その後ワーカーが、イベントを入力として Runner.run を呼び出します。DM の場合は、アカウントと送信者をキーにしたセッションで会話を継続します。TikTok のコメントに必要なのはコメントとその動画だけなので、セッションなしで実行できます。

各ネットワークについて、エージェントの指示には何を書くべきですか?

各ネットワークの API がアカウントに適用するルールを、モデルが読む場所に書きます:

  • TikTok: reply_to_comment は公開で投稿し、post_id として動画の ID が必要です。send_social_dm は TikTok アカウントを拒否します。
  • TikTok の量: アカウントごとに 1 分あたり最大 40 回の呼び出し。短時間にほぼ同じ返信を多数送ると、スパムとして非表示にされることがあります。
  • Instagram の DM: 過去 24 時間以内にメッセージを送ってきた相手にのみ返信でき、テキストは UTF-8 で最大 1,000 バイトまでです。
  • WhatsApp: 顧客の最後のメッセージから 24 時間以内は send_message を使い、それ以外は承認済みのメッセージテンプレートを使う send_template を使います。
  • タイミング: scheduled_at は、タイムゾーン付きの ISO 8601 形式で、1 分後から 90 日後までを指定できます。list_scheduled_posts で予約キューを確認できます。

エージェントは HostedMCPTool を使えますか、またはサインインなしで動かせますか?

どちらも可能ですが、それぞれにトレードオフがあります。HostedMCPTool はサーバーを Responses API に渡します。その MCP ツールは OAuth アクセストークンを authorization で受け取り、OpenAI は値を保存しないため、リクエストごとに送る必要があります。easyCoexistence のアクセストークンは 1 時間で失効するため、実行前にコードで更新してください。サインインする人がいない仕事では MCP を使わず、ec_live_ キーで Partner API を呼び出す関数ツールを使います。これで POST /api/v1/channels/:id/posts を通じて投稿をキューに入れ、GET /api/v1/channels/:id?credentials=1 から TikTok、YouTube、LinkedIn の新しいトークンを取得できます。一方、コメントルールと自動化は、エージェントを動かさなくても easyCoexistence 上で返信します。

よくある間違い

  • 5 秒の client_session_timeout_seconds を投稿の公開にそのまま使わないでください。公開はネットワークの API の応答を待つため、遅い呼び出しはエージェント側でタイムアウトすることがあり、その時点で easyCoexistence は投稿を先に送っている場合があります。1 分を見込み、再試行の前に list_scheduled_posts を確認してください。
  • external_id を account_id として渡さないでください。ツールが受け取るのは account_id で、これは easyCoexistence のアカウント ID です。external_id は、Instagram、TikTok、Facebook 上のアカウント自身の ID です。
  • 人が関与しないループで承認を行わないでください。require_approval が投稿を守るのは、人、または信頼するルールが保留中の各呼び出しを判断する場合だけです。
  • アカウント自身の活動をエージェントに渡さないでください。Instagram は、アカウントの DM を is_echo が true のエコーとして、公開返信を新しいコメントとして返します。Runner.run の前に両方を除外してください。
EasyCoexistence で実現する

easyCoexistence は、OpenAI Agents SDK のエージェントに、WhatsApp、Instagram、Facebook、TikTok、YouTube、LinkedIn などのチャネルで顧客に届く手段を提供します。いずれも各ネットワークの公式 API 経由で接続されます。OAuth でサインインする MCP サーバー、コメントと DM の署名付きイベント、無人で動く仕事向けの Partner API を備え、すべての接続を 24/7 で監視します。料金は接続ごとに月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料です。

よくある質問

OpenAI Agents SDK のエージェントに easyCoexistence の API キーは必要ですか?

MCP では不要です。OAuth サインインによって、エージェント自身のトークンが発行されます。ダッシュボードの ec_live_ キーは、MCP サーバーではなく Partner API を呼び出すコードの場合にだけ使います。

同じエージェントで WhatsApp のメッセージに返信できますか?

はい。番号のツールを使います。connection_id は list_numbers で取得します。顧客の最後のメッセージから 24 時間以内は send_message を、それ以外は send_template を使います。WhatsApp でメッセージを受信する方法は、WhatsApp 向けの OpenAI Agents SDK ガイドで解説しています。

使用するモデルはどれですか?

Agent に指定したモデルです。MCP ツールは、SDK が動かすモデルに関係なく同じように動作します。モデルの利用料金はそのプロバイダーに課金され、easyCoexistence は接続単位で課金します。

OpenAI Agents SDK のエージェントで easyCoexistence の料金はいくらですか?

接続ごとに月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。どのネットワークでも同じ料金です。MCP サーバー、転送されるイベント、Partner API も含まれ、最初の 3 日間は無料です。

続きを読む

最初のチャンネルを 2 分で接続しましょう。

プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。

  • 3 日間無料
  • いつでも解約可能
  • 公式 API のみ使用
  • 24/7 監視

確認日