Mailbuttons

Mailbuttons MCP サーバー

Model Context Protocol を介して、AI エージェントに管理されたメールを提供します。 プロンプトではなくサーバーがガードレールを適用する、スコープを限定したメールボックスをエージェントに用意できます。デフォルトでサンドボックス化された受信トレイ、送信のたびに適用されるポリシーゲート、改ざんを検知できる監査ログを備えています。外部への送信とスコープの変更には人間の承認が必要で、エージェント自身が権限を付与することはできません。

• レジストリ：com.mailbuttons/mcp-server
• npm：@mailbuttons/mcp-server
• プラットフォーム：mailbuttons.com · エージェント向けエントリーポイント：mbag.ai

利用方法

ホステッド（推奨） — プラットフォームが提供するストリーミング可能な HTTP エンドポイント：

https://mailbuttons.com/api/v1/mcp/rpc
Authorization: Bearer <your Mailbuttons MCP token>   # mb_sandbox_... (or mb_prod_...)

ローカル（stdio） — npm パッケージを実行し、エージェントに起動させます：

{
  "mcpServers": {
    "mailbuttons": {
      "command": "npx",
      "args": ["-y", "@mailbuttons/mcp-server"],
      "env": { "MAILBUTTONS_API_KEY": "mb_sandbox_..." }
    }
  }
}

ダッシュボードまたは POST /api/v1/mcp/sandbox-inboxes から、スコープを限定したトークンを取得してください。 サンドボックストークンでは、人間が昇格させない限り外部に送信できません。

サーバーが適用すること

• 受信 — メールボックスごとの送信者ポリシーをフェイルクローズで適用します。デフォルトでは知らない送信者からのメールはバウンスされるため、メールを送信するだけでエージェントにプロンプトインジェクションを仕掛けることはできません。
• 送信 — エージェントは宛先ブロックリストを読み取れますが、変更はできません。ブロックされた送信はエラーではなく、通常の {"status":"blocked"} という結果を返します。
• 上限と監査 — アカウントごとの送信上限と、拒否も記録するハッシュチェーン監査ログを備えています。
• エスカレーション — 外部への送信やスコープの拡大は提案のみ可能です。指名された人間が承認します。エージェントは自分自身のリクエストを承認できません。

エージェントスキルとしてインストールする

このリポジトリにはルートに SKILL.md が含まれているため、スキル対応のエージェントならどれでも追加できます。

npx skills add mailbuttons/mcp-server

ドキュメント

• エージェント登録（エージェント向け）：https://mbag.ai/docs/agent-signup.md
• 信頼モデル：https://mbag.ai/docs/trust-model.md
• OpenAPI：https://mbag.ai/api/openapi.json
• フレームワーク別レシピ：references/（Claude Agent SDK、LangChain、プレーンな SDK）

Mailbuttons は Code Cutter Limited（英国、会社番号 08453060）の商号です。MIT ライセンスです。