Wat is een MCP-server en hoe gebruikt een agent er een om berichten te versturen?

Een assistent die een aflevermelding regelt, heeft toegang nodig tot de afzender, de ontvanger en de berichtinhoud. Een verbonden tool laat hem die velden indienen zonder je credential in het gesprek te plaatsen.

MCP is het protocol dat de applicatie met die tools verbindt.

Wat biedt de MCP-server?

De server geeft je AI-client toolnamen, invoerschema's en aanroepbare bewerkingen.

Binnen het MCP-toolmodel ontdekt de client tools. Hij stuurt gestructureerde argumenten wanneer de agent er een selecteert.

De tools van Bird omvatten het versturen van e-mail-, SMS- en WhatsApp-berichten. Setup-tools beheren verzenddomeinen, nummers en afzendervereisten. Verificatietools starten een verificatie. Ze controleren ook codes. Een aparte tool schakelt door naar een ander kanaal.

De beschikbare toollijst in je client identificeert elke bewerking en de vereiste invoer. Controleer die lijst wanneer een verwachte bewerking ontbreekt.

Hoe verbind ik met de gehoste server?

Voeg https://mcp.bird.com toe als externe MCP-server. Log in via de browser.

Je hoeft de CLI niet te installeren en geen API-sleutel op te geven. Browseraanmelding laat de client een token vasthouden met een subset van je rechten. Bird controleert elk verzoek aan de hand van de rechten in dat token.

Sommige clients tonen de server als authenticatie vereisend totdat je de aanmelding start. Een client met alleen de URL kan tools opvragen. Zonder authenticatie kan een tool-aanroep 401 retourneren.

Rond de authenticatie af voordat je een tool-aanroep test. De verbindingsgids bevat de setupstappen voor ondersteunde clients.

Hoe verstuurt en controleert een agent een bericht?

Bevestig dat de ontvanger toestemming heeft gegeven voor het bericht en dat de inhoud aan je toepasselijke beleid voldoet. Roep de send-tool van het kanaal aan. Lees de afleverevents van het resulterende bericht.

Voor e-mail is de volgorde:

1. Bevestig de werkruimte, verzendidentiteit, ontvanger en inhoud.
2. Roep email_send aan met de vereiste velden uit het invoerschema.
3. Sla het geretourneerde bericht-ID op.
4. Gebruik email_get om de afleveringsstatus, ontvangersresultaten en de eventtijdlijn te inspecteren.

Een geaccepteerde verzending bewijst geen aankomst. Een latere bounce of weigering vereist dat je agent of applicatie de fout afhandelt.

Een ontbrekende afzender of ontbrekend recht kan de verzending verhinderen. Setup- en diagnostische tools laten de agent die vereisten inspecteren voordat hij het opnieuw probeert.

Kan ik de server lokaal draaien?

Ja. Installeer de Bird CLI. Log in met bird auth login. Configureer je client om bird mcp te starten.

De client start het proces. Hij communiceert via de invoer- en uitvoerstromen van het proces. Hij heeft bird als commando en mcp als argument nodig.

De lokale en gehoste servers bieden dezelfde toolset. Het proces lokaal draaien vereist nog steeds netwerktoegang voor Bird API-bewerkingen.

Gebruik het lokale proces als je het zelf wilt beheren. Je client moet commando's kunnen starten. Gebruik de gehoste URL als hij geen lokaal binair bestand kan uitvoeren.

Wat bepaalt welke acties de agent kan uitvoeren?

De verbonden credential beperkt de toegang. Je AI-host bepaalt wanneer de uitvoering van een tool bevestiging vereist.

Bird annoteert destructieve tools zodat de host ze kan herkennen. Het verwijderen van een e-mailonderdrukking is bijvoorbeeld als destructief gemarkeerd omdat het ongewenste verzending kan hervatten.

Annotaties dwingen op zichzelf geen goedkeuringsprompt af. Configureer het beleid van je host voordat je wijzigingen aan productieresources toestaat.

Een agent die een e-mailtemplate kan opstellen en indienen, kan het ook publiceren. Een conceptstap alleen verhindert niet dat de agent de submit-tool aanroept.

WhatsApp-templateindiening stuurt het template naar Meta ter beoordeling. Het biedt geen menselijke goedkeuringsstap voor elke andere actie die de agent kan uitvoeren.

Voice-tools inspecteren gesprekken. Ze geven ook clientcredentials uit. Geen enkele MCP-tool plaatst een spraakoproep. De CLI biedt de testoproep-bewerking.

Voor shell-capabele agents biedt de CLI JSON-uitvoer en exitcodes. Kies de interface die je host kan uitvoeren. Stel het bevestigingsbeleid in voor de beoogde acties.