Configura il tuo agente di programmazione
Collega il tuo agente di programmazione a Bird, conferma lo spazio di lavoro che può usare e completa una prima attività per il prodotto che stai sviluppando. Usa una connessione MCP esistente o una CLI con accesso già effettuato, se disponibili. Il prompt di configurazione guida l'agente nella scelta.
Una connessione riuscita consente di accedere al tuo spazio di lavoro. Per inviare un messaggio, effettuare una chiamata o configurare un altro prodotto, devi anche configurare l'account, il mittente, il numero o il dispositivo di quel prodotto. Segui la guida del prodotto pertinente prima di eseguire la prima operazione.
Copia questo prompt nel tuo agente
Esempio di codice
Help me connect my coding agent to Bird and complete a first task.
1. Inspect the available Bird MCP connection or CLI installation and its sign-in state. Use whichever is already authenticated, and confirm its account and workspace; either is sufficient.
2. If neither is authenticated, follow the current per-client setup instructions at https://bird.com/docs/ai/set-up-your-agent.md. Read the Markdown guide. Complete the browser sign-in and confirm the account and workspace you will use.
3. Read the Bird product guide for my task. Before proposing changes, make a read-only inventory of my integration's call sites, identifiers and configured URLs. Identify the required permissions and account, sender, number or device setup.
4. Prepare a first example for the product and the recipient or destination I choose. Use published operations from the available CLI or MCP surface. Before any paid send or submission, show me the exact prepared action and applicable charges, and get my explicit approval. If the surface does not quote a price, ask the account owner to confirm the charges before proceeding; do not estimate them or submit the operation while they remain unknown.
5. Follow the operation through to its actual result. Explain remaining setup, rejected work or an uncertain outcome, and help me choose the next step.Alcune pagine marketing offrono un prompt di configurazione per Claude Code, Codex e Cursor, con la pagina corrente come contesto. I passaggi per ciascun client spiegano le differenze nell'installazione delle skill.
Oppure configuralo manualmente per ciascun client
Tutti i client iniziano allo stesso modo; cambia solo il passaggio relativo alle skill.
Esempio di codice
curl -fsSL https://cli.bird.com/install.sh | sh # install the CLI
bird auth login # sign in (browser, no API key)Claude Code
Esempio di codice
claude plugin marketplace add messagebird/bird-ai
claude plugin install bird@bird-aiCodex
Esempio di codice
codex plugin marketplace add messagebird/bird-ai
codex plugin add bird@bird-aiCursor
Il pulsante Cursor nella home page apre Cursor con il prompt di configurazione precompilato (un deep link del prompt); controllalo e invialo. Il prompt installa le skill di Bird recuperandole da github.com/messagebird/bird-ai e copiando le cartelle delle skill in .agents/skills/, una delle directory da cui Cursor carica le Agent Skills. Per farlo manualmente, installa invece il plugin: aggiungi il marketplace messagebird/bird-ai in Settings > Plugins, oppure usa cursor.directory. Entrambi i percorsi forniscono a Cursor le stesse due skill.
Qualsiasi client compatibile con Agent Plugins
Il plugin di Bird segue Agent Plugins, il formato portabile per plugin. Un client che implementa la specifica installa il plugin da github.com/messagebird/bird-ai senza modifiche e ottiene le skill e il server MCP in un solo passaggio anziché due. Usa il comando di installazione dei plugin del client e indica quel repository.
OpenCode
Esempio di codice
opencode plugin github:messagebird/bird-ai --global
opencode mcp auth birdIl plugin aggiunge le skill e il server MCP in un unico passaggio; riavvia OpenCode per caricarlo.
Qualsiasi altro agente (Zed, Amp, Goose, pi, Cline, …)
Per un client che non legge nessuno dei due formati, copia la skill nella directory delle skill dell'agente:
Esempio di codice
git clone --depth 1 https://github.com/messagebird/bird-ai /tmp/bird-ai
mkdir -p .agents/skills && cp -r /tmp/bird-ai/plugins/bird/skills/. .agents/skills/La maggior parte degli agenti legge .agents/skills/; Cline usa .clinerules/skills/. Questo è facoltativo: il bird CLI funziona anche senza.
Autenticazione
bird auth login esegue un flusso OAuth nel browser limitato al tuo spazio di lavoro, così non devi conservare una chiave o un segreto API in nessuna configurazione. bird auth status mostra lo spazio di lavoro, la regione e gli scope concessi.
Cosa offrono le skill al tuo agente
| Skill | Cosa fa |
|---|---|
| bird-cli | Indirizza una richiesta a un riferimento per gruppo di comandi CLI, su ogni canale gestito da Bird e la configurazione necessaria prima dell'invio |
| email-audit | Valuta i record DMARC, SPF, DKIM, BIMI e MX attivi di un dominio e restituisce i risultati come elenco di correzioni con priorità |
Skill dell'agente descrive il contenuto di ciascuna, come il plugin si installa per ogni client e la relazione tra le skill e il server MCP.
Connetti invece il server MCP
Per i client che chiamano tool invece di eseguire una shell, connettiti al server MCP ospitato da Bird all'indirizzo https://mcp.bird.com. Questo include Claude Desktop, ChatGPT e i client mobile. Autenticati dopo aver aggiunto l'URL; i client non autenticati possono elencare i tool di Bird, ma ogni chiamata fallisce. Ogni host usa un trigger diverso: Claude Code usa /mcp > bird > Authenticate, Claude Desktop usa Connect e Cursor usa Needs login. Consulta i passaggi di connessione per ogni client. La guida al server MCP copre anche lo stdio locale.
Passaggi successivi
- CLI per agenti: il contratto per agenti del bird CLI.
- Skill dell'agente: cosa insegna ogni skill e la matrice di supporto per client.
- Server MCP: l'endpoint ospitato e la superficie dei tool.
Risorse correlate
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.
Guarda la guidaSetting up your coding agentComprendi 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