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 を通じて実行されます。
MCPServerStreamableHttp は、MCP Python SDK v2 では params["auth"] を受け取り、v1 では httpx.Auth を受け取ります。
Agents SDK が依存する mcp パッケージのバージョン範囲。MCP Python SDK の両メジャーバージョンを対象とします。
一時停止した実行が承認待ちのツール呼び出しを一覧する場所。RunState で承認または却下してから Runner.run を再開します。
Responses API の MCP ツールに OAuth トークンを authorization で送信する必要がある頻度。OpenAI は値を保存しません。
承認済みの各アカウントについて、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 は人の承認を待つツールを指定します。
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 で読み込めます。
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_outputTikTok のコメントや 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 は、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 監視
確認日