关于 Salvy
Salvy 是面向使用巴西企业移动运营商 Salvy 的公司的远程 MCP 服务。Agent 可查看线路、账单和员工信息,并管理套餐与账户;需付费的变更会先报价,再由用户确认。
主要功能
- 01查看电话线路、用量和消息
- 02查询账单及费用估算
- 03停用、新建和修改线路
- 04管理员工与成本中心
- 05跟踪 SIM 卡配送和号码转入
- 06管理公司手机等资产
适用场景
- 01查找数据用量较高的线路
- 02按成本中心核对费用
- 03停用公司电话线路
- 04管理员工设备和移动套餐
MCP 相关
通过托管的 Streamable HTTP 服务向 MCP 客户端提供 Salvy 账户查询与管理工具。使用 Salvy 控制台账户进行 OAuth 2.0 身份验证,付费操作需在报价后确认。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.salvy.com.br/mcpclaude mcp add --transport http br-com-salvy https://mcp.salvy.com.br/mcp{"mcpServers":{"br-com-salvy":{"type":"http","url":"https://mcp.salvy.com.br/mcp"}}}在 Cursor 中打开{"servers":{"br-com-salvy":{"type":"http","url":"https://mcp.salvy.com.br/mcp"}}}在 VS Code 中打开{"mcpServers":{"br-com-salvy":{"type":"http","url":"https://mcp.salvy.com.br/mcp"}}}{"mcpServers":{"br-com-salvy":{"serverUrl":"https://mcp.salvy.com.br/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Salvy MCP 服务
将你的 AI Agent 连接到 Salvy,这家来自巴西的企业移动运营商。Agent 可以查询公司的电话线路、用量、发票和员工信息,也可以执行封锁线路或更改套餐等操作。
此代码库仅介绍该服务。服务本身由 Salvy 托管,地址为:
https://mcp.salvy.com.br/mcp
- 传输方式:Streamable HTTP
- 身份验证:OAuth 2.0。使用 Salvy 控制面板账户登录(app.salvy.com.br),Agent 只能执行该账户在控制面板中有权执行的操作。
- 完整指南(葡萄牙语):docs.salvy.com.br/mcp-guide
你可以做什么
- 查看线路。 列出电话线路、数据用量、短信和时间线,以及每条线路的使用者。
- 跟踪费用。 查看发票、本月预估费用,以及各成本中心的费用。
- 管理线路。 封锁、解除封锁、取消或创建线路、添加流量、更改套餐,以及转入号码。
- 组织管理。 管理员工、成本中心、线路组,以及手机和笔记本电脑等资产。
任何收费操作(新线路、额外流量、更改套餐)都会先返回报价,只有在你确认后才会收费。
提示词示例
- 本月哪些线路使用的数据最多?每条线路分别由谁使用?
- 每个成本中心在 10 月的发票中花了多少钱?
- 封锁“Sales Team”线路。
设置
VS Code 中的 GitHub Copilot
添加到 .vscode/mcp.json:
{
"servers": {
"salvy": {
"type": "http",
"url": "https://mcp.salvy.com.br/mcp"
}
}
}
启动服务,并在 VS Code 提示时登录。
Claude
在 Claude 设置中的连接器目录里添加 Salvy,或使用上面的 URL 添加自定义连接器。
Gemini 应用
在 gemini.google.com 中,打开“设置” →“已连接的应用”,添加自定义应用并粘贴上面的 URL。
Gemini CLI
gemini extensions install https://github.com/SalvyLTD/salvy-mcp
然后在 Gemini CLI 中运行 /mcp auth salvy 登录。
其他客户端
任何支持通过 Streamable HTTP 和 OAuth 连接远程服务的 MCP 客户端均可使用:将其指向 https://mcp.salvy.com.br/mcp。
工具
| 区域 | 工具 |
|---|---|
| 公司 | list_companies |
| 电话线路 | list_phone_accounts、get_phone_account、get_phone_account_usage、get_phone_account_timeline、list_phone_account_sms_messages、update_phone_accounts、create_phone_account_group |
| 线路操作 | create_phone_accounts、block_phone_accounts、unblock_phone_accounts、cancel_phone_accounts、unschedule_phone_account_cancellations、add_data_to_phone_accounts、change_subscription_plan、list_subscription_plans |
| SIM 卡配送 | list_sim_card_shipments、get_sim_card_shipment |
| 号码转入 | port_number、get_portability_status |
| 账单 | list_invoices、get_invoice、get_current_month_estimate、get_cost_by_cost_center |
| 人员 | list_employees、create_employee、list_cost_centers、create_cost_center、update_cost_center |
| 资产 | list_assets、get_asset、get_asset_summary、create_assets、update_assets、list_asset_categories、create_asset_category、delete_asset_category、list_asset_statements、send_asset_statement |
| 其他 | get_task、submit_mcp_feedback |
要求
你的公司必须是 Salvy 客户,且你需要拥有 Salvy 控制面板的访问权限。
支持
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。