Ein guter MCP-Server gibt einem Agenten denselben Zugriff wie dem Benutzer. Er bezieht einen Menschen nur dort ein, wo ein Fehler teuer werden könnte, und lässt den Agenten alles andere eigenständig erledigen. Das braucht es dafür.
Tools, die der Agent korrekt auswählen kann
Der Agent muss aus Ihrer Anfrage eine Operation auswählen und die richtigen Argumente liefern. Prüfen Sie, ob die Tool-Beschreibungen erklären, was jede Operation tut und welche Argumente sie akzeptiert.
Suchen Sie mit einer Aufgabe wie dem Einrichten einer Versanddomain. Die Ergebnisse sollten das passende Tool und sein Input-Schema enthalten.
Bird generiert seine Tools aus dem API-Operationskatalog. Agentenbeschreibungen erklären ihre Verwendung. Der dynamische MCP-Endpunkt bietet search und execute. Die Suche liefert passende Tools, ihre Schemas, Effekt-Annotationen und relevante Prozeduren. Der Agent kann ein Tool vor dem Aufruf inspizieren.
Mensch in der Schleife, wo ein Fehler teuer werden könnte
Der Agent braucht einen Menschen in der Schleife, wo ein Fehler teuer werden könnte. Prüfen Sie, ob der Prüfbildschirm zeigt, was passieren wird. Prüfen Sie, ob der Agent anhand des gespeicherten Ergebnisses fortfahren kann.
Fehlende Details erfordern eine eigene Rückfrage. MCP nennt das Elicitation: Der Server fordert den Client auf, Informationen vom Menschen einzuholen. URL-Elicitation öffnet eine externe Interaktion, zum Beispiel einen Browser-Prüfbildschirm.
Bird nutzt Browser-Bestätigung für markierte Operationen, darunter Nummernbestellungen, eSIM-Bestellungen, 10DLC-Registrierungsoperationen und ausgehende Sprachanrufe. Der Agent bereitet die Anfrage vor und gibt einen Prüflink zurück. Sie prüfen und führen die Anfrage in Ihrem Browser aus. Das Annehmen der Elicitation öffnet die Prüfung. Das gespeicherte Operationsergebnis lässt den Agenten fortfahren. Die MCP-Einrichtungsanleitung erklärt, wie Sie Ihren Client verbinden.
Fehler, die der Agent selbst beheben kann
Ein Agent muss wissen, was fehlgeschlagen ist, was er ändern muss und was er als Nächstes aufrufen soll. Prüfen Sie ein abgelehntes Feld: Der Fehler sollte das Problem und die Aktion zu seiner Behebung benennen.
Bei einem vorübergehenden Fehler sollte die Antwort angeben, ob ein erneuter Versuch sinnvoll ist und wie lange der Agent warten soll. Wenn die Antwort auf eine folgenreiche Aktion verloren geht, muss der Agent zunächst feststellen, was passiert ist, bevor er es erneut versucht.
Die MCP-Fehlerantworten von Bird enthalten einen stabilen Code, Felddetails und eine Korrektur, falls verfügbar. Das Feld next beschreibt die nächste Aktion. retryable und retry_after teilen dem Agenten mit, ob und wann er den Aufruf wiederholen soll. Ein Bestätigungsbezeichner ermöglicht den Abruf des gespeicherten Status und Ergebnisses. Der API-Fehlerleitfaden beschreibt die Fehlerfelder.
Sicher handeln
Der Agent muss zwischen Lesezugriffen, Schreibzugriffen und destruktiven Aktionen unterscheiden können. Prüfen Sie die Wirkungshinweise des Tools und seine Regeln für wiederholte Anfragen.
Ein Idempotenzschlüssel identifiziert die beabsichtigte Aktion, sodass eine unterstützte Operation bei einer wiederholten Anfrage eine gespeicherte Antwort zurückgeben kann. Prüfen Sie das Wiedergabefenster und was der Agent nach dessen Ablauf tun soll.
Die Tools von Bird tragen Hinweise für schreibgeschützt, destruktiv und idempotent. Bei Operationen mit zwischengespeicherter Antwortwiedergabe beträgt das Standardfenster drei Stunden. Verwenden Sie denselben Schlüssel und dieselbe Anfrage innerhalb dieses Fensters erneut. Nach Ablauf kann ein erneuter Versuch die Aktion nochmals ausführen. Prüfen Sie den Status der Operation vor einem weiteren Versuch. Der Idempotenz-Leitfaden erläutert die operationsspezifischen Regeln.
Kennt das Produkt
Der Agent braucht Produktanleitungen, während er arbeitet. Stellen Sie eine Einrichtungsfrage und prüfen Sie, ob er die relevante Dokumentation finden und die vollständige Seite lesen kann.
Der Server sollte außerdem wiederverwendbare Prozeduren bereitstellen. Skills geben dem Agenten Aufgabenanleitungen und zugehörige Dateien, die er bei Bedarf laden kann.
Bird bietet docs_search für priorisierte Dokumentationsabschnitte und docs_read für eine vollständige Seite. Die Serveranweisungen enthalten verfasste Prozeduren. Skills über MCP stellt die Skills bird-cli und email-audit mit lesbaren Dateien und Datei-Digests bereit. Der Agent-Skills-Leitfaden beschreibt die abgedeckten Aufgaben.
Hält den Agenten auf dem Laufenden
Der Agent muss zwischen Annahme und Abschluss unterscheiden können. Prüfen Sie, ob ein Ergebnis Bezeichner und strukturierte Felder enthält, die er später wieder abrufen kann.
Bei Aufgaben, die erst später abgeschlossen werden, sollte der Client relevante Änderungen empfangen können. Eine Zustellbenachrichtigung beispielsweise ermöglicht es dem Agenten, nach der ersten Sendeantwort weiterzuarbeiten.
Bird gibt aufgezeichnete Bestätigungsergebnisse als strukturierte JSON zurück. E-Mail-Abfragen enthalten Nachrichtenstatus, Empfängerstatus und Ereignisse. Gehostete MCP-Ereignisse ermöglichen es Agenten, Ereignisse aufzulisten und signierte Benachrichtigungen zu abonnieren.
Zeigt Ergebnisse an
Der Mensch muss detaillierte Ergebnisse einsehen und darauf reagieren können. Prüfen Sie, ob Ihr Client MCP Apps rendert – die Erweiterung für interaktive Oberflächen innerhalb einer Konversation.
Eine nützliche Oberfläche ermöglicht es Ihnen, die zugrunde liegenden Datensätze einzusehen oder deren Status zu aktualisieren. ChatGPT, Claude Web und Desktop sowie VS Code GitHub Copilot unterstützen das Rendering von MCP Apps.
Der standardmäßige MCP-Endpunkt von Bird enthält Widgets für DNS-Verifizierung und E-Mail-Zustellung. Sie können DNS-Einträge einsehen und eine Sendedomain erneut prüfen. E-Mail-Ansichten zeigen Zustellstatus, Empfänger und eine Ereigniszeitleiste. Die Einrichtungsanleitung für MCP-Clients erklärt, wie Sie Ihren Client verbinden.
Verbindet mit einem Klick
Der Mensch braucht eine einfache Möglichkeit, den Agenten zu verbinden. Prüfen Sie, ob der Client den Server erkennen und die Anmeldung starten kann.
Der gehostete Server von Bird verbindet sich über OAuth im Browser. Die Anleitung zur Client-Verbindung behandelt Einrichtung und Anmeldung.
Bird ist im offiziellen MCP-Verzeichnis und in Claudes Connector-Verzeichnis gelistet. Die Anleitung zum Bird-Verzeichnis erklärt, wie Sie sich über Claude verbinden.
So prüfen Sie einen MCP-Server
Führen Sie eine echte Aufgabe von Anfang bis Ende durch und fragen Sie:
- Bekommt der Agent denselben Zugriff wie der Benutzer, ohne zusätzliche Einrichtung?
- Wählt er aus einer einfachen Anfrage das richtige Tool und die richtigen Argumente?
- Muss ein Mensch zustimmen, bevor etwas Kostspieliges passiert?
- Sagt der Fehler bei einem fehlgeschlagenen Aufruf, was zu beheben ist, was als Nächstes aufzurufen ist und ob ein erneuter Versuch sinnvoll ist?
- Kann der Agent es erneut versuchen, ohne dieselbe Aktion doppelt auszuführen?
- Kann er die Produktdokumentation und Anleitungen selbstständig nachschlagen?
- Kann er prüfen, was danach passiert ist, und über Änderungen informiert werden?
- Können Sie das Ergebnis in Ihrem Client sehen, statt nur darüber zu lesen?