Qoyod MCP Server

Небольшой MCP-сервер (Model Context Protocol), который подключает Claude напрямую к бухгалтерской программе قيود (Qoyod) через их официальный REST API (https://api.qoyod.com/2.0).

После развёртывания (deploy) на любом хостинге вы получаете HTTPS-ссылку вида:

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

Вы добавляете эту ссылку как Custom Connector в настройках Claude, и 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_*) проверяйте правильную форму payload через apidoc.qoyod.com или сначала попробуйте через 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. Полная MCP-ссылка, которую вы будете использовать в Claude: 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, чтобы выпустить новый ключ, который немедленно аннулирует старый.