MCP-Server

Der Bird-MCP-Server stellt die Bird-API als Model Context Protocol-Tools bereit. Unterstützte Clients sind unter anderem Claude Code, Cursor, VS Code, Codex, Claude, ChatGPT und Muse. Sie können über jeden Kanal senden, den Bird betreibt, diese Kanäle einrichten und Ihren Workspace inspizieren, ohne cURL-Befehle kopieren zu müssen. Sie können den Server auf zwei Arten betreiben, und die meisten wollen die erste:

1. Gehostet (mcp.bird.com): eine URL und eine Browser-Anmeldung. Nichts zu installieren, kein CLI, kein API-Key. Das ist der empfohlene Weg.
2. Lokal über stdio (bird mcp): Tools, die auf Ihrem Rechner innerhalb der bird CLI laufen – für Shell-Agents oder den Eigenbetrieb.

Der gehostete Server lässt diese stdio-exklusiven Tools weg:

• auth_signup, auth_verify_email und auth_create_org: Diese Tools erstellen Ihre erste Zugangskennung, bevor Sie sich beim gehosteten Server authentifizieren können.
• compliance_attachments_upload: Dieses Tool liest einen lokalen Dateipfad. Auf dem gehosteten Server würde dieser Pfad auf das Dateisystem des Servers verweisen und könnte die falsche Datei hochladen.

Gehostet: Verbindung zu mcp.bird.com

Endpoint wählen

Verwenden Sie https://mcp.bird.com für die meisten Verbindungen. Es ist der empfohlene Endpoint: Die meisten MCP-Clients suchen und wählen Tools intern bereits aus dem vollständigen Katalog. Manche Clients suchen Tools nicht intern oder erzwingen ein festes Limit für die Anzahl der Tools, die ein Server bereitstellen darf. /dynamic ist für diese Clients gedacht.

Beide gehosteten Endpoints verwenden Streamable HTTP und dieselbe Bird-OAuth-Anmeldung:

Der dynamische Endpoint gibt Ihnen Zugriff auf dieselben gehosteten Operationen über execute. Der Standard-Endpoint und der lokale stdio-Server behalten ihre einzelnen Tools; sie listen search oder execute nicht auf.

Sie müssen kein Binary installieren und kein Token erstellen. Die Verbindung erfordert zwei Schritte, und beide sind notwendig:

1. Server hinzufügen: Geben Sie dem Client Ihre gewählte Endpoint-URL.
2. Authentifizieren: Melden Sie sich über Ihren Browser an, damit der Client ein Token hält, das in Ihrem Namen agiert.

Beide Endpoints erfordern Authentifizierung. Ein Client, der nur die URL hat, erhält einen 401, bis Sie sich anmelden. Manche Clients starten die Anmeldung selbst beim ersten Kontakt mit dem Server; andere parken den Server als "needs login" und warten, bis Sie darauf klicken. Die Anleitung Ihres Clients beschreibt das jeweilige Verhalten.

Dynamische Tool-Erkennung verwenden

Wenn Ihr Client den Server ablehnt, weil er zu viele Tools anbietet, verbinden Sie sich mit https://mcp.bird.com/dynamic und schließen Sie die OAuth-Anmeldung ab. Ihr Client zeigt zwei Tools:

• search findet Tools anhand von Name oder Beschreibungs-Stichwörtern. Jeder Treffer enthält Name, Beschreibung, Input-Schema und Annotationen, die angeben, ob das Tool Daten liest oder ändert.
• execute ruft ein ausgewähltes Tool mit seinen Argumenten auf. Es kann Daten lesen, Nachrichten senden, Datensätze ändern oder löschen – je nach gewähltem Tool.

Ihr Agent kann zum Beispiel das Workspace-Tool mit folgendem Tool-Call finden:

{
  "name": "search",
  "arguments": { "query": "workspace_get", "limit": 3 }
}

Nachdem er das zurückgegebene Input-Schema gelesen hat, ruft er dieses Tool über execute auf:

{
  "name": "execute",
  "arguments": { "tool": "workspace_get", "arguments": {} }
}

Das Ergebnis enthält Ihren aktuellen Workspace. Sie können auch mit aufgabenbezogenen Stichwörtern suchen, etwa send email. Die Suche liefert standardmäßig fünf Treffer, akzeptiert einen limit von 1 bis 10 und Abfragen bis 500 Zeichen. Wenn das Ergebnis has_more: true enthält, grenzen Sie Ihre Abfrage ein, um relevantere Treffer zu erhalten.

Suchergebnisse fügen Ihrem Client-Katalog keine Tools hinzu. Namen, die in Ergebnissen oder Fehlerbehebungshinweisen vorkommen, werden ebenfalls über execute aufgerufen. Die Ausführung nutzt Ihre bestehenden Berechtigungen; benötigt eine Operation mehr Berechtigungen, fordert Ihr Client Sie möglicherweise auf, diese zu autorisieren. Ein Tool zu finden gewährt keinen Zugriff darauf.

Die dynamische Ausführung gibt Daten für Tools zurück, die sonst Widgets anzeigen. Verwenden Sie den Standard-Endpoint für interaktive MCP-Apps-Widgets. Clients sehen ein einziges Ausführungs-Tool, sodass Genehmigungseinstellungen pro Tool auf execute als Ganzes wirken; prüfen Sie die gewählte Operation, bevor Sie einen Aufruf genehmigen. Dieser Endpoint führt Tool-Calls aus und führt kein JavaScript oder sonstigen übergebenen Code aus.

Einen Client verbinden

Die folgenden Beispiele verwenden den Standard-Endpoint. Für die dynamische Erkennung ersetzen Sie https://mcp.bird.com/dynamic als Server-URL und folgen denselben Anmeldeschritten.

Claude Code

Server hinzufügen:

claude mcp add --transport http bird https://mcp.bird.com

claude mcp list meldet bird jetzt als ! Needs authentication. Claude Code öffnet den Browser nicht von sich aus, melden Sie sich daher innerhalb einer Session an:

1. Führen Sie /mcp aus.
2. Wählen Sie bird und drücken Sie Enter.
3. Wählen Sie Authenticate. Ihr Browser öffnet den Consent-Screen von Bird; bestätigen Sie dort.

Der Server wird dann als verbunden angezeigt und die Tools funktionieren. Ein Headless-Run (claude -p) hat kein /mcp-Panel, authentifizieren Sie sich daher zuerst über Ihre Shell mit claude mcp login bird. Um sich später erneut anzumelden, bietet /mcp Re-authenticate an; Clear authentication verwirft das gespeicherte Token.

Durch Installation des bird-ai-Plugins wird dieser Server für Sie deklariert, was den claude mcp add-Befehl ersetzt. Die Authentifizierung bleibt erforderlich, weil ein Plugin zwar einen Server ausliefern, aber kein Grant ausstellen kann. Wählen Sie nach der Installation /mcp > bird > Authenticate.

Cursor

In ~/.cursor/mcp.json:

{
  "mcpServers": {
    "bird": {
      "url": "https://mcp.bird.com"
    }
  }
}

Öffnen Sie dann Customize in der Cursor-Seitenleiste und wählen Sie MCPs. Suchen Sie bird, folgen Sie der Anmeldeaufforderung, genehmigen Sie den Zustimmungsbildschirm von Bird im Browser und kehren Sie zu Cursor zurück.

OpenCode

Das OpenCode-Plugin von Bird registriert den Server zusammen mit den Agent-Skills von Bird für Sie:

opencode plugin github:messagebird/bird-ai --global

OpenCode fügt jedes MCP-Tool zum Kontext des Modells hinzu. Daher verbindet sich das Plugin mit dem dynamischen Endpoint. Wenn der experimentelle Code-Modus von OpenCode aktiviert ist (OPENCODE_EXPERIMENTAL_CODE_MODE=1 oder OPENCODE_EXPERIMENTAL=1), hält OpenCode MCP-Tools hinter seiner eigenen Suche zurück, und das Plugin verbindet sich stattdessen mit dem vollständigen Katalog unter https://mcp.bird.com.

Um den Server ohne Plugin hinzuzufügen, tragen Sie Folgendes in opencode.json in Ihrem Projekt oder unter ~/.config/opencode/opencode.json ein:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "bird": {
      "type": "remote",
      "url": "https://mcp.bird.com/dynamic"
    }
  },
  "permission": {
    "bird_execute": "ask"
  }
}

Melden Sie sich dann an. Dabei öffnet sich Ihr Browser mit dem Zustimmungsbildschirm von Bird:

opencode mcp auth bird

Starten Sie OpenCode neu, um das Plugin zu laden. opencode mcp list zeigt bird nach Ihrer Zustimmung als verbunden an. Wie der Eintrag permission oben lässt das Plugin OpenCode vor jedem Aufruf von execute nachfragen, da das ausgeführte Tool Ihren Workspace ändern kann.

VS Code

In .vscode/mcp.json in Ihrem Projekt:

{
  "servers": {
    "bird": {
      "type": "http",
      "url": "https://mcp.bird.com"
    }
  }
}

Sie verwenden settings.json? Setzen Sie denselben bird-Eintrag unter mcp.servers. VS Code verschiebt ihn in Ihre Benutzer-mcp.json, die Sie mit MCP: Open User Configuration öffnen:

{
  "mcp": {
    "servers": {
      "bird": {
        "type": "http",
        "url": "https://mcp.bird.com"
      }
    }
  }
}

VS Code fordert Sie beim ersten Start auf, dem Server zu vertrauen, und führt dann den OAuth-Flow selbst aus: Genehmigen Sie den Zustimmungsbildschirm von Bird im Browserfenster, das sich öffnet. Falls kein Fenster erscheint, starten Sie bird über den Befehl MCP: List Servers und genehmigen Sie ihn dort. Die resultierende Berechtigung finden Sie unter Accounts > Manage Trusted MCP Servers – dort können Sie den Zugriff von VS Code auch widerrufen.

ChatGPT und Codex

Installieren Sie Bird in ChatGPT oder Codex, melden Sie sich in Ihrem Bird-Workspace an und bitten Sie Ihren Agenten, Nachrichten zu senden, Domains und Nummern zu verwalten und die Zustellung zu prüfen.

Für eine manuelle Codex-Einrichtung fügen Sie stattdessen diesen Eintrag in ~/.codex/config.toml hinzu:

[mcp_servers.bird]
url = "https://mcp.bird.com"

Melden Sie sich dann über Ihre Shell an, wobei sich der Browser öffnet:

codex mcp login bird

Claude

Bird ist in Claudes Connector-Verzeichnis gelistet. Öffnen Sie Bird im Verzeichnis und klicken Sie auf Connect to Claude, um die Anmeldung durchzuführen und den Zustimmungsbildschirm zu bestätigen. Aktivieren Sie den Connector pro Konversation über + > Connectors. Das funktioniert in Claude im Web und in der Desktop-App.

Um ihn stattdessen manuell hinzuzufügen, öffnen Sie Customize > Connectors, klicken Sie auf + und dann auf Add custom connector. Fügen Sie https://mcp.bird.com ein und klicken Sie auf Add. Klicken Sie dann beim Bird-Connector auf Connect, um die Anmeldung durchzuführen und den Zustimmungsbildschirm zu bestätigen. Bei Team- und Enterprise-Plänen fügt ein Owner den Connector einmalig über Organization settings > Connectors hinzu, und jedes Mitglied klickt weiterhin unter Customize > Connectors auf Connect für seinen eigenen Grant. Aktivieren Sie den Connector pro Konversation über + > Connectors.

Für eine manuelle ChatGPT-Einrichtung folgen Sie stattdessen OpenAIs Anleitung zur Einrichtung von MCP-Apps und verwenden Sie https://mcp.bird.com als Server-URL und OAuth als Authentifizierung. Schließen Sie die Browser-Anmeldung bei Bird ab und verwenden Sie dann Bird in Ihrem Chat.

Muse

Muse fügt Bird als benutzerdefinierten Connector hinzu. Bitten Sie Muse in einem Chat, einen einzurichten:

Set up a custom connector to the Bird MCP server at https://mcp.bird.com following https://bird.com/docs/ai/mcp-server.md so you can work with my Bird workspace.

Muse antwortet mit einem Verbindungslink für diese Sitzung. Öffnen Sie ihn und bestätigen Sie den Zustimmungsbildschirm von Bird im Browser. Der Link funktioniert nur für Sie und läuft mit der Sitzung ab. Wenn er nicht mehr funktioniert, bitten Sie Muse um einen neuen.

Factory Droid

droid mcp add bird https://mcp.bird.com --type http

Führen Sie dann /mcp in droid aus und schließen Sie die Browser-Anmeldung über den Server-Manager ab.

Antigravity

Das Antigravity-Plugin von Bird registriert den Server zusammen mit den Agent-Skills von Bird für Sie:

curl -fsSL https://raw.githubusercontent.com/messagebird/bird-ai/main/antigravity.sh | bash

Um den Server ohne Plugin hinzuzufügen, tragen Sie Folgendes in ~/.gemini/config/mcp_config.json oder für ein einzelnes Projekt in .agents/mcp_config.json ein. Antigravity liest die Adresse eines Remote-Servers aus serverUrl, behalten Sie daher diesen Schlüsselnamen bei:

{
  "mcpServers": {
    "bird": {
      "serverUrl": "https://mcp.bird.com"
    }
  }
}

Melden Sie sich dann an: Öffnen Sie Customizations in der Seitenleiste (in der IDE öffnen Sie Agent settings mit Cmd+, unter macOS oder Ctrl+, unter Windows und Linux) und wählen Sie Authenticate neben bird. Falls bird nicht aufgeführt ist, starten Sie Antigravity neu. Bestätigen Sie den Zustimmungsbildschirm von Bird im Browser, kopieren Sie den angezeigten Autorisierungscode, fügen Sie ihn in Antigravity ein und wählen Sie Submit.

Agent Plugins

Das bird-ai-Plugin deklariert diesen Server in einer mcp.json, die Agent Plugins folgt. Ein Host, der die Spezifikation implementiert, liest diese Datei bei der Plugin-Installation – Sie müssen also keine Server-Konfiguration schreiben: Installieren Sie das Plugin und melden Sie sich an.

Jeder andere Host

Suchen Sie die Einstellung, die einen remote-, HTTP- oder custom-MCP-Server hinzufügt – oft unter einem Connectors- oder Integrations-Menü – und geben Sie die URL ein. Die Position des Feldes variiert; verwenden Sie die URL Ihres gewählten gehosteten Endpoints. Finden Sie dann die Anmeldemöglichkeit des Clients: ein Connect-, Authorize- oder Needs login-Steuerelement neben dem Server, einen login-Unterbefehl oder ein Browserfenster, das der Client selbst öffnet. Ein Client, der die Tools von Bird auflistet, aber bei jedem Aufruf scheitert, hat zwar die URL, benötigt aber noch eine Berechtigung.

Was bei der Anmeldung passiert

Ihr Browser öffnet einen Bird-Zustimmungsbildschirm. Melden Sie sich an, wählen Sie, ob Sie Workspace- oder Organisationsberechtigungen gewähren möchten, und legen Sie fest, welche Berechtigungen Sie delegieren. Da MCP-Clients sich selbst registrieren, ist der Name des Clients selbst angegeben, und der Bildschirm kennzeichnet ihn als not verified by Bird. Bestätigen Sie, dass es sich um den Client handelt, den Sie tatsächlich gestartet haben, bevor Sie zustimmen. Danach erscheinen die Tools in der Liste des Agenten und das Token wird automatisch erneuert – dieser Schritt ist also pro Client nur einmal nötig.

Der schnellste Weg, die Verbindung zu prüfen, ist den Agenten whoami aufrufen zu lassen: Es gibt den angemeldeten Benutzer zurück, eine echte Antwort bedeutet also, dass die Berechtigung aktiv ist. Am dynamischen Endpoint rufen Sie es über execute mit tool: "whoami" und leerem arguments auf.

Die Berechtigung ist auf die Schnittmenge dessen beschränkt, was der Client angefordert hat, was Sie genehmigt haben und was Sie tatsächlich besitzen; org:owner- und Platform-Admin-Scopes sind niemals delegierbar. Sie erscheint in der Liste Connected apps Ihres Profils, und ein Widerruf dort trennt den Client sofort.

Wie der Handshake funktioniert

Sie brauchen das nicht, um einen Client zu verbinden. Es ist relevant, wenn Sie einen Client debuggen, der sich nicht authentifiziert, oder wenn Sie einen eigenen schreiben.

Die gehostete Variante spricht Streamable HTTP und kommt ohne Credentials aus: Sie speichert keine Secrets und validiert selbst nichts. Jede Anfrage trägt Ihr eigenes OAuth-Bearer-Token, das Birds API pro Anfrage validiert. Der Server ist zustandslos und regionaler Traffic wird automatisch geroutet, daher funktioniert die eine URL von überall.

Der Anmeldevorgang verwendet standardmäßiges MCP. Clients unterscheiden sich nur darin, was ihn auslöst: der erste Tool-Aufruf oder die Auswahl von Authenticate. Nach dem Start des Vorgangs erfordern die Authentifizierungsschritte keine zusätzliche Konfiguration:

1. Der Client sendet eine nicht authentifizierte Anfrage und erhält 401 mit einem WWW-Authenticate-Header zurück, der auf die RFC 9728-Protected-Resource-Metadaten von Bird verweist (/.well-known/oauth-protected-resource).
2. Von dort entdeckt er den Authorization-Server und registriert sich dynamisch (RFC 7591). Die dynamische Registrierung macht eine vorab geteilte Client-ID oder manuelle Konfiguration überflüssig.
3. Ihr Browser öffnet den Zustimmungsbildschirm von Bird.
4. Der Client tauscht das Ergebnis gegen ein Access-Token (PKCE; wird automatisch erneuert) und die Bird-Tools erscheinen.

Lokal: über stdio mit der CLI ausführen

Führen Sie den lokalen MCP-Server innerhalb der bird CLI aus, für shell-fähige Agents oder den Zugriff auf Dateien auf Ihrem Rechner. Installieren Sie die CLI, führen Sie bird auth login einmal aus, und verweisen Sie Ihren Client dann auf den Befehl bird mcp.

Sie führen bird mcp nicht selbst aus: Ihr Client startet es und kommuniziert über stdin/stdout damit. Jeder Client benötigt dieselben zwei Angaben: den Befehl (bird) und das Argument (mcp). Dieser Weg erfordert keine clientspezifische Anmeldung, weil bird auth login den Grant bereits hält.

Cursor

{
  "mcpServers": {
    "bird": {
      "command": "bird",
      "args": ["mcp"]
    }
  }
}

VS Code

In .vscode/mcp.json in Ihrem Projekt:

{
  "servers": {
    "bird": {
      "type": "stdio",
      "command": "bird",
      "args": ["mcp"]
    }
  }
}

Claude Code

claude mcp add bird -- bird mcp

Wie sich der lokale Server authentifiziert

Der lokale Server handelt als Sie und nutzt das gespeicherte Login der CLI. bird auth login öffnet einen OAuth-Flow im Browser, in dem Sie eine Teilmenge Ihrer Workspace-Berechtigungen gewähren. Das ausgestellte Token hat dieselben Berechtigungsgrenzen wie der gehostete Grant. Weder org:owner- noch Platform-Admin-Scopes stehen zur Verfügung. bird mcp liest und erneuert das gespeicherte Login aus der CLI-Credentials-Datei mit dem Modus 0600. Wie bei der gehosteten Variante enthält Ihre Client-Konfiguration keinen BIRD_API_KEY oder ein anderes Secret. Fehlt das Login, verweigert bird mcp den Start und fordert Sie auf, bird auth login auszuführen.

Sie öffnen keinen Listener: Der Server läuft auf Ihrer Maschine, innerhalb der Sandbox des Clients, genau so lange, wie der Client ihn braucht. Der API-Host folgt automatisch der Region Ihres Logins; --base-url (oder BIRD_API_URL) überschreibt sie zum Testen gegen eine Nicht-Produktionsumgebung.

Was die Tools abdecken

Die Tools decken jeden Kanal ab, den Bird betreibt, plus die zugehörigen Account- und Konfigurationsaufgaben. Sie sind kuratiert und nicht die vollständige API-Oberfläche: Jedes Tool ist auf eine Aufgabe zugeschnitten, die ein Agent tatsächlich ausführt, und destruktive Operationen sind annotiert, damit Hosts vor der Ausführung nachfragen können.

E-Mail hat die meisten Tools, weil es die größte Konfigurationsoberfläche bietet. Die anderen Kanäle folgen demselben Sende-und-Lese-Muster.

Messaging

• E-Mail senden und prüfen: email_send, email_send_batch, email_list und email_get – Letzteres gibt die Nachricht mit ihrem aggregierten Zustellstatus zurück. Zustellstatus pro Empfänger und das Ereignisprotokoll sind separate Tool-Aufrufe.
• SMS senden und prüfen: sms_send, sms_send_batch, sms_get, sms_list und sms_list_events – analog zum E-Mail-Muster. sms_templates_list und sms_templates_get lesen den Vorlagenkatalog.
• WhatsApp senden und prüfen: whatsapp_send, whatsapp_get, whatsapp_list, whatsapp_list_events und whatsapp_media. Vorlagen sind eine vollständige Autorenoberfläche unter whatsapp_templates_*, einschließlich Inhalt pro Version und pro Sprache.
• Sprachanruf-Legs inspizieren: voice_legs_get und voice_legs_list lesen Anruf-Legs, mit Statistiken pro Land und pro Antwortcode unter voice_stats_*. voice_session_credentials_create erstellt die Workspace-Anmeldedaten, mit denen sich ein SIP- oder Softphone-Client authentifiziert.
• Empfänger verifizieren: verify_verifications_create sendet einen Einmal-Bestätigungscode, verify_verifications_check prüft, was der Empfänger eingegeben hat, und verify_verifications_next_channel weicht auf einen anderen Kanal aus.
• Sprachanruf erstellen (Vorschau): voice_calls_create bereitet einen ausgehenden Anruf vor und verwendet dazu die aktive Publikation einer aktivierten, nicht archivierten Sequenz. Eine Person prüft und führt die Anfrage im Browser aus; das Vorbereiten löst den Anruf nicht aus. Berechtigungen und Anweisungen zum erneuten Versuchen finden Sie unter Sprachanruf erstellen. Der lokale bird mcp-Server erfordert eine CLI-Version, die dieses Tool enthält.

Einen Kanal sendebereit machen

• Versanddomains einrichten: email_domains_create fügt eine Versanddomain hinzu und gibt die zu veröffentlichenden DNS-Einträge zurück; email_domains_verify prüft sie erneut; dazu email_domains_list und email_domains_get.
• SMS-Absender beanspruchen und registrieren: sms_senders_create beansprucht einen Absender, sms_senders_requirements meldet, was ein Land dafür verlangt, und sms_senders_registrations_create registriert ihn. US-A2P-Traffic läuft über die sms_10dlc_*-Tools für Marke, Kampagne und Einreichung.
• Nummern bereitstellen: numbers_available_list sucht, numbers_orders_create kauft, numbers_cancel gibt am Ende des Bezahlzeitraums zurück (oder sofort, wenn die Nummer kein Abonnement hat), und numbers_release gibt sofort zurück. whatsapp_numbers_precheck meldet, ob WhatsApp eine Nummer akzeptiert, bevor Sie sie bestellen.
• Prüfen, ob das Konto überhaupt senden kann: Die trust_*-Tools melden die Organisationsanforderungen, die den Kauf einer Nummer oder die Registrierung eines Absenders voraussetzen.

E-Mail-Zustellbarkeit

• E-Mail-Vorlagen erstellen: email_templates_create, email_templates_list, email_templates_get, email_templates_update, email_templates_duplicate und email_templates_preview (einen Entwurf mit Beispielwerten rendern, ohne zu senden). Versionen befinden sich unter email_templates_versions_*, wo email_templates_versions_submit einen Entwurf einfriert und ihn zur Version macht, die Sendungen ausliefern, und email_templates_versions_languages_* den sprachspezifischen Inhalt eines Entwurfs bearbeitet. Nichts, was ein Agent schreibt, erreicht einen Empfänger, bevor es übermittelt wird.
• Unterdrückungen verwalten: email_suppressions_list, email_suppressions_check (ist diese Adresse sicher zu besenden?), email_suppressions_add und email_suppressions_remove (als destruktiv annotiert, weil das Entfernen einer Unterdrückung ohne Grund die Absenderreputation beschädigt).
• Dedizierte IPs und Pools verwalten: email_dedicated_ips_create, email_dedicated_ips_list, email_dedicated_ips_get, email_dedicated_ips_assign (eine IP in einen Pool verschieben) und email_dedicated_ips_delete; dazu email_ip_pools_create, email_ip_pools_list, email_ip_pools_get, email_ip_pools_update und email_ip_pools_delete für die Pools, über die Sie Sendungen routen.

Zielgruppen und Konfiguration

• Kontakte und Zielgruppen verwalten: contacts_* und contact_properties_* für die Personen, an die Sie senden, audiences_* für die Listen, an die Sie senden, und preferences_* für Einwilligungen und Abmeldungen.
• Realtime bereitstellen: realtime_apps_* und realtime_apps_keys_* erstellen die Apps und Schlüssel, mit denen sich die Realtime-Clients verbinden.
• Jemanden nachschlagen: lookup_phone_number und lookup_email melden, was Bird über eine Adresse weiß, bevor Sie dorthin senden.
• Konfiguration prüfen: webhooks_list, workspace_get und whoami (der angemeldete Benutzer: ID, E-Mail, Name).

Ihr Client zeigt die aktuelle Tool-Liste mit Namen, Beschreibungen und Eingabe-Schemas an. Betrachten Sie diese Liste als maßgebliches Inventar. Eine gute erste Aufgabe zum Durchspielen:

Call whoami to find my email, then send me a test email from onboarding@messagebird.dev and tell me when it's delivered.

MCP oder die CLI?

Gleiche Oberfläche, gleiches Auth-Modell, unterschiedliche Aufrufer. Für shell-fähige Agenten (Claude Code, Cursors Terminal, CI) ist die CLI schlanker: JSON-Ausgabe, semantische Exit-Codes und deutlich weniger Tokens pro Vorgang. MCP ist für Hosts, die Tools aufrufen statt Shells auszuführen, und der gehostete Endpoint erreicht auch solche, die überhaupt keine Binärdatei ausführen können (Claude Desktop, ChatGPT, Mobilgeräte). Sie müssen sich nicht vorab entscheiden: Die gehostete URL erfordert keine Installation, und die lokale bird mcp ist bereits vorhanden, sobald die CLI installiert ist.

Nächste Schritte

• MCP Events: Abonnieren Sie Bird-Events für Ihren Client, z. B. neue E-Mails in einer Mailbox, und empfangen Sie jedes als signierten Webhook.
• E-Mail-Analysen per KI abfragen: Fragen Sie in natürlicher Sprache nach Zustellung, Engagement und Latenz.
• KI-Onboarding: die Schnellstart-Version dieser Seite, plus das maschinenlesbare Docs-Korpus.
• Agent Skills: das bird-ai-Marketplace-Plugin, Skills plus dieser MCP-Server, in einem Schritt installiert.
• CLI für Agenten: Bird über shell-fähige Agenten ohne MCP steuern – JSON-Ausgabe, semantische Exit-Codes, OAuth-Login.
• Authentifizierung: API-Schlüssel, Regionen und wie Anfragen autorisiert werden.