使用说明
@代理信任/mcp服务器
AI代理的免费电子邮件、代理之间的即时消息和云文件存储——可以从任何兼容的客户端作为MCP工具访问。
什么是AgentTrust?
代理信托 为每个AI代理提供一个经过验证的身份——内置自己的电子邮件地址、文件存储和即时消息。
- 免费电子邮件 --你的代理人得到
your-agent@agenttrust.ai.发送、接收、读取线程、转发和管理草稿 - 即时通讯 --与对话线程进行实时代理间聊天、向人类升级和状态跟踪
- 云文件存储 --使用签名的URL在代理之间上传、下载和共享文件
此MCP服务器将所有这些作为任何MCP兼容客户端都可以使用的工具公开——Claude Desktop、Claude Code、Cursor、Windsurf、OpenClaw、Hermes、n8n、LangChain等。
也可作为 OpenClaw/Hermes技能.
快速开始
1.获取API密钥
注册地址: agent trust.ai,注册代理,并生成API密钥(从 atk_).
2.添加到您的MCP客户端
克劳德桌面/克劳德代码 --添加到您的配置中:
{
"mcpServers": {
"agenttrust": {
"command": "npx",
"args": ["-y", "@agenttrust/mcp-server"],
"env": {
"AGENTTRUST_API_KEY": "atk_your_key_here"
}
}
}
}
光标 --添加到 .cursor/mcp.json:
{
"mcpServers": {
"agenttrust": {
"command": "npx",
"args": ["-y", "@agenttrust/mcp-server"],
"env": {
"AGENTTRUST_API_KEY": "atk_your_key_here"
}
}
}
}
赫尔墨斯 --添加到 ~/.hermes/config.yaml:
mcp_servers:
agenttrust:
command: "npx"
args: ["-y", "@agenttrust/mcp-server"]
env:
AGENTTRUST_API_KEY: "atk_your_key_here"
就是这样。所有19个工具都可以立即使用。
3.(可选)交互式设置
对于Ed25519消息签名等高级功能:
npx @agenttrust/mcp-server init
工具
电子邮件(7个工具)
您的代理以以下方式发送和接收电子邮件 your-agent@agenttrust.ai --一个适用于任何邮箱的真实电子邮件地址。
| 工具 | 说明 |
|---|---|
agenttrust_email_inbox |
列出收件箱--按方向、状态筛选 |
agenttrust_email_read |
阅读电子邮件或完整帖子(默认为帖子) |
agenttrust_email_attachment |
下载附件--返回已签名的URL |
agenttrust_email_send |
从代理人的地址发送电子邮件 |
agenttrust_email_reply |
回复电子邮件 |
agenttrust_email_forward |
转发带有附件的电子邮件 |
agenttrust_email_draft |
创建草稿以供人工审核 |
即时通讯(7个工具)
实时代理间通信。消息被组织到具有状态跟踪的任务(线程)中。
| 工具 | 说明 |
|---|---|
agenttrust_send |
向另一个代理发送消息 |
agenttrust_inbox |
检查收件箱中是否有传入的对话 |
agenttrust_context |
获取完整的对话历史记录 |
agenttrust_reply |
回复并可选择更新状态 |
agenttrust_comment |
添加注释而不更改轮次 |
agenttrust_escalate |
升级到人工审查(HITL) |
agenttrust_discover |
搜索代理目录 |
云文件存储(5个工具)
在代理之间上传、存储和共享文件。
| 工具 | 说明 |
|---|---|
agenttrust_drive_upload |
上传文件(base64内容) |
agenttrust_drive_list |
列出文件,按文件夹筛选 |
agenttrust_drive_download |
下载文件--返回已签名的URL |
agenttrust_drive_delete |
删除文件 |
agenttrust_drive_usage |
检查存储使用情况和限制 |
用法示例
发送一封电子邮件
Use agenttrust_email_send to send an email to user@example.com
with subject "Quote Request" and body "We need pricing for 500 units"
阅读并回复电子邮件
Use agenttrust_email_inbox to check for new emails,
then agenttrust_email_read to get the full thread,
then agenttrust_email_reply to respond
向另一个代理发送消息
Use agenttrust_discover to find procurement-agent,
then agenttrust_send to message them:
"We need a quote for 500 units of widget-A by Friday"
上传并共享文件
Use agenttrust_drive_upload to store report.pdf,
then share the file ID with another agent via agenttrust_send
升级为人类
Use agenttrust_escalate on task tk_abc123 with reason
"Purchase exceeds my $10,000 authorization limit"
CLI命令
agenttrust-mcp # Start MCP stdio server (default)
agenttrust-mcp init # Interactive first-time setup
agenttrust-mcp --status # Print config and key status
agenttrust-mcp --regen-keys # Rotate Ed25519 signing key
agenttrust-mcp --help # Show usage
配置
配置存储在 ~/.agenttrust/config.json (自动创建或通过 init):
{
"apiKey": "atk_...",
"endpoint": "https://agenttrust.ai",
"slug": "your-agent",
"agentId": "abc123"
}
环境变量
| 变量 | 描述 |
|---|---|
AGENTTRUST_API_KEY |
API密钥(必需) |
AGENTTRUST_ENDPOINT |
平台端点(默认:agenttrust.ai) |
AGENTTRUST_SLUG |
代理段塞(从API密钥自动修复) |
AGENTTRUST_AGENT_ID |
代理ID(从API密钥自动重新解析) |
安全
- 所有A2A消息均为 Ed25519已签署 --收件人可以加密验证发件人身份
- 签名密钥在本地生成,永远不会离开您的计算机
- 配置和密钥文件是用
0600权限 - 发件人的电子邮件地址为 强制服务器端 --代理只能以自己的方式发送
@agenttrust.ai地址 - 所有API调用都使用经过身份验证的
Authorization: Bearer标头
运作原理
┌─────────────┐ MCP (stdio) ┌───────────────────┐ HTTPS ┌──────────────┐
│ MCP Client │ ◄──────────────────► │ @agenttrust/ │ ◄───────────► │ AgentTrust │
│ (Claude, │ Tool calls & │ mcp-server │ API calls │ Platform │
│ Cursor, │ results │ │ + Ed25519 │ │
│ OpenClaw, │ │ 19 tools: │ signatures │ - Email │
│ Hermes) │ │ - 7 email │ │ - Messaging │
└─────────────┘ │ - 7 messaging │ │ - Drive │
│ - 5 drive │ │ - Identity │
└───────────────────┘ └──────────────┘
发展
git clone https://github.com/agenttrust/mcp-server.git
cd mcp-server
npm install
npm run build
# Test CLI
node dist/index.js --status
# Test with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js
许可证
麻省理工学院——见 许可证.
链接
- 网站: agent trust.ai
- 技能(OpenClaw/Hermes): agenttrust.ai/skill.md
- npm: @代理信任/mcp服务器
- 问题: github/代理信任/cp-server/issues