AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Gib einer CrewAI-Crew Tools für Instagram, TikTok und WhatsApp

Eine CrewAI-Crew erhält Instagram, TikTok, WhatsApp und weitere Kanäle als Tools, wenn die mcps-Liste jedes Agenten einen MCPServerHTTP für https://easycoexistence.com/api/mcp mit einem easyCoexistence-Access-Token im Authorization-Header enthält. Der MCP-Client von CrewAI sendet Header, führt aber keine Anmeldung aus. Deshalb erneuert die Crew das Token bei jedem Kickoff, und eigene Tools können die Posts-API stattdessen mit einem Schlüssel ansprechen.

headers

Das optionale Wörterbuch mit HTTP-Headern von MCPServerHTTP, in dem die CrewAI-Dokumentation einen Authorization-Bearer-Token zeigt.

create_static_tool_filter

Die Zulass- und Sperrlisten von CrewAI für die Tools eines MCP-Servers, importiert aus crewai.mcp.filters.

30 seconds

Die Standardwartezeit von CrewAI für eine MCP-Verbindung: Ein nicht erreichbarer Server wird als Warnung protokolliert, und der Agent behält seine übrigen Tools.

1 hour

Wie lange ein easyCoexistence-MCP-Access-Token gültig ist; ein Refresh-Token, 60 Tage gültig, liefert ein neues Paar.

90 days

Wie weit im Voraus die Posts-API von easyCoexistence einen Beitrag planen kann, ab 1 Minute; die Medien werden beim Einreihen kopiert.

Wie lädt ein CrewAI-Agent die easyCoexistence-Tools?

Über das Feld mcps, mit einem MCPServerHTTP pro Agent. Die Verbindung läuft über Streamable HTTP, den Standard von CrewAI für diese Klasse, und sendet die Header, die Sie angeben, hier einen Authorization-Header mit einem easyCoexistence-Access-Token. Ein statischer Tool-Filter, erstellt mit create_static_tool_filter, gibt jedem Agenten nur die Tools, die seine Aufgabe braucht, und cache_tools_list behält die Liste nach der ersten Verbindung. CrewAI verbindet sich bei Bedarf. Ist ein Server nicht erreichbar, protokolliert es eine Warnung, und der Agent arbeitet mit seinen übrigen Tools weiter. Lesen Sie das Protokoll daher beim ersten Lauf. Das Access-Token stammt aus dem Helfer im nächsten Abschnitt.

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

Woher stammt das Access-Token der Crew?

Aus einer einmaligen Anmeldung im Browser, danach wird es bei jedem Kickoff erneuert. Der MCP-Server von easyCoexistence akzeptiert nur OAuth-Token: dynamische Client-Registrierung, ein Autorisierungscode mit PKCE, Access-Token mit einer Stunde Gültigkeit und Refresh-Token mit 60 Tagen Gültigkeit. Führen Sie den OAuthClientProvider des MCP Python SDK einmal auf einem Rechner mit Browser aus und speichern Sie die Registrierung und die Token, die er zurückgibt. Der Helfer unten nutzt die Version 1.x des SDK, die CrewAI installiert. Vor jedem Kickoff tauscht fresh_token das gespeicherte Refresh-Token am Token-Endpunkt von easyCoexistence gegen ein neues Paar und speichert es. Eine Crew, die mindestens einmal in 60 Tagen läuft, braucht den Browser daher nie wieder. Bewahren Sie die gespeicherte Datei in einem Geheimnisspeicher auf, nicht im Repository.

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

Wie kann eine Crew ohne den MCP-Server veröffentlichen?

Mit einem eigenen Tool, das die Posts-API von easyCoexistence aufruft. Das eignet sich für eine Crew, die ein Scheduler ohne Aufsicht startet. Erstellen Sie im Dashboard einen Partner-API-Schlüssel, der mit ec_live_ beginnt. Das Tool unten sendet POST /api/v1/channels/:id/posts mit dem Text, dem Medienlink, dem Medientyp sowie publish_at. easyCoexistence kopiert die Medien beim Einreihen. Zu diesem Zeitpunkt lehnt es einen Link ab, der eine Webseite oder das falsche Format zurückgibt, und veröffentlicht den Beitrag zu seiner Zeit. Der Header Idempotency-Key verhindert, dass ein wiederholter Aufruf ihn doppelt einreiht. Mit dem gleichen Schlüssel liest GET /api/v1/channels/:id?credentials=1 frische Netzwerk-Token.

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

Welcher Agent in der Crew soll welche Tools haben?

So wenige, dass er seine Aufgabe erledigt, denn ein Agent kann jedes Tool aufrufen, das er hat. Eine Crew, die eine Woche Inhalte plant und veröffentlicht, teilt die Arbeit so auf, dass Lesen, Schreiben und Veröffentlichen bei verschiedenen Agenten liegen. Nur einer davon kann etwas live schalten. Geben Sie dem Autor gar keine easyCoexistence-Tools: Er arbeitet mit den Ergebnissen des Analysten und dem Briefing, und seine Beitragstexte gelangen als Aufgabenausgabe an den Scheduler. Die Veröffentlichungs-Tools nehmen scheduled_at an, sodass der Scheduler Beiträge zu ihrer Zeit einreiht, statt sie beim Start sofort zu veröffentlichen. Mit list_scheduled_posts prüft er, was wartet. LinkedIn-Beiträge bleiben außerhalb von Crews: Ein Agent entwirft jeden Beitrag auf Anfrage, zum Beispiel in Claude oder ChatGPT, und eine Person genehmigt ihn, bevor er hinausgeht.

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

Welche Regeln gelten für Beiträge und Antworten der Crew in den Netzwerken?

Die Regeln der API jedes Netzwerks, die in die Ziele und Hintergrundgeschichten der Agenten gehören:

  • Medien: ein öffentlicher HTTPS-Link pro Datei. Instagram nimmt JPEG-Bilder, TikTok-Fotobeiträge nehmen JPEG oder WebP, und ein Facebook-Seitenbeitrag nimmt ein Foto oder ein Video.
  • Zeiten: ISO 8601 mit Zeitzone, etwa 2026-11-20T09:00:00-03:00, von 1 Minute bis 90 Tage im Voraus.
  • Kommentare: TikTok-Antworten sind öffentlich und brauchen die ID des Videos als post_id. Ein Instagram- oder Facebook-Kommentar kann innerhalb von 7 Tagen eine private Antwort erhalten.
  • DMs: Instagram und Messenger nehmen Antworten innerhalb von 24 Stunden nach der letzten Nachricht der Person an. send_message von WhatsApp hält sich an dasselbe Fenster, send_template erreicht alle anderen.
  • Ereignisse: Ein Kommentar oder eine DM erreicht die Crew nur über Ihre eigene Route, eingerichtet mit set_social_webhook_destination, die crew.kickoff mit dem Ereignis aufrufen kann.

Häufige Fehler

  • Eine Crew mit dem Token von gestern starten. Ein easyCoexistence-Access-Token läuft eine Stunde nach der Ausstellung ab. CrewAI arbeitet ohne einen nicht erreichbaren Server weiter und protokolliert nur eine Warnung. Rufen Sie fresh_token bei jedem Kickoff auf.
  • Jedem Agenten den ganzen Server geben. Ohne tool_filter sieht ein Analyst auch die Veröffentlichungs-Tools. Übergeben Sie create_static_tool_filter mit den Namen, die seine Aufgabe braucht.
  • publish_at oder scheduled_at ohne Offset schreiben. easyCoexistence lehnt eine Zeit ohne Zeitzone ab. Enden Sie die Zeit daher mit Z oder einem Offset wie -03:00.
  • Die gespeicherte Anmeldedatei ins Repository committen. Ihr Refresh-Token gibt jedem, der es besitzt, bis zu 60 Tage lang die Tools des Kontos. Bewahren Sie die Datei deshalb in einem Geheimnisspeicher auf.
Mit EasyCoexistence

easyCoexistence gibt Ihren CrewAI-Agenten Reichweite zu Kunden auf WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn und weiteren Kanälen, jeweils über deren offizielle API: über 35 MCP-Tools für die mcps-Liste jedes Agenten, eine Posts-API, die bis zu 90 Tage im Voraus einreiht, und signierte Ereignisse für Kommentare und DMs, wobei jede Verbindung rund um die Uhr überwacht wird. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit 3 Tagen kostenloser Testphase.

Häufig gestellte Fragen

Führt der MCP-Client von CrewAI die OAuth-Anmeldung selbst aus?

Seine Dokumentation zeigt Header, Umgebungsvariablen und Query-Parameter zur Authentifizierung, aber keinen OAuth-Ablauf. Die Crew sendet daher ein Bearer-Token, das sie bereits besitzt, und dieses liefert eine einmalige Anmeldung mit dem MCP Python SDK.

Kann eine Crew nach eigenem Zeitplan auf Kommentare antworten?

Ja. Ein Community-Manager-Agent mit list_social_posts, list_social_comments und reply_to_comment kann bei jedem Lauf neue Kommentare abarbeiten. So werden auch YouTube- und LinkedIn-Kommentare gelesen, da keines der beiden Netzwerke Ereignisse weiterleitet.

Kann die Crew WhatsApp-Nachrichten senden?

Ja, mit list_numbers, send_message und send_template im Tool-Filter eines Agenten. send_message antwortet Kunden, die in den letzten 24 Stunden geschrieben haben, und send_template sendet ein genehmigtes Template an alle anderen.

Was kostet easyCoexistence für eine CrewAI-Crew?

US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, und dasselbe in jedem Netzwerk. Der MCP-Server, die Posts-API und die weitergeleiteten Ereignisse sind enthalten, mit 3 Tagen kostenloser Testphase.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am