Qoyod MCP Server

Claude を、会計ソフト Qoyod（قيود） の公式 REST API（https://api.qoyod.com/2.0）を介して直接接続する、小さな MCP（Model Context Protocol）サーバーです。

デプロイ（deploy）すると、任意のホスティングで次のような HTTPS URL を取得できます。

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

この URL を Claude の設定画面で Custom Connector として追加すると、Claude は、顧客、請求書、仕入先、日次仕訳、そしてそれ以外の Qoyod のリソースも、ブラウザを開く必要なく、どの会話でも読み取り・作成できるようになります。

1) 利用可能なツール（Tools）

• qoyod_request — apidoc.qoyod.com に文書化された任意のリソース（Accounts、Products、Inventories、Vendors、Purchase Orders、Bills、Customers、Quotes、Invoices、Credit/Debit Notes、Receipts、Journal Entries、…）をカバーする汎用（passthrough）ツール。

• すぐに使えるツール：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。

注意：Qoyod の一般的なドキュメントは、すべてのリソースのすべてのフィールドを詳しく説明しているとは限りません。作成系（create_*）の操作では、apip の正しい 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 リポジトリにアップロードします（git に慣れていない場合は、github.com で空のリポジトリを作成し、Web インターフェースから直接ファイルをアップロードしても構いません）。

3. Render のダッシュボードで New + → Web Service → リポジトリを選択します。

4. 設定：

   • Build Command: npm install

   • Start Command: npm start

   • Environment Variable: QOYOD_API_KEY を追加し、値に Qoyod の API キーを指定します。

5. Deploy を押します。ビルドが完了すると、次のような URL が取得できます： https://qoyod-mcp-server.onrender.com

6. Claude で使う完全な MCP の URL は次のとおりです： 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. 次の URL を貼り付けます：https://your-app.onrender.com/mcp

3. 保存します。その後、このコネクタを有効にした任意の会話で、Claude が使えるツールとして Qoyod のツールが表示されます。

5) セキュリティ

• API キーは、ホスティング上の環境変数（QOYOD_API_KEY）としてのみ保存されます。コード内に表示されることも、他の誰かに送信されることもありません。

• 自分が信頼する人以外に、この /mcp の URL を共有しないでください。この URL は、関連する Qoyod アカウントに（キーの権限に応じて）フルアクセスを許可するものになります。

• API キーが漏えいした疑いがある場合は、Qoyod → 一般設定 → Generate New Key を押してください。新しいキーが発行され、古いキーは直ちに無効になります。