Dai a un agente OpenAI Agents SDK gli strumenti per Instagram, TikTok e WhatsApp
Un agente OpenAI Agents SDK riceve Instagram, TikTok, WhatsApp e altri canali come strumenti tramite MCPServerStreamableHttp puntato su https://easycoexistence.com/api/mcp, con OAuthClientProvider dell'MCP Python SDK come gestore dell'autenticazione. Un filtro sugli strumenti riduce i 35+ strumenti al compito, require_approval blocca la pubblicazione finché una persona non approva, e ogni chiamata raggiunge la rete tramite la sua API ufficiale.
Cosa accetta MCPServerStreamableHttp in params["auth"] con MCP Python SDK v2; con v1 accetta un httpx.Auth.
L'intervallo del pacchetto mcp da cui dipende l'Agents SDK, che copre entrambe le versioni principali dell'MCP Python SDK.
Dove una esecuzione in pausa elenca le chiamate di strumento in attesa di approvazione, che un RunState approva o rifiuta prima che Runner.run riprenda.
Con quale frequenza il token OAuth deve essere inviato in authorization allo strumento MCP delle Responses API; OpenAI non memorizza il valore.
Chiamate consentite da TikTok per account autorizzato su ogni endpoint dell'API Accounts, risposte ai commenti incluse.
In che modo un agente dell'Agents SDK si collega a easyCoexistence?
Tramite MCPServerStreamableHttp, con OAuthClientProvider dell'MCP Python SDK in params["auth"]. L'Agents SDK passa quel gestore al client HTTP che costruisce, quindi il provider individua il server di autorizzazione di easyCoexistence, registra il tuo agente come client pubblico, esegue un solo accesso nel browser con PKCE e rinnova i token di accesso, che durano un'ora, con il refresh token. L'esempio usa MCP Python SDK v2, dove il gestore deve essere un httpx2.Auth, e il provider lo è. Un oggetto di archiviazione conserva registrazione e token tra un'esecuzione e l'altra; il file qui sotto sostituisce un archivio di segreti. create_static_tool_filter elenca gli strumenti che l'agente può vedere, e require_approval indica quelli che attendono una persona.
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}},
)Come si mantiene la pubblicazione sotto l'approvazione di una persona?
Con require_approval sul server, che mette in pausa l'esecuzione prima che uno strumento indicato venga eseguito. L'esecuzione torna quindi con interruzioni invece di una risposta finale: trasforma il risultato in un RunState, approva o rifiuta ogni chiamata in sospeso e richiama Runner.run con lo stesso agente e lo stato. Con always_approve lasciato a False, ogni sì copre una sola chiamata, quindi l'agente non può riusare un'approvazione per un secondo post. Il server resta aperto durante la pausa perché il ciclo gira dentro il suo blocco async with. Per una revisione che richiede ore, l'SDK può salvare lo stato come JSON e ricaricarlo più tardi con 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_outputCome fa un commento TikTok o un DM Instagram ad avviare un'esecuzione?
Tramite una tua route HTTPS, perché l'agente sente solo ciò che chiede al server MCP. set_social_webhook_destination indirizza commenti, menzioni e DM di un account verso la route e restituisce una sola volta un segreto di firma; gli account TikTok inoltrano i commenti. La route verifica X-EC-Signature, un HMAC-SHA256 del timestamp, un punto e il corpo grezzo, risponde entro il limite di 8 secondi di easyCoexistence e accoda l'evento. Un worker poi chiama Runner.run con l'evento come input. Per i DM, una sessione legata all'account e al mittente mantiene viva la conversazione; un commento TikTok richiede solo il commento e il suo video, quindi può funzionare anche senza di esso.
Cosa devono dire le istruzioni dell'agente su ogni rete?
Le regole che l'API di ogni rete applica all'account, scritte dove il modello le legge:
- TikTok:
reply_to_commentpubblica in pubblico e richiede l'ID del video comepost_id;send_social_dmrifiuta gli account TikTok. - Volume TikTok: fino a 40 chiamate al minuto per account sull'endpoint delle risposte, e molte risposte quasi identiche in poco tempo possono essere nascoste come spam.
- DM Instagram: si risponde solo a chi ha scritto nelle ultime 24 ore, con al massimo 1.000 byte di testo UTF-8.
- WhatsApp:
send_messageentro 24 ore dall'ultimo messaggio del cliente, altrimentisend_templatecon un template approvato. - Tempi:
scheduled_ataccetta ISO 8601 con fuso orario, da 1 minuto a 90 giorni in anticipo, elist_scheduled_postsmostra la coda.
L'agente può usare HostedMCPTool, o girare senza accesso?
Entrambe le cose, con compromessi. HostedMCPTool affida il server alle Responses API, il cui strumento MCP accetta un token di accesso OAuth in authorization e lo richiede in ogni richiesta, perché OpenAI non lo memorizza; un token di accesso di easyCoexistence dura un'ora, quindi il tuo codice ne rinnova uno prima di ogni esecuzione. Per un lavoro senza nessuno che effettui l'accesso, salta MCP: gli strumenti di funzione che chiamano la Partner API con una chiave ec_live_ possono accodare post tramite POST /api/v1/channels/:id/posts e recuperare token aggiornati di TikTok, YouTube e LinkedIn da GET /api/v1/channels/:id?credentials=1, mentre le regole sui commenti e le automazioni rispondono su easyCoexistence senza che nessun agente giri.
Errori comuni
- Mantenere client_session_timeout_seconds a 5 secondi per la pubblicazione. Una pubblicazione attende l'API della rete, quindi una chiamata lenta può andare in timeout nell'agente dopo che easyCoexistence ha già passato il post alla rete; imposta un minuto e controlla list_scheduled_posts prima di riprovare.
- Passare external_id come account_id. Gli strumenti accettano account_id, l'ID di easyCoexistence per l'account; external_id è l'ID dell'account su Instagram, TikTok o Facebook.
- Approvare le interruzioni in un ciclo senza nessuna persona. require_approval protegge la pubblicazione solo quando una persona, o una regola di cui ti fidi, decide su ogni chiamata in sospeso.
- Dare all'agente la propria attività. Instagram restituisce i DM dell'account come echi con is_echo true e le sue risposte pubbliche come nuovi commenti; filtra entrambi prima di Runner.run.
easyCoexistence dà ai tuoi agenti OpenAI Agents SDK la portata verso i clienti su WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn e altri canali, ciascuno tramite la sua API ufficiale: un server MCP che accede con OAuth, eventi firmati per commenti e DM e una Partner API per i lavori senza supervisione, con ogni connessione monitorata 24/7. Da US$ 9 a US$ 0,75 per connessione al mese, in calo man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.
Domande frequenti
L'agente ha bisogno di una chiave da easyCoexistence?
Non per MCP. L'accesso OAuth emette all'agente i suoi token; una chiave ec_live_ dalla dashboard serve solo al codice che chiama la Partner API invece del server MCP.
Lo stesso agente può rispondere ai messaggi WhatsApp?
Sì, con gli strumenti del numero: list_numbers per il connection_id, send_message entro 24 ore dall'ultimo messaggio del cliente e send_template al di fuori di quella finestra. La guida dell'OpenAI Agents SDK per WhatsApp copre la ricezione dei messaggi.
Quale modello usa l'agente?
Quello che assegni all'Agent. Gli strumenti MCP funzionano allo stesso modo qualunque modello esegua l'SDK, l'uso del modello è fatturato dal suo fornitore, e easyCoexistence addebita per connessione.
Quanto costa easyCoexistence per un agente OpenAI Agents SDK?
Da US$ 9 a US$ 0,75 per connessione al mese, in calo man mano che aggiungi connessioni, uguale su ogni rete. Il server MCP, gli eventi inoltrati e la Partner API sono inclusi, e i primi 3 giorni sono di prova gratuita.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il