Een goede MCP-server geeft een agent dezelfde toegang als de gebruiker. Hij schakelt alleen een mens in waar een fout duur kan uitvallen, en laat de agent al het andere zelfstandig afhandelen. Dit is wat daarvoor nodig is.
Tools die de agent correct kan kiezen
De agent moet een operatie uit je verzoek kiezen en de juiste argumenten meegeven. Controleer of toolbeschrijvingen uitleggen wat elke operatie doet en welke argumenten hij accepteert.
Probeer te zoeken met een taak zoals het instellen van een verzenddomein. De resultaten moeten de bijbehorende tool en het invoerschema bevatten.
Bird genereert zijn tools uit de API-operatiecatalogus. Agentbeschrijvingen leggen uit hoe je ze gebruikt. Het dynamische MCP-endpoint biedt search en execute. Zoeken levert overeenkomende tools, hun schema's, effectannotaties en relevante procedures op. De agent kan een tool inspecteren voordat hij hem aanroept.
Mens in de loop waar een fout duur kan uitvallen
De agent heeft een mens in de loop nodig waar een fout duur kan uitvallen. Controleer of het beoordelingsscherm laat zien wat er zal gebeuren. Controleer of de agent kan hervatten vanuit het opgeslagen resultaat.
Ontbrekende details vragen om een aparte vraag. MCP noemt dit elicitatie: de server vraagt de client om informatie op te halen bij de mens. URL-elicitatie opent een externe interactie, zoals een beoordelingsscherm in de browser.
Bird gebruikt browserbevestiging voor gemarkeerde operaties, waaronder nummerbestellingen, eSIM-bestellingen, 10DLC-registratieoperaties en uitgaande spraakoproepen. De agent bereidt het verzoek voor en geeft een beoordelingslink terug. Je bekijkt en voert het verzoek uit in je browser. Het accepteren van de elicitatie opent de beoordeling. Het opgeslagen operatieresultaat laat de agent hervatten. De MCP-installatiegids legt uit hoe je je client verbindt.
Fouten die de agent zelf kan oplossen
Een agent moet weten wat er misging, wat er moet veranderen en wat de volgende aanroep is. Controleer een afgewezen veld: de fout moet het probleem en de oplossende actie benoemen.
Bij een tijdelijke fout moet het antwoord aangeven of de aanroep herhaald kan worden en hoe lang de agent moet wachten. Als het antwoord op een consequentiële actie verloren gaat, moet de agent eerst vaststellen wat er is gebeurd voordat hij het opnieuw probeert.
De foutantwoorden van Bird MCP bevatten een stabiele code, velddetails en een correctie als die beschikbaar is. Het veld next beschrijft de volgende actie. retryable en retry_after vertellen de agent of en wanneer hij de aanroep moet herhalen. Een bevestigings-ID laat hem de opgeslagen status en het resultaat ophalen. De foutengids voor API beschrijft de foutvelden.
Veilig handelen
De agent moet onderscheid maken tussen leesbewerkingen, schrijfbewerkingen en destructieve acties. Bekijk de effecthints van de tool en de regels voor het herhalen van een verzoek.
Een idempotentiesleutel identificeert de beoogde actie, zodat een ondersteunde bewerking bij een herhaald verzoek een bewaard antwoord kan teruggeven. Controleer het replayvenster en wat de agent moet doen als het verloopt.
De tools van Bird bevatten hints voor alleen-lezen, destructief en idempotent. Bij bewerkingen met cached response replay is het standaardvenster drie uur. Hergebruik dezelfde sleutel en hetzelfde verzoek binnen dat venster. Na het verlopen kan een nieuwe poging de actie opnieuw uitvoeren. Controleer de status van de bewerking voordat je het opnieuw probeert. De idempotentiegids beschrijft de bewerkingsspecifieke regels.
Kent het product
De agent heeft productinstructies nodig terwijl hij werkt. Stel een setupvraag en controleer of hij de relevante documentatie kan vinden en de volledige pagina kan lezen.
De server moet ook herbruikbare procedures aanbieden. Skills geven de agent taakinstructies en ondersteunende bestanden die hij kan laden wanneer nodig.
Bird biedt docs_search voor gerangschikte documentatiesecties en docs_read voor een volledige pagina. De serverinstructies bevatten geschreven procedures. Skills via MCP stelt de skills bird-cli en email-audit beschikbaar met leesbare bestanden en bestandsdigests. De gids voor agentskills beschrijft de taken die ze dekken.
Houdt de agent op de hoogte
De agent moet acceptatie van voltooiing kunnen onderscheiden. Controleer of een resultaat identifiers en gestructureerde velden bevat die hij later kan uitlezen.
Voor werk dat later klaar is, moet de client relevante wijzigingen kunnen ontvangen. Een aflevernotificatie laat de agent bijvoorbeeld verdergaan na het eerste verzendantwoord.
Bird retourneert vastgelegde bevestigingsresultaten als gestructureerde JSON. E-mailuitlezingen bevatten berichtstatus, ontvangerstatus en events. Gehoste MCP Events laat agents events opvragen en zich abonneren op ondertekende notificaties.
Toont resultaten
De gebruiker moet gedetailleerde resultaten kunnen bekijken en erop kunnen handelen. Controleer of je client MCP Apps rendert, de extensie voor interactieve interfaces in een gesprek.
Een bruikbare interface laat je de onderliggende records bekijken of hun status vernieuwen. ChatGPT, Claude web en Desktop, en VS Code GitHub Copilot ondersteunen MCP Apps-rendering.
Het standaard MCP-endpoint van Bird bevat DNS-verificatie- en e-mailbezorgingswidgets. Je kunt DNS-records bekijken en een verzenddomein opnieuw controleren. E-mailweergaven tonen bezorgstatus, ontvangers en een eventtijdlijn. De setupgids voor MCP-clients legt uit hoe je je client verbindt.
Verbindt met één klik
De gebruiker heeft een duidelijke manier nodig om de agent te verbinden. Controleer of de client de server kan vinden en aanmelding kan starten.
De gehoste server van Bird verbindt via browser-OAuth. De instructies voor clientverbinding behandelen setup en aanmelding.
Bird staat in het officiële MCP-register en in de connectordirectory van Claude. De directoryinstructies voor Bird leggen uit hoe je verbinding maakt vanuit Claude.
Hoe je een MCP-server controleert
Voer één echte taak van begin tot eind uit en stel deze vragen:
- Krijgt de agent dezelfde toegang als de gebruiker, zonder extra configuratie?
- Kiest hij de juiste tool en argumenten op basis van een gewoon verzoek?
- Krijgt een mens de kans om goed te keuren voordat er iets kostbaars gebeurt?
- Wanneer een aanroep mislukt, zegt de fout dan wat je moet herstellen, wat je daarna moet aanroepen en of je het opnieuw moet proberen?
- Kan de agent opnieuw proberen zonder dezelfde actie twee keer uit te voeren?
- Kan hij zelfstandig de documentatie en handleidingen van het product opzoeken?
- Kan hij controleren wat er daarna is gebeurd, en op de hoogte blijven van wijzigingen?
- Kun je het resultaat in je client zien, in plaats van er alleen over te lezen?