Postfleet

Postfleet MCP

AI エージェントに独自のメールアドレスを持たせましょう。Postfleet はエージェント向けのメールインフラストラクチャです。受信メールは解析、分類され、スキーマに合わせて情報が抽出されます。また、エージェントが内容を読む前に、プロンプトインジェクションの検査も行われます。

このリポジトリには、サーバーのソースコードとプラグインマニフェストが含まれています。これはミラーです。コードは Postfleet アプリケーションのリポジトリで開発され、npm に @postfleet/mcp として公開されています。こちらで issue を起票し、パッチを送ると、上流にも反映されます。サーバーは次の2つの方法で利用できます。

ホステッド（インストール不要）	https://api.postfleet.ai/api/mcp、ストリーミング可能な HTTP、Authorization: Bearer pf_...
ローカル（stdio）	npx 経由の @postfleet/mcp

postfleet.ai で pf_ API キーを取得してください。

ツール

list_mailboxes、create_mailbox、list_domains、create_domain、verify_domain、 send_email、reply_email、list_inbox、read_email、wait_for_email に加え、メール送信前に人間が承認するワークフロー向けの下書きライフサイクル（create_draft、list_drafts、get_draft、update_draft、send_draft、 delete_draft）を提供します。承認ゲートの対象となった送信は 202 pending_approval を返します。これは失敗ではありません。

各ツールは REST API の薄いラッパーで、キーがすでにアクセスできるものと同じ /api/v1/ エンドポイントを呼び出します （OpenAPI）。そのため、認証、スコープ設定、クォータは一元的に適用されます。

インストール

Cursor マーケットプレイスプラグイン

このリポジトリのマニフェスト（mcp.json、.cursor-plugin/plugin.json）では、ホステッドサーバー向けに headers.Authorization = Bearer ${POSTFLEET_API_KEY} を宣言し、ローカルの npx @postfleet/mcp にも同じ変数を使用します。プラグインをインストールすると、このキーの入力を求められ、実際の Bearer ヘッダーとして設定されます。キーを指定しないまま URL を追加するだけでは、キーが入力されるか、ホステッド接続カードで OAuth が完了するまで、initialize は 401 を返します。

Cursor（手動）

{
  "mcpServers": {
    "postfleet": {
      "url": "https://api.postfleet.ai/api/mcp",
      "headers": { "Authorization": "Bearer pf_your_key_here" }
    }
  }
}

ローカル stdio（npx -y @postfleet/mcp）

npx -y @postfleet/mcp

stdio に対応した MCP クライアントなら、POSTFLEET_API_KEY を設定してこのコマンドを実行できます。

{
  "mcpServers": {
    "postfleet": {
      "command": "npx",
      "args": ["-y", "@postfleet/mcp"],
      "env": { "POSTFLEET_API_KEY": "pf_your_key_here" }
    }
  }
}

Claude Code

claude mcp add postfleet --env POSTFLEET_API_KEY=pf_your_key_here -- npx -y @postfleet/mcp

POSTFLEET_API_URL（デフォルトは https://api.postfleet.ai）を設定すると、ステージング環境またはセルフホスト環境の API オリジンを指定できます。

キー

キーにはスコープが設定されています。bootstrap で作成できるのはメールボックスのみで、api はメール操作を対象とし、クライアントに渡すキーには mcp を使用します。ワークロードごとに別のキーを使用すると、ほかに影響を与えずに1つのキーを失効できます。キーをコミットしないでください。このリポジトリのマニフェストには意図的にキーを含めていません。

リンク

• レジストリ掲載情報：MCP Registry の ai.postfleet/postfleet
• npm：@postfleet/mcp
• ドキュメント：postfleet.ai/docs/mcp

ソースからビルド

npm install && npm run build   # tsup → dist/

MIT ライセンスです。