Platform

Was ist ein MCP-Server und wie nutzt ein Agent ihn zum Senden von Nachrichten?

Ein MCP-Server stellt KI-Clients aufrufbare Tools bereit; ein Agent sendet über Bird, indem er das Send-Tool eines Kanals aufruft.

Ein Assistent, der eine Zustellbenachrichtigung vorbereitet, benötigt Zugriff auf Absender, Empfänger und Nachrichteninhalt. Ein verbundenes Tool lässt ihn diese Felder übermitteln, ohne Ihre Zugangsdaten in die Konversation einzufügen.

MCP ist das Protokoll, das die Anwendung mit diesen Tools verbindet.

Was stellt der MCP-Server bereit?

Der Server liefert Ihrem KI-Client Tool-Namen, Input-Schemas und aufrufbare Operationen.

Im MCP-Tool-Modell entdeckt der Client die verfügbaren Tools. Er übermittelt strukturierte Argumente, wenn der Agent eines auswählt.

Die Tools von Bird umfassen den Versand von E-Mail-, SMS- und WhatsApp-Nachrichten. Setup-Tools verwalten Sendedomains, Nummern und Absenderanforderungen. Verifizierungs-Tools starten eine Verifizierung. Sie prüfen auch Codes. Ein separates Tool wechselt zu einem anderen Kanal.

Die verfügbare Tool-Liste in Ihrem Client identifiziert jede Operation und ihre erforderlichen Eingaben. Prüfen Sie diese Liste, wenn eine erwartete Operation fehlt.

Wie verbinde ich mich mit dem gehosteten Server?

Fügen Sie https://mcp.bird.com als Remote-MCP-Server hinzu. Melden Sie sich über den Browser an.

Sie müssen die CLI nicht installieren und keinen API-Schlüssel angeben. Die Browser-Anmeldung lässt den Client ein Token mit einer Teilmenge Ihrer Berechtigungen halten. Bird prüft jede Anfrage gegen die Berechtigungen in diesem Token.

Einige Clients zeigen den Server als authentifizierungsbedürftig an, bis Sie die Anmeldung starten. Ein Client mit nur der URL kann Tools auflisten. Ohne Authentifizierung kann ein Tool-Aufruf 401 zurückgeben.

Schließen Sie die Authentifizierung ab, bevor Sie einen Tool-Aufruf testen. Die Verbindungsanleitung beschreibt die Einrichtungsschritte für unterstützte Clients.

Wie sendet und prüft ein Agent eine Nachricht?

Stellen Sie sicher, dass der Empfänger der Nachricht zugestimmt hat und der Inhalt Ihren geltenden Richtlinien entspricht. Rufen Sie das Send-Tool des Kanals auf. Lesen Sie die Zustellevents der resultierenden Nachricht.

Für E-Mail ist die Abfolge:

  1. Workspace, Sendeidentität, Empfänger und Inhalt bestätigen.
  2. email_send mit den erforderlichen Feldern aus seinem Input-Schema aufrufen.
  3. Die zurückgegebene Nachrichten-ID speichern.
  4. email_get verwenden, um Zustellstatus, Empfängerergebnisse und den Event-Verlauf zu prüfen.

Ein angenommener Versand beweist nicht die Zustellung. Ein späterer Bounce oder eine Ablehnung erfordert, dass Ihr Agent oder Ihre Anwendung den Fehler behandelt.

Ein fehlender Absender oder fehlende Berechtigung kann den Versand verhindern. Setup- und Diagnose-Tools lassen den Agenten diese Anforderungen prüfen, bevor er es erneut versucht.

Kann ich den Server lokal betreiben?

Ja. Installieren Sie die Bird CLI. Melden Sie sich mit bird auth login an. Konfigurieren Sie Ihren Client so, dass er bird mcp startet.

Der Client startet den Prozess. Er kommuniziert über die Ein- und Ausgabestreams des Prozesses. Er benötigt bird als Befehl und mcp als Argument.

Der lokale und der gehostete Server stellen dasselbe Toolset bereit. Der lokal laufende Prozess benötigt weiterhin Netzwerkzugang für Bird-API-Operationen.

Verwenden Sie den lokalen Prozess, wenn Sie ihn selbst verwalten möchten. Ihr Client muss in der Lage sein, Befehle zu starten. Verwenden Sie die gehostete URL, wenn er keine lokale Binary ausführen kann.

Was steuert, welche Aktionen der Agent ausführen kann?

Die verbundenen Zugangsdaten begrenzen den Zugriff. Ihr KI-Host steuert, wann die Tool-Ausführung eine Bestätigung erfordert.

Bird annotiert destruktive Tools, damit der Host sie erkennen kann. Das Entfernen einer E-Mail-Unterdrückung ist beispielsweise als destruktiv markiert, weil es unerwünschten Versand wieder aufnehmen kann.

Annotationen erzwingen nicht automatisch eine Genehmigungsaufforderung. Konfigurieren Sie die Richtlinie Ihres Hosts, bevor Sie Änderungen an Produktionsressourcen zulassen.

Ein Agent, der ein E-Mail-Template entwerfen und einreichen kann, kann es auch veröffentlichen. Ein Entwurfsschritt allein hindert den Agenten nicht daran, das Submit-Tool aufzurufen.

Die Template-Einreichung über WhatsApp sendet das Template an Meta zur Prüfung. Sie bietet keinen menschlichen Genehmigungsschritt für jede andere Aktion, die der Agent ausführen kann.

Voice-Tools inspizieren Anrufe. Sie stellen auch Client-Zugangsdaten aus. Kein MCP-Tool tätigt einen Sprachanruf. Die CLI stellt die Testanruf-Operation bereit.

Für shellfähige Agenten liefert die CLI JSON-Ausgabe und Exit-Codes. Wählen Sie die Schnittstelle, die Ihr Host ausführen kann. Legen Sie deren Bestätigungsrichtlinie für die vorgesehenen Aktionen fest.

Kurz gesagt

  1. Verbinden und anmelden.

    Der gehostete Server benötigt seine URL und eine Browser-Autorisierung. Die URL allein autorisiert keine Tool-Aufrufe.

  2. Gehosteten oder lokalen Zugriff wählen.

    Verwenden Sie https://mcp.bird.com für Remote-Clients oder lassen Sie Ihren Client bird mcp nach der CLI-Anmeldung starten.

  3. Die Nachricht nach dem Senden verfolgen.

    Ein Sendeergebnis bestätigt die Annahme. Lesen Sie die Nachricht und ihre Events, um die Zustellung zu prüfen.

  4. Bestätigungsrichtlinie des Hosts konfigurieren.

    Tool-Annotationen beschreiben Aktionen, erzwingen aber keine Genehmigung. Ihr Host entscheidet, wann er vor der Ausführung nachfragt.

Bauen Sie auf demselben Netzwerk auf.

Ein Test-API-Schlüssel steht Ihnen sofort zur Verfügung. Der Produktivbetrieb wird freigeschaltet, sobald Sie eine Zahlungsmethode hinzufügen und einen Absender verifizieren.

Ihre nächste Idee.
Bereit zur Verbindung.