Cos'è un server MCP e come lo usa un agente per inviare messaggi?

Un assistente che organizza una notifica di consegna ha bisogno di accesso al mittente, al destinatario e al contenuto del messaggio. Un tool connesso gli permette di inviare quei campi senza esporre la tua credenziale nella conversazione.

MCP è il protocollo che connette l'applicazione a quei tool.

Cosa fornisce il server MCP?

Il server fornisce al tuo client AI nomi dei tool, schemi di input e operazioni richiamabili.

Secondo il modello tool di MCP, il client scopre i tool disponibili. Invia argomenti strutturati quando l'agente ne seleziona uno.

I tool di Bird includono l'invio di email, messaggi SMS e WhatsApp. I tool di configurazione gestiscono domini di invio, numeri e requisiti del mittente. I tool di verifica avviano una verifica. Controllano anche i codici. Un tool separato passa a un altro canale.

L'elenco dei tool disponibili nel tuo client identifica ogni operazione e i suoi input obbligatori. Controlla quell'elenco quando un'operazione attesa è assente.

Come mi connetto al server hosted?

Aggiungi https://mcp.bird.com come server MCP remoto. Accedi tramite il browser.

Non è necessario installare CLI né fornire una chiave API. L'accesso via browser consente al client di detenere un token con un sottoinsieme dei tuoi permessi. Bird verifica ogni richiesta rispetto ai permessi contenuti in quel token.

Alcuni client mostrano il server come bisognoso di autenticazione finché non avvii l'accesso. Un client con il solo URL può elencare i tool. Senza autenticazione, una chiamata a un tool può restituire 401.

Completa l'autenticazione prima di testare una chiamata a un tool. La guida alla connessione fornisce i passaggi di configurazione per i client supportati.

Come invia e controlla un messaggio un agente?

Verifica che il destinatario abbia acconsentito al messaggio e che il contenuto rispetti la tua policy applicabile. Chiama il tool di invio del canale. Leggi gli eventi di consegna del messaggio risultante.

Per l'email, la sequenza è:

1. Conferma lo spazio di lavoro, l'identità di invio, il destinatario e il contenuto.
2. Chiama email_send con i campi obbligatori dal suo schema di input.
3. Salva l'ID del messaggio restituito.
4. Usa email_get per ispezionare lo stato di consegna, i risultati per destinatario e la cronologia degli eventi.

Un invio accettato non dimostra l'arrivo. Un bounce o un rifiuto successivo richiede che il tuo agente o la tua applicazione gestisca il fallimento.

Un mittente o un permesso mancante può impedire l'invio. I tool di configurazione e diagnostica consentono all'agente di ispezionare quei requisiti prima di riprovare.

Posso eseguire il server in locale?

Sì. Installa Bird CLI. Accedi con bird auth login. Configura il tuo client per avviare bird mcp.

Il client avvia il processo. Comunica attraverso i flussi di input e output del processo. Richiede bird come comando e mcp come argomento.

Il server locale e quello hosted espongono lo stesso set di tool. Eseguire il processo in locale richiede comunque l'accesso alla rete per le operazioni Bird API.

Usa il processo locale quando vuoi gestirlo tu. Il tuo client deve poter avviare comandi. Usa l'URL hosted quando non può eseguire un binario locale.

Cosa controlla quali azioni può eseguire l'agente?

La credenziale connessa limita l'accesso. Il tuo host AI controlla quando l'esecuzione di un tool richiede conferma.

Bird annota i tool distruttivi in modo che l'host possa riconoscerli. Ad esempio, la rimozione di una soppressione email è contrassegnata come distruttiva perché può ripristinare un invio indesiderato.

Le annotazioni di per sé non forzano una richiesta di approvazione. Configura la policy del tuo host prima di consentire modifiche alle risorse di produzione.

Un agente che può creare e inviare un template email può anche pubblicarlo. Un passaggio di bozza da solo non impedisce all'agente di chiamare il tool di invio.

L'invio di un template WhatsApp invia il template a Meta per la revisione. Non fornisce un passaggio di approvazione umana per ogni altra azione che l'agente può eseguire.

I tool vocali ispezionano le chiamate. Emettono anche credenziali client. Nessun tool MCP effettua una chiamata vocale. CLI fornisce l'operazione di chiamata di test.

Per gli agenti con accesso alla shell, CLI fornisce output JSON e codici di uscita. Scegli l'interfaccia che il tuo host può eseguire. Imposta la sua policy di conferma per le azioni previste.