Onboarding AI
Usa la bird CLI e le skill di Bird quando il tuo coding agent può eseguire comandi shell. Usa il server MCP hosted quando il tuo client chiama tool invece. Entrambe le superfici possono cercare nella documentazione e gli agent senza tool possono leggere il corpus Markdown pubblicato. Inizia con CLI a meno che il tuo client non richieda MCP.
1. Configura il tuo agent (CLI + skill)
Incolla il prompt di configurazione nel tuo coding agent. Installa la bird CLI, ti autentica con bird auth login, installa le skill di Bird e invia un'email di prova per confermare la configurazione. I pulsanti Claude Code, Codex e Cursor nelle pagine prodotto di Bird copiano un prompt personalizzato per ogni client. Configura il tuo coding agent illustra lo stesso flusso.
2. Connetti il server MCP (quando è il caso)
Se il tuo client chiama tool invece di eseguire una shell, puntalo al server MCP hosted di Bird. Ti servono solo l'URL e un accesso dal browser:
Esempio di codice
https://mcp.bird.comL'endpoint usa OAuth, quindi autenticati una sola volta per ogni client. Il browser apre una schermata di consenso Bird in cui accedi, scegli uno spazio di lavoro e i permessi e approvi l'accesso. Non hai bisogno di una chiave API né di un segreto nella configurazione del client. Segui i passaggi di connessione per il tuo client. La guida al server MCP copre anche la superficie dei tool, il OAuth delegato e l'opzione bird mcp locale.
3. Fornisci la documentazione al tuo agent
Se il tuo agent ha i tool Bird dal passaggio 1 o 2, può già leggere questa documentazione: docs_search trova le pagine per query e docs_read ne restituisce una come Markdown. Da una shell i comandi sono bird docs search "ip warmup" e bird docs read <slug>. Preferisci questo al caricamento del corpus perché l'agent recupera solo la pagina corrente di cui ha bisogno.
Per gli agent che non possono chiamare tool, l'intero sito è pubblicato come Markdown:
- /llms.txt: l'indice, un riepilogo piatto e ricco di link di ogni pagina, un punto di partenza da cui l'agent può seguire i link.
- /llms-full.txt: il corpus completo, tutte le pagine della documentazione concatenate come Markdown, per gli agent che vogliono tutto nel contesto.
Entrambi i file vengono rigenerati a ogni deploy del sito. Puoi anche usare gli strumenti AI nella barra laterale di una pagina della documentazione: Copy as Markdown copia quella pagina e Open llms-full.txt apre il corpus. La pagina email onboarding della dashboard offre le stesse scorciatoie Copy for AI.
I formati, le dimensioni e i suggerimenti per il recupero sono trattati nella guida llms.txt.
4. Provalo
Una volta configurato il tuo agent, assegnagli un compito reale dall'inizio alla fine:
Find my email with whoami, then send me a test email from onboarding@messagebird.dev and tell me when it's delivered.
L'agent legge il tuo indirizzo con whoami, invia dal dominio di onboarding condiviso di Bird e interroga lo stato finché il messaggio non raggiunge la tua casella di posta. Il dominio di onboarding può inviare ai membri verificati del tuo spazio di lavoro senza verifica del dominio. Per un controllo deterministico senza una vera casella di posta, invia invece a delivered@messagebird.dev; vedi la sandbox di test.
Passaggi successivi
- Registrazione self-serve: per un agent che ha bisogno di un proprio account Bird anziché del tuo. Crea account, organizzazione e spazio di lavoro dal terminale, senza browser.
- CLI per agent: il contratto agent della bird CLI. Output JSON, exit code semantici, login OAuth.
- Skill degli agent: il plugin marketplace bird-ai e cosa ottiene ogni client.
- Server MCP: l'endpoint hosted, la superficie completa dei tool, il modello OAuth delegato e l'opzione local-stdio.
- llms.txt e documentazione Markdown: come viene costruito il corpus leggibile dalle macchine e come recuperarlo.
- Invia la tua prima email: completa lo stesso flusso email senza un agent.
- Configurare il tuo agente di codifica: un video che connette un agent e invia un'email di prova attraverso di esso
Risorse correlate
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.
Guarda la guidaTesting email without spamming anyoneComprendi il concettoWhat is an MCP server, and how does an agent use one to send messages?Esplora la funzionalitàCoding agentsSegui il percorso di apprendimentoBuild with AI agents
Ottieni un brief di implementazione