关于 Vyfakturuj MCP by usefulapi
Vyfakturuj MCP 服务让 Claude、Cursor 等 MCP 客户端通过托管端点访问 Vyfakturuj,并使用账户凭据登录。它支持查询和创建发票及联系人,并读取编号系列、付款方式和标签。
主要功能
- 01查询和读取发票
- 02创建带正式编号的发票
- 03查询和创建联系人
- 04查看定期发票模板
- 05读取编号系列、付款方式和标签
适用场景
- 01搜索或查看现有发票
- 02在 Vyfakturuj 中创建发票
- 03查询或新增客户联系人
- 04核对发票编号系列和付款方式
MCP 相关
这是托管的 MCP 服务,向 MCP 客户端提供 Vyfakturuj 发票、联系人、编号系列、付款方式和标签相关工具。使用 OAuth 登录并通过登录页提交 Vyfakturuj 凭据。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://vyfakturuj.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-vyfakturuj https://vyfakturuj.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-vyfakturuj":{"type":"http","url":"https://vyfakturuj.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-vyfakturuj":{"type":"http","url":"https://vyfakturuj.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-vyfakturuj":{"type":"http","url":"https://vyfakturuj.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-vyfakturuj":{"serverUrl":"https://vyfakturuj.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
10| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| q | string | 否 | 对发票进行全文搜索。 |
| VS | string | 否 | Variable symbol (variabilni symbol). |
| sort | string | 否 | 排序:column~asc 或 column~desc,多个条件以 | 连接(例如 date_created~desc|number~asc)。 |
| type | any | 否 | Document type: 1 faktura, 2 zalohova faktura, 4 proforma, 8 vyzva k platbe, 16 danovy doklad, 32 opravny danovy doklad, 64 prijmovy doklad, 128 opravny doklad, 512 objednavka. |
| number | string | 否 | 精确文档编号。 |
| currency | string | 否 | 货币,ISO 4217,例如 CZK、EUR。 |
| rows_limit | integer | 否 | 要返回的行数,1–100(默认值为 25)。 |
| id_customer | any | 否 | 仅返回此通讯录联系人的发票(来自 vyfakturuj_list_contacts)。 |
| rows_offset | integer | 否 | 要跳过的行数(默认值为 0)。使用上一条回复中的 next_offset。 |
| date_created_to | string | 否 | 在此日期(yyyy-mm-dd)当天或之前创建的交易。 |
| date_created_from | string | 否 | 在此日期(yyyy-mm-dd)当天或之后创建的交易。 |
详细介绍
usefulapi 提供的 Vyfakturuj MCP
通过 Claude、Cursor 或任何 MCP 客户端使用 Vyfakturuj——搜索发票和联系人、创建发票和联系人、读取编号序列、付款方式和标签。 托管服务,无需本地安装:使用你自己的 Vyfakturuj 凭据连接。
实时端点: https://vyfakturuj.usefulapi.io/mcp · 主页: https://usefulapi.io/vyfakturuj
连接
- Claude(claude.ai、桌面版):打开 自定义 → 连接器,点击 + 添加 → 添加自定义连接器,然后粘贴
https://vyfakturuj.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http vyfakturuj https://vyfakturuj.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"vyfakturuj": {
"url": "https://vyfakturuj.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Vyfakturuj 凭据。
分步设置指南、凭据查找方法和常见问题:https://usefulapi.io/vyfakturuj/
工具
| 工具 | 类型 | 功能 |
|---|---|---|
vyfakturuj_list_invoices | 读取 | 列出发票 |
vyfakturuj_get_invoice | 读取 | 获取发票 |
vyfakturuj_create_invoice | 写入 | 创建发票(开具带有真实编号的单据) |
vyfakturuj_list_contacts | 读取 | 列出联系人 |
vyfakturuj_get_contact | 读取 | 获取联系人 |
vyfakturuj_create_contact | 写入 | 创建联系人 |
vyfakturuj_get_template | 读取 | 获取定期开票模板 |
vyfakturuj_list_payment_methods | 读取 | 列出付款方式 |
vyfakturuj_list_number_series | 读取 | 列出编号序列 |
vyfakturuj_list_tags | 读取 | 列出标签 |
vyfakturuj_usage_status | 元信息 | 使用状态(免费套餐用量计数) |
vyfakturuj_request_feature | 元信息 | 申请添加缺失功能 |
vyfakturuj_upgrade | 元信息 | 升级到 Pro(无限*) |
vyfakturuj_cancel_subscription | 元信息 | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应先确认);meta 工具会报告用量、管理订阅或发送功能请求。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| 免费版 | $0 | 每月 50 次工具调用 |
| Pro(每位用户) | $9/月 或 $90/年(免费 2 个月) | 无限* |
*此服务上的 Pro 套餐设有合理使用限额,每月 10,000 次工具调用。需要更多调用次数,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 vyfakturuj_upgrade 订阅(该工具会返回 Stripe Checkout 链接)。可随时使用 vyfakturuj_cancel_subscription 取消:Pro 会持续到已付费周期结束,当前周期不退款;在此之前运行 vyfakturuj_upgrade 可撤销取消操作。或者发送邮件至 [email protected]。
许可证
MIT © usefulapi。与 Vyfakturuj 无关联,亦未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。