Venly MCP财务服务器-生产部署指南
🎯 这是什么
A. 生产级MCP服务器 为您的Venly资金运营提供：
- ✅ 安全模式：防止意外的大额转账
- ✅ 健康监测：铁路自动修复
- ✅ 审计跟踪：记录到Google表格的每笔交易
- ✅ 10/10生产就绪：已实施所有安全功能
🚀 15分钟CEO部署
步骤1：分叉此存储库
- 点击GitHub上的“分叉”按钮
- 命名它：
venly-treasury-mcp - 为了安全起见，请保密
第二步：部署到铁路（每月5美元）
OR手动设置：
- 首选 Railway.app
- 点击“新建项目”→ “从GitHub仓库部署”
- 选择您的分叉存储库
- 铁路自动检测配置
步骤3：配置环境变量
在铁路仪表板中，添加以下变量：
# REQUIRED - Get from https://portal.venly.io/
VENLY_CLIENT_ID=your-client-id
VENLY_CLIENT_SECRET=your-secret
# START WITH SANDBOX
VENLY_ENVIRONMENT=sandbox
# Your treasury wallet (create in Venly first)
TREASURY_WALLET_ID=your-wallet-uuid
# Safety settings (CRITICAL)
SAFE_MODE_MAX_AMOUNT=1000
AUDIT_LOG_ENABLED=true步骤4：验证健康状况
部署后，请访问：
https://your-app.up.railway.app/healthz您应该看到：
{
"status": "healthy",
"environment": "sandbox",
"checks": {
"venly_oauth": "healthy",
"safe_mode": "enabled"
}
}步骤5：查看仪表板
访问：
https://your-app.up.railway.app/dashboard📊 Google表格审核设置（推荐）
为什么你需要这个：
每个事务都会创建一个不可变的记录，这对合规性和调试至关重要。
设置（10分钟）：
- 创建谷歌表格:
- 名称：“Venly MCP审核日志” - 与服务帐户电子邮件共享
- 创建服务帐户:
1. Go to https://console.cloud.google.com
2. Create new project or select existing
3. Enable Google Sheets API
4. Create service account
5. Download JSON key- 添加到铁路:
AUDIT_PROVIDER=sheets
GOOGLE_SHEETS_CREDS=
🔗 集成点
对于n8n工作流：
// Add to n8n HTTP Request node
URL: https://your-app.up.railway.app/mcp
Method: POST
Headers:
Content-Type: application/json
Body:
{
"jsonrpc": "2.0",
"method": "venly_settle_invoice",
"params": {
"invoiceId": "INV-001",
"recipientAddress": "0x...",
"amount": "100",
"chain": "POLYGON",
"confirmed": true,
"origin": "n8n"
}
}对于Claude Desktop：
添加到配置：
{
"mcpServers": {
"venly-treasury": {
"command": "npx",
"args": ["-y", "github:yourusername/venly-treasury-mcp"]
}
}
}🛡️ 安全模式功能
在生产中，这些是强制执行的：
| 检查 | 限制 | 超过时采取行动 |
|---|---|---|
| 最大交易额 | 1000美元 | 已阻止 |
| 需要确认 | confirmed: true | 封锁了 |
| 允许的来源 | n8n，内部 | 已阻止 |
| 警告阈值 | $500 | 已记录 |
📈 生产检查表
首次真实交易前：
- \[\]测试
sandbox环境 - \[\]创建测试交易\限制）
- \[\]验证健康端点是否返回200
走向生产：
- 改变环境:
VENLY_ENVIRONMENT=production
TREASURY_WALLET_ID=
- 小心增加限额:
SAFE_MODE_MAX_AMOUNT=5000 # Based on your needs- 设置警报:
SLACK_ALERT_WEBHOOK=https://hooks.slack.com/...
ALERT_EMAIL=ceo@venly.io🔧 可用工具
财务运营（高级）：
venly_settle_invoice-用美元支付发票venly_batch_payouts-多次自由职业者付款venly_get_treasury_position-查看所有余额
钱包操作（低级）：
venly_create_wallet-创建新钱包venly_execute_transaction-发送代币venly_get_balance-检查余额
📊 监控
需要关注的关键指标：
- 成功率 -应大于95%
- 上次成功发送 -应该是最近的
- 失败的交易 -调查任何故障
- 审核日志行 -应与交易计数匹配
铁路仪表板：
- 日志：查看所有操作
- 指标：CPU、内存使用情况
- 部署：更新历史
- 设置：环境变量
🚨 故障排除
“违反安全模式”
原因：交易超出限额或缺少确认 修复：检查金额并添加 confirmed: true
“超出费率限制”
原因：请求太多 修复：等待1分钟，请求自动恢复
“Venly OAuth不健康”
原因：凭据无效或Venly已关闭 修复：验证CLIENT_ID和CLIENT_SECRET
“事务超时”
原因：网络拥塞 修复：重试或检查区块浏览器
💰 成本细分
| 服务 | 成本 | 你得到什么 |
|---|---|---|
| 铁路 | 每月5美元 | 托管、自动扩展、监控 |
| Venly | 免费套餐→ $99/mo | 基于交易量 |
| 谷歌表格 | 免费 | 审计日志 |
| 您的时间 | 15分钟 | 完成设置 |
🎯 您的特定用例（巴基斯坦银行）
自由职业者每月支付200万至400万美元：
- 使用批处理工具:
venly_batch_payouts({
payouts: [...freelancers],
chain: "POLYGON", // Lowest fees
confirmed: true,
origin: "n8n"
})- 设定适当的限制:
SAFE_MODE_MAX_AMOUNT=10000 # For larger batches- 密切监视:
- 最初每小时检查一次仪表板 - 每天审查审计日志 - 设置Slack警报
📞 支持升级
- 检查仪表板 -此处可见的大多数问题
- 查看审核日志 -看看到底发生了什么
- 检查铁路日志 -详细的错误消息
- Venly状态 - https://status.venly.io/
- 紧急情况 -禁用铁路，离线调查
✅ 在以下情况下，您已做好生产准备：
- \[\]健康检查显示全部为绿色
- \[\]已成功发送测试事务
- \[\]记录所有操作的审核日志
- \[\]安全模式阻止了测试超限交易
- \[\]n8n工作流已连接并测试
- \[\]仪表板已添加书签，可供每日查看
______________________________________________________________________
记住：开始于 sandbox，测试所有内容，然后切换到 production. 安全功能是你的朋友——它们可以防止代价高昂的错误。
专为需要可靠性而非复杂性的首席执行官而设计。 🚀