Un buon server MCP dà all'agente lo stesso accesso dell'utente. Coinvolge un umano nel processo solo dove un errore potrebbe essere costoso, e lascia che l'agente gestisca tutto il resto in autonomia. Ecco cosa serve.
Strumenti che l'agente può scegliere correttamente
L'agente deve scegliere un'operazione dalla tua richiesta e fornire gli argomenti corretti. Verifica che le descrizioni degli strumenti spieghino cosa fa ogni operazione e quali argomenti accetta.
Prova a cercare un'attività come la configurazione di un dominio di invio. I risultati dovrebbero includere lo strumento corrispondente e il suo schema di input.
Bird genera i propri strumenti dal catalogo di operazioni API. Le descrizioni per agenti spiegano come usarli. L'endpoint dinamico MCP offre search e execute. La ricerca restituisce gli strumenti corrispondenti, i relativi schemi, le annotazioni sugli effetti e le procedure pertinenti. L'agente può ispezionare uno strumento prima di chiamarlo.
Umano nel processo dove un errore potrebbe essere costoso
L'agente ha bisogno di un umano nel processo dove un errore potrebbe essere costoso. Verifica che la schermata di revisione mostri cosa accadrà. Verifica se l'agente può riprendere dal risultato registrato.
I dettagli mancanti richiedono una domanda separata. MCP chiama questo meccanismo elicitation: il server chiede al client di ottenere informazioni dall'umano. L'elicitation tramite URL apre un'interazione esterna, come una schermata di revisione nel browser.
Bird usa la conferma nel browser per le operazioni contrassegnate, inclusi ordini di numeri, ordini eSIM, operazioni di registrazione 10DLC e chiamate vocali in uscita. L'agente prepara la richiesta e restituisce un link di revisione. Tu rivedi ed esegui la richiesta nel browser. Accettare l'elicitation apre la revisione. Il risultato dell'operazione registrato permette all'agente di riprendere. La guida alla configurazione MCP spiega come collegare il tuo client.
Errori che l'agente può correggere da solo
Un agente deve sapere cosa è fallito, cosa modificare e cosa chiamare dopo. Verifica un campo rifiutato: l'errore dovrebbe identificare il problema e l'azione che lo risolve.
Per un errore temporaneo, la risposta dovrebbe indicare se riprovare e quanto attendere. Dopo una risposta persa per un'azione consequenziale, l'agente deve accertare cosa è successo prima di riprovare.
Le risposte di errore MCP di Bird includono un codice stabile, i dettagli del campo e una correzione quando disponibile. Il campo next descrive l'azione successiva. retryable e retry_after indicano all'agente se e quando ripetere la chiamata. Un identificatore di conferma consente di recuperare lo stato e il risultato salvati. La guida agli errori API descrive i campi di errore.
Sicuro nell'agire
L'agente deve distinguere letture, scritture e azioni distruttive. Ispeziona gli hint sugli effetti dello strumento e le sue regole per ripetere una richiesta.
Una chiave di idempotenza identifica l'azione prevista, così un'operazione supportata può restituire una risposta conservata su una richiesta ripetuta. Verifica la finestra di replay e cosa l'agente deve fare dopo la sua scadenza.
Gli strumenti di Bird includono hint read-only, destructive e idempotent. Sulle operazioni con replay della risposta in cache, la finestra predefinita è di tre ore. Riutilizza la stessa chiave e richiesta entro quella finestra. Dopo la scadenza, un nuovo tentativo può eseguire di nuovo l'azione. Verifica lo stato dell'operazione prima di un altro tentativo. La guida all'idempotenza spiega le regole specifiche per operazione.
Conosce il prodotto
L'agente ha bisogno delle istruzioni del prodotto mentre lavora. Poni una domanda di configurazione e verifica se riesce a trovare la documentazione pertinente e leggere la pagina completa.
Il server dovrebbe anche esporre procedure riutilizzabili. Le skill forniscono all'agente istruzioni sui task e file di supporto che può caricare quando necessario.
Bird fornisce docs_search per sezioni di documentazione ordinate per rilevanza e docs_read per una pagina completa. Le sue istruzioni server includono procedure scritte. Skills over MCP espone le skill bird-cli e email-audit con file leggibili e digest dei file. La guida alle skill dell'agente descrive i task che coprono.
Tiene l'agente informato
L'agente deve distinguere l'accettazione dal completamento. Verifica se un risultato include identificatori e campi strutturati che può rileggere in seguito.
Per operazioni che terminano dopo, il client deve poter ricevere le modifiche pertinenti. Una notifica di consegna, ad esempio, permette all'agente di proseguire dopo la risposta iniziale di invio.
Bird restituisce i risultati di conferma registrati come JSON strutturati. Le letture email includono lo stato del messaggio, lo stato del destinatario e gli eventi. MCP Events in hosting consente agli agenti di elencare eventi e iscriversi a notifiche firmate.
Mostra i risultati
L'utente deve poter esaminare i risultati in dettaglio e agire di conseguenza. Verifica se il tuo client visualizza MCP Apps, l'estensione per interfacce interattive all'interno di una conversazione.
Un'interfaccia utile permette di esaminare i record sottostanti o aggiornarne lo stato. ChatGPT, Claude web e Desktop e VS Code GitHub Copilot supportano il rendering di MCP Apps.
L'endpoint standard MCP di Bird include widget per la verifica DNS e la consegna email. Puoi esaminare i record DNS e ricontrollare un dominio di invio. Le viste email mostrano lo stato di consegna, i destinatari e una timeline degli eventi. La guida alla configurazione del client MCP spiega come collegare il tuo client.
Connessione in un clic
L'utente ha bisogno di un modo chiaro per collegare l'agente. Verifica se il client riesce a individuare il server e avviare l'accesso.
Il server in hosting di Bird si collega tramite OAuth nel browser. Le istruzioni di connessione del client descrivono configurazione e accesso.
Bird è presente nel registro ufficiale MCP e nella directory dei connettori di Claude. Le istruzioni per la directory Bird spiegano come connettersi da Claude.
Come verificare un server MCP
Esegui un'attività reale dall'inizio alla fine e chiediti:
- L'agente ottiene lo stesso accesso dell'utente, senza configurazioni aggiuntive?
- Sceglie lo strumento e gli argomenti giusti a partire da una richiesta in linguaggio naturale?
- Prima di qualsiasi operazione costosa, un essere umano può approvarla?
- Quando una chiamata fallisce, l'errore indica cosa correggere, cosa chiamare dopo e se riprovare?
- L'agente può riprovare senza eseguire la stessa azione due volte?
- È in grado di consultare autonomamente la documentazione e le guide pratiche del prodotto?
- Può verificare cosa è successo in seguito e ricevere notifiche sui cambiamenti?
- Puoi vedere il risultato nel tuo client, non solo leggerne una descrizione?