Bird

Bird AI マーケットプレイス

コーディングエージェントから Bird プラットフォームを操作するためのスキルです。エージェントは bird CLI を通じて Bird を操作します。このマーケットプレイスの bird プラグインは、Bird のワークフローを教えるスキルをインストールし、プラグインの MCP 宣言を読み込むクライアントでは、Bird のホスト型 MCP サーバーも接続します。

クイックスタート

どのクライアントでも、まず CLI をインストールしてサインインします。

curl -fsSL https://cli.bird.com/install.sh | sh   # install the bird CLI
bird auth login                                            # sign in (browser, no API key)

macOS または Linux では、Homebrew を使って brew install messagebird/tap/bird からインストールすることもできます。

次に、使用するクライアントのセクションに進んでください。最も簡単なのは、セットアッププロンプトを貼り付けて、あとはエージェントに任せる方法です。各セクションには手動での手順も記載しています。

Bird アカウントをまだお持ちでない場合

bird auth login は、すでにお持ちのアカウントにサインインします。アカウントを持っていないエージェントも、ターミナルからアカウントを作成できます。ブラウザーもパスワードも必要ありません。3 つのコマンドで、何もない状態から認証情報を保存できます。

# 1. Sign up. Emails a six-digit code to the address; no password is set.
bird auth signup [email protected]

# 2. Verify. Read the code from that email, then exchange it for a single-use onboarding ticket.
bird auth verify-email [email protected] --code 123456
# → { "onboarding_ticket": "obt_…", "user_id": "usr_…" }

# 3. Create your first org + workspace. Consumes the ticket, then mints and stores the credential.
#    --region picks where the account and its data live (us1 or eu1); the CLI routes there for you.
bird auth create-org "Acme" --workspace-name "Production" --region us1 --onboarding-ticket obt_…

# Confirm it worked — reports the account, org, and workspace you're now acting as.
bird auth status

コードはメールで届くため、CLI の外で取得する必要があります。受信トレイでコードを確認し、手順 2 に渡してください。登録と確認はリージョンに依存しません。リージョンを選ぶのは create-org のときだけなので、ホストや環境変数を設定する必要はありません。各手順では、--help を追加するとフラグ、--example を追加すると編集して使えるリクエスト本文、--response-schema を追加すると戻り値を確認できます。いずれも認証情報は不要なので、エージェントは実行前に一連の手順全体を計画できます。詳しい手順については、セルフサービス登録をご覧ください。

Any Agent Plugins 対応クライアント

このプラグインには、ポータブルなプラグイン形式である Agent Plugins に準拠したルートの plugin.json と mcp.json が含まれています。この仕様に対応するクライアントは、このリポジトリからそのまま読み込み、スキルとホスト型 MCP サーバーをまとめてインストールできます。クライアントで github.com/messagebird/bird-ai を指定し、plugins/bird から bird をインストールしてください。

独自のプラグイン形式を使用するクライアント、またはプラグイン形式がないクライアントについては、以下をご覧ください。

Claude Code

このプロンプトを Claude Code に貼り付けると、CLI のインストール、サインイン、スキルのインストール、テストメールの送信が行われます。

Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Install Bird's skills so you know the workflows: run `claude plugin marketplace add messagebird/bird-ai`, then `claude plugin install bird@bird-ai`.
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.

または、プラグインを手動でインストールします。

claude plugin marketplace add messagebird/bird-ai
claude plugin install bird@bird-ai

MCP サーバー： プラグインをインストールすると、Bird のホスト型サーバー https://mcp.bird.com が登録されるため、設定は不要です。ただし、サーバーは OAuth で保護されているため、一度サインインする必要があります。/mcp を実行し、bird を選択して Enter キーを押し、Authenticate を選択してください。ブラウザーで Bird の同意画面が開くので、承認するとツールを使えるようになります。それまでは claude mcp list に bird が ! Needs authentication と表示され、すべてのツール呼び出しが失敗します。ヘッドレス実行（claude -p）では /mcp パネルがないため、先に claude mcp login bird で認証してください。

Cursor

このプロンプトを Cursor に貼り付けてください。

Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Give yourself Bird's skills (Cursor installs plugins through its UI, so set them up by file instead): fetch the skills from https://github.com/messagebird/bird-ai and write them into `.cursor/rules/` as `.mdc` files.
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.

スキルを手動で設定するには、Settings → Plugins で messagebird/bird-ai マーケットプレイスを追加するか、このリポジトリのスキルを .mdc ファイルとして .cursor/rules/ に書き込んでください。

MCP サーバー： ホスト型サーバーを ~/.cursor/mcp.json に一度追加します。

{
  "mcpServers": {
    "bird": { "url": "https://mcp.bird.com" }
  }
}

次にサインインします。Cursor のサイドバーで Customize を開き、MCPs を選択して、bird のサインインプロンプトに従ってください。ブラウザーで Bird の同意画面を承認し、Cursor に戻ります。サインインするまではツールを使えません。

Codex

このプロンプトを Codex に貼り付けてください。

Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Install Bird's skills so you know the workflows: run `codex plugin marketplace add messagebird/bird-ai`, then `codex plugin add bird@bird-ai` (check `codex plugin --help` if the exact form differs).
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.

または、プラグインを手動でインストールします。

codex plugin marketplace add messagebird/bird-ai
codex plugin add bird@bird-ai

MCP サーバー： プラグインによって https://mcp.bird.com が自動的に登録されます。

次にサインインします。ブラウザーで Bird の同意画面が開きます。

codex mcp login bird

GitHub Copilot

Copilot にこのプロンプトを貼り付けます：

Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Install Bird's skills so you know the workflows: run `copilot plugin marketplace add messagebird/bird-ai`, then `copilot plugin install bird@bird-ai`.
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.

または、プラグインを手動でインストールします：

copilot plugin marketplace add messagebird/bird-ai
copilot plugin install bird@bird-ai

MCP サーバー： ホストされたサーバーを .vscode/mcp.json に一度追加します：

{
  "servers": {
    "bird": { "type": "http", "url": "https://mcp.bird.com" }
  }
}

VS Code は初回起動時にサーバーを信頼するか確認し、その後、サインインを自動で行います。開いたブラウザーウィンドウで Bird の同意画面を承認してください。ウィンドウが表示されない場合は、MCP: List Servers コマンドから bird を起動します。付与したアクセス許可は、Accounts メニュー → Manage Trusted MCP Servers に表示されます。ここからアクセス許可を取り消すこともできます。

Factory Droid

Droid にこのプロンプトを貼り付けます：

Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Install Bird's skills so you know the workflows: Droid loads skills from `.factory/skills/`, so clone https://github.com/messagebird/bird-ai and copy every directory in `plugins/bird/skills/` into `.factory/skills/`.
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.

スキルを手動で設定するには：

git clone https://github.com/messagebird/bird-ai
cp -r bird-ai/plugins/bird/skills/. .factory/skills/

MCP サーバー： ホストされたサーバーを一度追加します：

droid mcp add bird https://mcp.bird.com --type http

次に、droid 内で /mcp を実行し、サーバーマネージャーからブラウザーでサインインを完了します。

OpenCode

OpenCode にこのプロンプトを貼り付けます：

Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Install Bird's OpenCode plugin so you know the workflows: run `opencode plugin github:messagebird/bird-ai --global`, then tell me to restart OpenCode and run `opencode mcp auth bird`.
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.

または、プラグインを手動でインストールします：

opencode plugin github:messagebird/bird-ai --global
opencode mcp auth bird

このプラグインは、Bird のスキルとホストされた MCP サーバーを OpenCode の設定に追加します。デフォルトでは、OpenCode はすべての MCP ツールをモデルのコンテキストに追加するため、このプラグインは https://mcp.bird.com/dynamic に接続します。このエンドポイントは、タスクに適した Bird ツールを見つける search と、それを実行する execute の 2 つのツールを提供します。OpenCode の実験的なコードモードを有効にしている場合（OPENCODE_EXPERIMENTAL_CODE_MODE=1 または OPENCODE_EXPERIMENTAL=1）、OpenCode は MCP ツールを独自の検索機能の背後に置くため、このプラグインは代わりに https://mcp.bird.com の全カタログに接続します。

デフォルトでは、ワークスペースに変更を加える可能性がある各呼び出しの前に、OpenCode が確認を求めます。対象となるのは、/dynamic 上の bird_execute と、コードモードでのすべての Bird ツールです。独自の opencode.json が優先されます。設定した bird_* ルール、すべてのツールに適用される単一の permission 値、または設定済みの bird サーバーが、プラグインの設定に置き換わります。

Google Antigravity

Antigravity にこのプロンプトを貼り付けます：

Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Install Bird's Antigravity plugin so you know the workflows: run `curl -fsSL https://raw.githubusercontent.com/messagebird/bird-ai/main/antigravity.sh | bash`, then tell me to open Customizations in the sidebar and authenticate `bird`.
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.

または、プラグインを手動でインストールします：

curl -fsSL https://raw.githubusercontent.com/messagebird/bird-ai/main/antigravity.sh | bash

このスクリプトは、このリポジトリの main ブランチからプラグインをダウンロードし、~/.gemini/config/plugins/bird にインストールします。Antigravity 2.0、IDE、Antigravity CLI は、すべてのワークスペースでここからプラグインを読み込みます。1 つのプロジェクトにインストールするには、プロジェクトのルートから bash -s -- --project を実行すると、.agents/plugins/bird に書き込まれます。更新するには、同じコマンドを再度実行してください。このリポジトリをクローンしたディレクトリからは、同じオプションを指定して bash antigravity.sh を実行します。

MCP サーバー： プラグインは Bird のホストサーバーを https://mcp.bird.com に登録します。このサーバーは OAuth で保護されているため、サインインは一度必要です。サイドバーで Customizations を開き（IDE では、macOS の場合は Cmd+,、それ以外の場合は Ctrl+, で Agent settings を開きます）、bird の横にある Authenticate を選択します。bird が一覧にない場合は、Antigravity を再起動してください。ブラウザーで Bird の同意画面を承認し、表示された認証コードをコピーして Antigravity に貼り付け、Submit を選択します。それまでは、すべてのツール呼び出しが失敗します。

Antigravity のプラグインマニフェストで指定できるのは名前と説明のみのため、パッケージの VERSION ファイルに Bird AI のリリース情報が記録されています。これらはローカルインストール手順です。Google の公式マーケットプレイスへの掲載には、別途審査が必要です。

bird プラグインの内容

• bird-cli：ターミナルから Bird API を操作します。CLI コマンドグループごとに 1 つのリファレンスがあり、Bird が対応するすべてのチャネルでのメッセージの送信と確認、送信前に各チャネルで必要な設定、ワンタイムパスコード認証、受信者の検索、連絡先とオーディエンス、メッセージングの設定、Realtime のプロビジョニング、Webhook、API キー、サポートチケット、ドキュメント検索を網羅しています。
• email-audit：ドメインの DMARC、SPF、DKIM、BIMI、MX レコードを実際に確認して評価し、優先順位を付けた修正リストとして結果を読み取ります。DNS のみを使用するため、サインインは不要です。
• Bird MCP サーバー：ホスト型サーバー https://mcp.bird.com です。ブラウザーでサインインすれば、API キーなしでエージェントから Bird を直接呼び出せます。Claude Code、Codex、OpenCode、Antigravity、およびあらゆる Agent Plugins ホストには登録済みです。それ以外では、上記のとおり一度だけ設定が必要です。各クライアントでは、該当するセクションに記載されたブラウザーでの一度限りのサインインが必要です。このサーバーは OAuth で保護されているため、URL を設定していても認証許可を得ていないクライアントではツール一覧が表示されるだけで、呼び出しはすべて失敗します。

ライセンス

MIT。