MasukMulai uji coba gratis
easyCoexistence API resmi

Berikan tool Instagram, TikTok dan WhatsApp ke crew CrewAI

Sebuah crew CrewAI mendapatkan Instagram, TikTok, WhatsApp dan saluran lain sebagai tool ketika daftar mcps setiap agen memuat MCPServerHTTP untuk https://easycoexistence.com/api/mcp dengan access token OAuth easyCoexistence di header Authorization-nya. Klien MCP CrewAI hanya mengirim header dan tidak menjalankan proses masuk, jadi crew memperbarui token pada setiap kickoff, dan custom tool dapat mengakses posts API dengan API key sebagai gantinya.

headers

Kamus opsional MCPServerHTTP berisi header HTTP, yang dalam dokumentasi CrewAI membawa token bearer Authorization.

create_static_tool_filter

Daftar izinkan dan daftar blokir CrewAI untuk tool sebuah server MCP, diimpor dari crewai.mcp.filters.

30 seconds

Waktu tunggu default CrewAI untuk koneksi MCP; server yang tidak dapat dijangkau dicatat sebagai peringatan dan agen tetap memakai tool lainnya.

1 hour

Masa berlaku access token MCP easyCoexistence; refresh token yang berlaku 60 hari menghasilkan sepasang token baru.

90 days

Seberapa jauh ke depan posts API easyCoexistence dapat menjadwalkan postingan, mulai dari 1 menit, dengan menyalin media saat postingan masuk antrean.

Bagaimana agen CrewAI memuat tool easyCoexistence?

Melalui field mcps, dengan satu MCPServerHTTP per agen. Koneksi memakai Streamable HTTP, default CrewAI untuk kelas ini, dan mengirim header yang Anda berikan, di sini header Authorization berisi access token easyCoexistence. Filter tool statis, dibuat dengan create_static_tool_filter, memberi setiap agen hanya tool yang dibutuhkan tugasnya, dan cache_tools_list menyimpan daftar tersebut setelah koneksi pertama. CrewAI terhubung sesuai kebutuhan dan, jika sebuah server tidak dapat dijangkau, mencatat peringatan lalu membiarkan agen melanjutkan dengan tool lainnya, jadi baca log pada run pertama. Access token diambil dari helper di bagian berikutnya.

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>"})

Dari mana access token crew berasal?

Dari satu kali masuk lewat browser, lalu diperbarui pada setiap kickoff. Server MCP easyCoexistence hanya menerima token OAuth: dynamic client registration, authorization code dengan PKCE, access token yang berlaku satu jam, dan refresh token yang berlaku 60 hari. Jalankan OAuthClientProvider dari MCP Python SDK sekali, di mesin yang memiliki browser, dan simpan registrasi serta token yang dikembalikannya; helper di bawah memakai versi 1.x dari SDK, yang diinstal CrewAI. Sebelum setiap kickoff, fresh_token menukar refresh token yang tersimpan di endpoint token easyCoexistence dengan sepasang token baru dan menyimpannya, sehingga crew yang berjalan minimal sekali dalam 60 hari tidak pernah memerlukan browser lagi. Simpan file ini di secret store, bukan di repositori.

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())

Bagaimana crew dapat memublikasikan tanpa server MCP?

Dengan custom tool yang memanggil posts API easyCoexistence, cocok untuk crew yang dijalankan penjadwal tanpa ada orang yang mengawasi. Buat Partner API key di dashboard, yang diawali ec_live_, dan tool di bawah mengirim POST /api/v1/channels/:id/posts dengan teks, tautan media, tipenya, serta publish_at. easyCoexistence menyalin media saat postingan masuk antrean, menolak tautan yang saat itu mengembalikan halaman web atau format yang salah, dan menerbitkan postingan pada waktunya. Header Idempotency-Key mencegah panggilan yang dicoba kembali memasukkan postingan ke antrean dua kali. Kunci API yang sama membaca token terbaru untuk setiap jaringan dari 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

Agen mana dalam crew yang sebaiknya memegang tool apa?

Jumlah tool paling sedikit yang memungkinkannya menyelesaikan tugas, karena agen dapat memanggil tool apa pun yang dimilikinya. Crew yang merencanakan dan memposting konten satu minggu membagi pekerjaan sehingga membaca, menulis dan menerbitkan dipegang agen-agen yang berbeda, dan hanya satu di antaranya yang dapat menayangkan sesuatu. Penulis tidak diberi tool easyCoexistence sama sekali: ia bekerja dari temuan analis dan brief, dan caption-nya sampai ke penjadwal sebagai output tugas. Tool penerbitan menerima scheduled_at, sehingga penjadwal memasukkan postingan ke antrean sesuai waktunya, bukan memposting saat run dimulai, dan list_scheduled_posts memungkinkan agen memastikan apa yang menunggu. Postingan LinkedIn tetap di luar crew: agen menyusun setiap postingan atas permintaan, misalnya di Claude atau ChatGPT, dan seseorang menyetujuinya sebelum dipublikasikan.

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

Apa yang dibutuhkan jaringan dari postingan dan balasan crew?

Aturan API masing-masing jaringan, yang harus dimasukkan ke goal dan backstory agen:

  • Media: tautan HTTPS publik untuk setiap file. Instagram menerima gambar JPEG, postingan foto TikTok menerima JPEG atau WebP, dan postingan Facebook Page menerima satu foto atau satu video.
  • Waktu: ISO 8601 dengan zona waktu, misalnya 2026-11-20T09:00:00-03:00, mulai dari 1 menit hingga 90 hari ke depan.
  • Komentar: balasan TikTok bersifat publik dan memerlukan ID video sebagai post_id; komentar Instagram atau Facebook dapat menerima satu balasan privat dalam 7 hari.
  • DM: Instagram dan Messenger menerima balasan dalam 24 jam sejak pesan terakhir orang tersebut; send_message WhatsApp mengikuti jendela layanan pelanggan yang sama, dan send_template menjangkau siapa pun di luar jendela itu.
  • Event: komentar atau DM hanya sampai ke crew melalui rute Anda sendiri, diatur dengan set_social_webhook_destination, yang dapat memanggil crew.kickoff dengan event tersebut.

Kesalahan umum

  • Memulai crew dengan token kemarin. Access token easyCoexistence kedaluwarsa satu jam setelah diterbitkan, dan CrewAI tetap berjalan tanpa server yang tidak dapat dijangkau, hanya dengan peringatan di log; panggil fresh_token pada setiap kickoff.
  • Memberi setiap agen seluruh server. Tanpa tool_filter, seorang analis juga melihat tool penerbitan; berikan create_static_tool_filter dengan nama yang dibutuhkan tugasnya.
  • Menulis publish_at atau scheduled_at tanpa offset. easyCoexistence menolak waktu tanpa zona waktu, jadi akhiri dengan Z atau offset seperti -03:00.
  • Meng-commit file masuk yang tersimpan. Refresh token-nya memberi siapa pun yang memegangnya akses ke tool akun hingga 60 hari, jadi simpan di secret store.
Melakukan ini dengan EasyCoexistence

easyCoexistence memberi agen CrewAI Anda jangkauan ke pelanggan di WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn dan saluran lainnya, masing-masing lewat API resminya: 35+ tool MCP untuk daftar mcps setiap agen, posts API yang memasukkan postingan ke antrean hingga 90 hari ke depan, dan event yang ditandatangani untuk komentar dan DM, dengan setiap koneksi dipantau 24/7. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah klien MCP CrewAI menjalankan proses masuk OAuth sendiri?

Dokumentasinya menunjukkan header, variabel lingkungan dan parameter query untuk autentikasi, tanpa alur OAuth. Jadi crew mengirim bearer token yang sudah dimilikinya, yang disediakan oleh satu kali masuk dengan MCP Python SDK.

Dapatkah crew membalas komentar sesuai jadwalnya sendiri?

Bisa. Agen community manager dengan list_social_posts, list_social_comments dan reply_to_comment dapat memproses komentar baru pada setiap run, yang juga menjadi cara membaca komentar YouTube dan LinkedIn, karena keduanya tidak meneruskan event.

Dapatkah crew mengirim pesan WhatsApp?

Bisa, dengan list_numbers, send_message dan send_template dalam filter tool sebuah agen. send_message membalas pelanggan yang menulis dalam 24 jam terakhir, dan send_template mengirim template yang disetujui kepada siapa pun di luar jendela itu.

Berapa biaya easyCoexistence untuk crew CrewAI?

US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dan sama di setiap jaringan. Server MCP, posts API dan event yang diteruskan sudah termasuk, dengan 3 hari pertama gratis.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada