Qoyod MCP Server

Ein kleiner MCP-Server (Model Context Protocol), der Claude direkt mit der Buchhaltungssoftware قيود (Qoyod) über deren offizielle REST-API (https://api.qoyod.com/2.0) verbindet.

Nach dem Deployment auf einem beliebigen Hosting erhältst du einen HTTPS-Link wie:

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

Du fügst diesen Link als Custom Connector in den Claude-Einstellungen hinzu, und Claude kann dann Kunden, Rechnungen, Lieferanten, Journalbuchungen und andere Qoyod-Ressourcen in jedem Gespräch lesen und erstellen – ohne den Browser öffnen zu müssen.

1) Verfügbare Tools

• qoyod_request – ein allgemeines (Passthrough-)Tool, das jede dokumentierte Ressource auf apidoc.qoyod.com abdeckt (Accounts, Products, Inventories, Vendors, Purchase Orders, Bills, Customers, Quotes, Invoices, Credit/Debit Notes, Receipts, Journal Entries...).

• Vorgefertigte Tools für die schnelle Nutzung: 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.

Hinweis: Die allgemeine Qoyod-Dokumentation listet nicht alle Felder jeder Ressource im Detail auf. Überprüfe beim Erstellen (create_*) die korrekte Payload-Form über apidoc.qoyod.com oder teste zuerst über qoyod_request mit Testdaten.

Related MCP server: Piriod MCP Server

2) Lokaler Betrieb (optional, zum Testen vor dem Deployment)

Erfordert Node.js 18 oder neuer.

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

Der Server läuft dann auf http://localhost:3000/mcp.

3) Deployment auf kostenlosem Hosting – Beispiel mit Render.com

1. Erstelle ein kostenloses Konto auf render.com (oder verwende dein GitHub-Konto zum Anmelden).

2. Lade diesen Ordner in ein neues GitHub-Repository hoch (du kannst ein leeres Repository auf github.com erstellen und die Dateien direkt über die Weboberfläche hochladen, wenn du mit git nicht vertraut bist).

3. Im Render-Dashboard: New + → Web Service → wähle das Repository.

4. Einstellungen:

   • Build Command: npm install

   • Start Command: npm start

   • Environment Variable: Füge QOYOD_API_KEY hinzu, mit deinem API-Schlüssel von Qoyod als Wert.

5. Klicke auf Deploy. Nach Abschluss des Builds erhältst du einen Link wie: https://qoyod-mcp-server.onrender.com

6. Der vollständige MCP-Link, den du in Claude verwendest, lautet: https://qoyod-mcp-server.onrender.com/mcp

Andere Alternativen

Die gleichen Schritte gelten weitgehend für Railway, Fly.io und Cloudflare Workers (erfordert eine kleine Anpassung für die Workers-Umgebung).

Hinweis zum kostenlosen Plan bei Render: Der Server „schläft“ nach einer Zeit der Inaktivität und benötigt ~30-50 Sekunden für die erste Anfrage nach dem Ruhezustand. Wenn du immer eine sofortige Antwort möchtest, benötigst du einen kostenpflichtigen Plan oder ein anderes Hosting, das den Dienst nicht in den Ruhezustand versetzt.

4) Verbindung mit Claude

1. Suche in den Claude-Einstellungen den Bereich Connectors → Add custom connector.

2. Füge den Link ein: https://your-app.onrender.com/mcp

3. Speichern. Danach erscheinen die Qoyod-Tools unter den verfügbaren Claude-Tools in jedem Gespräch, in dem du diesen Connector aktivierst.

5) Sicherheit

• Dein API-Schlüssel wird nur als Umgebungsvariable (QOYOD_API_KEY) auf deinem Hosting gespeichert – er erscheint nicht im Code und wird an keine andere Partei gesendet.

• Teile deinen /mcp-Link nicht mit Personen, denen du nicht vertraust; er gewährt vollen Zugriff auf das damit verbundene Qoyod-Konto (entsprechend den Berechtigungen des Schlüssels).

• Wenn du vermutest, dass der Schlüssel kompromittiert wurde, gehe zu Qoyod → Allgemeine Einstellungen → klicke auf Generate New Key, um einen neuen Schlüssel zu erstellen, der den alten sofort ungültig macht.