Mailgent

1) 建立 Mailgent 帳戶並取得 API 金鑰: 前往 console.mailgent.dev 並建立 API 金鑰。請妥善保管，因為 API 金鑰可能只會在建立時顯示一次。

2) 佈建代理程式身份（電子郵件 + DID + 儲存庫 + 日曆 + 錢包）: 呼叫代理程式註冊端點，在一個請求中建立完整的代理程式身份（返回電子郵件地址、DID/簽名金鑰、加密儲存庫、日曆和 USDC 錢包）： curl -X POST https://api.mailgent.dev/v0/agent-signup

3) 透過 MCP 連接 Mailgent（建議用於代理程式工具）: 將 Mailgent MCP 伺服器新增到您的 MCP 用戶端配置中（例如，Claude/Cursor/ChatGPT MCP 配置），然後透過環境變數提供您的 API 金鑰： { "mcpServers": { "mailgent": { "command": "npx", "args": ["-y", "mailgent-mcp"], "env": { "MAILGENT_API_KEY": "YOUR_API_KEY" } } } } Mailgent 可以透過託管 MCP (api.mailgent.dev/mcp) 使用，或在本地執行。

4) 透過 MCP 伺服器從聊天中使用 Mailgent 工具: 在啟用 MCP 的聊天中，按名稱呼叫伺服器並要求其執行操作。範例： @Mailgent MCP Server 檢查我的收件箱中的最新訊息並總結最新的一條 繼續發出指令，使用提供的 MCP 工具（例如 mail_send）發送、回覆、組織或標記電子郵件。

5) 透過郵件 API 發送/接收和組織電子郵件: 使用 Mailgent 的郵件功能透過 API 或 MCP 發送、接收、線程化和標記訊息。Mailgent 支援經過驗證的發件人和電子郵件身份驗證（例如 DKIM）作為郵件基礎設施的一部分。

6) 在加密儲存庫中儲存和檢索機密: 使用儲存庫功能儲存代理程式所需的 API 金鑰/令牌/憑證。機密由代理程式金鑰進行範圍限制，旨在避免被記錄。使用 MCP 工具（例如 vault_store 和相應的檢索工具）來管理憑證。

7) 在需要時生成 2FA/TOTP 代碼: 使用 2FA/TOTP 功能生成基於時間的一次性密碼並管理備份代碼，這些代碼儲存在儲存庫中。這有助於代理程式通過 2FA 門檻而無需暴露機密。

8) 建立和管理日曆事件: 使用日曆功能建立事件、管理可用性並分享 iCal 訂閱，以便您的代理程式可以像人一樣協調排程（透過 MCP 工具，例如 calendar_create）。

9) 使用代理程式的 DID 簽名並證明身份: 使用身份 (DID) 功能（did:web 與 Ed25519 金鑰對），以便代理程式可以簽署請求並證明其身份。這是其他功能（透過工具，例如 identity_sign）的信任根源。

10) 為 x402 定價的 API 充值並使用 USDC 錢包: 使用 USDC 錢包（在 Base 上）根據您設定的支出授權為每次呼叫支付 x402 定價的 URL——無需卡片或人工批准。

11) (可選) 在本地執行開源 Mailgent 伺服器以進行開發: 如果您正在自行託管開源 Mailgent (Cloudflare Workers) 實作，您可以在本地建立 API 金鑰和收件箱： # 建立 API 金鑰 curl -X POST http://localhost:8787/v0/auth/api-keys \ -H "Content-Type: application/json" \ -d '{"name": "my-first-key"}' # 建立收件箱 curl -X POST http://localhost:8787/v0/inboxes \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username": "my-agent", "domain": "example.com"}' 請遵循專案的 SETUP.md 進行 Cloudflare 設定，並請注意 API 金鑰只會在建立時顯示一次。

12) (可選) 透過 Webhook 配置即時通知: 配置 Webhook 端點以在收到、發送、退回或投訴電子郵件時接收事件，從而實現即時代理程式工作流程。