在 Agent 中使用 MCP

@temporam/mcp 是基于 stdio 的 MCP Server,适用于 Cursor、Claude Code、Codex 及其他兼容客户端。需要 Node.js 20 或更高版本。

配置

先在 Temporam 工作台创建 API Key,再将以下配置加入 MCP 客户端配置文件:

  1. 1{
  2. 2 "mcpServers": {
  3. 3 "temporam": {
  4. 4 "command": "npx",
  5. 5 "args": ["-y", "@temporam/mcp"],
  6. 6 "env": {
  7. 7 "TEMPORAM_API_KEY": "<API_KEY>",
  8. 8 "TEMPORAM_API_BASE": "https://api.temporam.com"
  9. 9 }
  10. 10 }
  11. 11 }
  12. 12}

重启 MCP 客户端后,Agent 即可发现工具。TEMPORAM_API_KEY 必填;TEMPORAM_API_BASE 建议显式设置为生产地址。

可用工具

工具作用
list_domains列出系统域名
list_emails、get_latest_email、get_email查询收件邮件
create_mailbox、list_mailboxes、get_mailbox、delete_mailbox管理邮箱
send_message、get_message发送与查询发件邮件

配额与注意事项

读取未认领的入站邮件可能消耗入站额度,完整邮件内容只应在需要时读取。send_message 发送成功会消耗发信额度,且不是幂等操作;Hobby 套餐不能发信。密钥只放在 MCP 客户端的环境变量中,绝不提交到配置仓库。