VantaGate MCP服务器和OpenAPI集成
](https://www.npmjs.com/package/@vantagate/mcp-server)  ](https://nodejs.org)
人工智能代理的人机交互授权。 VantaGate拦截高风险操作,通过Slack或电子邮件将其发送给人工审批人,并返回一个加密签名的决定,因此您的代理可以继续或停止进行完整的审计跟踪。
______________________________________________________________________
VantaGate是什么?
人工智能代理越来越有能力执行相应的现实世界操作:向数千名用户发送电子邮件、删除数据库记录、转移资金、部署到生产环境。 VantaGate是确保人类保持控制的信任层。
Agent hits risky action
↓
POST /v1/checkpoint ──→ Human receives Slack/Email notification
↓ ↓
id and status Human reviews payload & decides
↓ ↓
Poll GET /v1/checkpoint/{id} ←── Decision recorded + payload purged
↓
APPROVED → Resume workflow
REJECTED → Halt + report reason关键保证
- **API响应\=20
- VantaGate账户: https://vanta-gate.com
- VantaGate API钥匙(仪表板→ 项目→ 新项目)
______________________________________________________________________
快速开始
选项A:使用带Claude Desktop的MCP服务器
最快的路径。无需手动设置。
第一步: 从获取API密钥 https://vanta-gate.com/dashboard/projects
第二步: 将VantaGate添加到您的Claude桌面配置中。
打开你的 claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"vantagate": {
"command": "npx",
"args": ["-y", "@vantagate/mcp-server"],
"env": {
"VANTA_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}步骤3: 重新启动克劳德桌面。工具 create_vantagate_checkpoint 和 check_vantagate_status 将出现在克劳德的工具列表中。
步骤4: 让克劳德做一些需要批准的事情:
*“从暂存数据库中删除所有记录,其中created_at\ 超时值被默默地限制在计划的最大值。免费计划请求timeout: "7d"将被限制在24h.
______________________________________________________________________
网络钩子
当人类做出决定时,VantaGate会向您的 callback_url (最多5次重试尝试,呈指数回退)。
请求标头:
Content-Type: application/json
X-Vanta-Signature: sha256=
User-Agent: VantaGate-Webhook/1.0签名验证(Node.js):
const crypto = require('crypto')
function verifyVantaSignature(rawBody, signature, projectSecret) {
const expected = 'sha256=' + crypto
.createHmac('sha256', projectSecret)
.update(rawBody)
.digest('hex')
return crypto.timingSafeEqual(
Buffer.from(expected),
Buffer.from(signature)
)
}
app.post('/webhook/vanta', express.raw({ type: 'application/json' }), (req, res) => {
const sig = req.headers['x-vanta-signature']
if (!verifyVantaSignature(req.body, sig, process.env.VANTA_PROJECT_SECRET)) {
return res.status(401).json({ error: 'Invalid signature' })
}
const event = JSON.parse(req.body)
if (event.status === 'APPROVED') {
// ✅ Resume agent workflow
} else if (event.status === 'REJECTED') {
// ❌ Halt - check event.reject_reason
}
res.json({ received: true })
})你的 Webhook签名密码 (VANTA_PROJECT_SECRET)与您的API密钥不同。在仪表板中找到它→ 项目设置。
______________________________________________________________________
从源头构建
# Install dependencies
npm install
# Build TypeScript
npm run build
# Run the server directly
VANTA_API_KEY=YOUR_API_KEY_HERE npm start______________________________________________________________________
高级:其他客户端的MCP配置
光标/线/风帆
{
"mcpServers": {
"vantagate": {
"command": "npx",
"args": ["-y", "@vantagate/mcp-server"],
"env": {
"VANTA_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}随着当地建设(开发)
{
"mcpServers": {
"vantagate": {
"command": "node",
"args": ["/absolute/path/to/dist/index.js"],
"env": {
"VANTA_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}______________________________________________________________________
安全
- 你的
X-API-KEY是 哈希服务器端 -VantaGate从不存储明文密钥。 - 你的
slack_webhook_url根据请求发送,以及 原子净化 在决定之后。零留存。 - 所有有效载荷数据为 使用AES-256静态加密 并在人类做出决定后被摧毁。它无法重建。
callback_url根据私有IP范围进行验证(SSRF预防)。- 所有webhook交付均已签名 HMAC-SHA256。始终验证签名。
______________________________________________________________________
许可证
麻省理工学院-见 许可证
______________________________________________________________________
