关于 A-Cube MCP by usefulapi
A-Cube MCP by usefulapi 将 A-Cube 账户连接到 MCP 客户端,用于意大利电子发票处理。它支持查询发票、收据、SDI 通知和企业记录,以及验证草稿和经确认后提交。
主要功能
- 01读取发票和 SDI 通知
- 02查看收据及发票统计
- 03验证发票但不保存
- 04创建和管理发票草稿
- 05核验税号和企业
适用场景
- 01检查发票的 SDI 通知
- 02查看电子收据及详情
- 03创建草稿前验证发票
- 04将已批准的草稿提交至 SDI
MCP 相关
托管服务通过远程 MCP URL 向 MCP 客户端提供发票和企业记录工具,并使用 OAuth 登录。写入操作可先返回预览,等待明确确认。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://acube.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-acube https://acube.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-acube":{"type":"http","url":"https://acube.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-acube":{"type":"http","url":"https://acube.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-acube":{"type":"http","url":"https://acube.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-acube":{"serverUrl":"https://acube.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
usefulapi 的 A-Cube MCP
连接
- Claude(claude.ai、Desktop):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://acube.usefulapi.io/mcp。 - **Claude Code:**运行
claude mcp add --transport http acube https://acube.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code:添加到 VS Code。
- **Cursor 和其他客户端:**将 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"acube": {
"url": "https://acube.usefulapi.io/mcp"
}
}
}
只添加 URL。请勿在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 A-Cube 凭据。
分步设置指南、凭据查找方式和常见问题:https://usefulapi.io/acube/
工具
| 工具 | 类型 | 功能 |
|---|---|---|
acube_list_invoices | 读取 | 列出发票 |
acube_get_invoice | 读取 | 获取发票 |
acube_list_invoice_notifications | 读取 | 列出发票的 SDI 通知 |
acube_get_notification | 读取 | 获取 SDI 通知 |
acube_get_invoice_stats | 读取 | 获取发票统计信息 |
acube_list_draft_invoices | 读取 | 列出草稿发票 |
acube_get_draft_invoice | 读取 | 获取草稿发票 |
acube_validate_invoice | 读取 | 验证发票(不保存) |
acube_create_draft_invoice | 写入 | 创建草稿发票 |
acube_send_draft_invoice | 写入 | 将草稿发票发送到 SDI |
acube_delete_draft_invoice | 写入 | 删除草稿发票 |
acube_list_receipts | 读取 | 列出电子收据 |
acube_get_receipt | 读取 | 获取电子收据 |
acube_get_receipt_details | 读取 | 获取电子收据详情 |
acube_list_business_registry_configurations | 读取 | 列出企业注册配置 |
acube_get_business_registry_configuration | 读取 | 获取企业注册配置 |
acube_list_webhooks | 读取 | 列出 webhook 配置 |
acube_list_numbering_sequences | 读取 | 列出编号序列 |
acube_get_current_numbering_sequence | 读取 | 获取当前编号序列 |
acube_list_jobs | 读取 | 列出后台任务 |
acube_get_job | 读取 | 获取后台任务 |
acube_verify_fiscal_id | 读取 | 检查税务编号 |
acube_verify_company | 读取 | 查询意大利企业 |
acube_get_recipient_code | 读取 | 获取 SDI 接收方代码 |
acube_usage_status | 元数据 | 使用情况状态(免费层用量计数) |
acube_request_feature | 元数据 | 申请添加缺失功能 |
acube_upgrade | 元数据 | 升级到 Pro 或 Pro+ |
acube_cancel_subscription | 元数据 | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应先征求确认);meta 工具用于报告使用情况、管理订阅或提交功能申请。
定价
| 方案 | 价格 | 限额 |
|---|---|---|
| Free(每个 A-Cube 账户) | $0 | 每月 50 次工具调用 |
| Pro(每个 A-Cube 账户) | $9/mo 或 $90/yr(免费 2 个月) | 无限制* |
*此服务上的 Pro 方案每月公平使用限额为 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 acube_upgrade 订阅(它会返回 Stripe Checkout 链接)。可随时使用 acube_cancel_subscription 取消:Pro 将持续到已付费周期结束,当前周期不予退款;在此之前运行 acube_upgrade 可撤销取消操作。也可发送邮件至 [email protected]。
许可证
MIT
账户访问与数据
使用已授权的 A-Cube API 账户,并选择沙盒或生产环境。您的意大利生产环境 API 合同必须允许此托管连接。客户入驻、供应商订阅和税务处理费用需另行支付。我们不声称获得供应商应用审批或认可。
您的密码仅用于本次登录,不会存储在托管连接中。仅会加密保留供应商 JWT、电子邮件、环境、到期时间和计费身份。供应商令牌最长有效期为 24 小时;到期或撤销后请重新连接。不会进行静默密码登录,也不会虚构刷新端点。断开 UsefulAPI 即可停止此连接;已签发的 JWT 可能仍然有效,直到 A-Cube 使其过期或将其撤销。计费依据经验证的账户 UID,通常不受密码变更和环境切换影响。
请求的税务发票、税号、收据和业务记录会传送至您连接的 AI 客户端和大模型提供商。请仅连接您获准在这些服务中处理的数据。
创建草稿只会保存草稿,不会发送。提交和删除操作需要明确确认;未获确认时,工具会返回预览。生产环境中的提交属于法律行为,可能产生费用。A-Cube 的确认表示已接受发送,并不代表 SDI 已确认送达:请查看发票通知。结果不确定时,请先在 A-Cube 中核查,再重试。不会自动重放任何操作。
已根据当前 API 规范和本地模拟服务检查全部 24 个工具。合成发票测试数据符合必填字段和类型要求,但并非经过法律验证的发票。未测试真实客户数据、SDI 提交、收据或费用。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。