Qoyod MCP Server

一个小型 MCP (Model Context Protocol) 服务器，通过其官方 REST API（https://api.qoyod.com/2.0）将 Claude 直接连接到 قيود (Qoyod) 会计软件。

部署到任何托管平台后，你会得到一个 HTTPS 链接，例如：

https://your-app.onrender.com/mcp

你可以在 Claude 设置中把这个链接添加为 Custom Connector，之后 Claude 就能在任何对话中读取和创建客户、发票、供应商、日记账分录以及 قيود 的其他资源——无需打开浏览器。

1) 可用的工具 (Tools)

• qoyod_request — 一个通用（passthrough）工具，覆盖 apidoc.qoyod.com 中任何已记录的资源（Accounts、Products、Inventories、Vendors、Purchase Orders、Bills、Customers、Quotes、Invoices、Credit/Debit Notes、Receipts、Journal Entries...）。

• 可直接快速使用的现成工具：qoyod_list_customers, qoyod_get_customer, qoyod_create_customer, qoyod_list_products, qoyod_list_invoices, qoyod_get_invoice, qoyod_create_invoice, qoyod_list_bills, qoyod_list_vendors, qoyod_list_journal_entries, qoyod_create_journal_entry, qoyod_list_accounts。

注意：قيود 的公开文档并未详细列出每个资源的每个字段。在执行创建操作（create_*）时，请通过 apidoc.qoyod.com 确认正确的 payload 格式，或先用 qoyod_request 配合测试数据尝试一下。

Related MCP server: Piriod MCP Server

2) 本地运行（可选，用于部署前测试）

需要 Node.js 18 或更高版本。

npm install
cp .env.example .env
# افتح .env وضع مفتاح الـ API الخاص بك من قيود (Settings > General Settings > API Key)
npm start

服务器将运行在 http://localhost:3000/mcp。

3) 部署（Deploy）到免费托管平台——以 Render.com 为例

1. 在 render.com 上创建一个免费账户（或使用 GitHub 账户登录）。

2. 将此文件夹上传到一个新的 GitHub 仓库（你可以在 github.com 上创建一个空仓库，然后如果不熟悉 git，可以直接通过网页界面上传文件）。

3. 在 Render 控制面板中：New + → Web Service → 选择仓库。

4. 设置：

   • Build Command: npm install

   • Start Command: npm start

   • Environment Variable: 添加 QOYOD_API_KEY，其值为来自 قيود 的 API 密钥。

5. 点击 Deploy。构建完成后，你会得到一个类似这样的链接： https://qoyod-mcp-server.onrender.com

6. 你将在 Claude 中使用的完整 MCP 链接是： https://qoyod-mcp-server.onrender.com/mcp

其他替代方案

大致相同的步骤也适用于 Railway、Fly.io 和 Cloudflare Workers（需要稍作修改以兼容 Workers 环境）。

关于 Render 免费版的说明：服务器在空闲一段时间后会“休眠”，休眠后的第一个请求需要约 30-50 秒。如果你希望始终即时响应，则需要付费套餐或选择其他不会让服务休眠的托管平台。

4) 将其连接到 Claude

1. 在 Claude 设置中，找到 Connectors（连接器）部分 → Add custom connector。

2. 粘贴链接：https://your-app.onrender.com/mcp

3. 保存。之后，在任何启用了此连接器的对话中，قيود 的工具都会出现在 Claude 的可用工具中。

5) 安全

• 你的 API 密钥仅作为环境变量（QOYOD_API_KEY）存储在你的托管平台上——不会出现在代码中，也不会发送给任何其他方。

• 不要与你信任之外的任何人分享你的 /mcp 链接；它提供了对关联 قيود 账户的完全访问权限（取决于密钥的权限）。

• 如果你怀疑密钥已泄露，请前往 قيود → 常规设置 → 点击 Generate New Key 生成一个新密钥，它会立即作废旧密钥。