KiotViet MCP by usefulapi

usefulapi による KiotViet MCP

ライブエンドポイント： https://kiotviet.usefulapi.io/mcp

接続

• Claude（claude.ai、Desktop）：Customize → Connectors を開き、+ Add → Add custom connector をクリックして、https://kiotviet.usefulapi.io/mcp を貼り付けます。
• Claude Code： claude mcp add --transport http kiotviet https://kiotviet.usefulapi.io/mcp を実行し、続けて /mcp を実行してログインします。
• VS Code： VS Code に追加。
• Cursor およびその他のクライアント： リモート MCP サーバーとして URL を追加します。

{
  "mcpServers": {
    "kiotviet": {
      "url": "https://kiotviet.usefulapi.io/mcp"
    }
  }
}

URL のみを追加してください。クライアント設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインを処理し、ログインページで KiotViet の認証情報を求めます。

設定手順、認証情報の確認方法、FAQ：https://usefulapi.io/kiotviet/

初回接続時に、KiotViet の Client ID、シークレット、ショップ名を入力します。これらは検証されたうえでユーザーごとに保存され、あなた専用に使用されます。設定ファイルにキーを保存する必要はありません。

ツール

ツール	種類	機能
kiotviet_list_products	読み取り	商品一覧を取得
kiotviet_get_product	読み取り	商品を取得
kiotviet_get_product_by_code	読み取り	コードで商品を取得
kiotviet_list_categories	読み取り	カテゴリー一覧を取得
kiotviet_get_category	読み取り	カテゴリーを取得
kiotviet_list_customers	読み取り	顧客一覧を取得
kiotviet_get_customer	読み取り	顧客を取得
kiotviet_get_customer_by_code	読み取り	コードで顧客を取得
kiotviet_create_customer	書き込み	顧客を作成
kiotviet_list_invoices	読み取り	請求書一覧を取得
kiotviet_get_invoice	読み取り	請求書を取得
kiotviet_get_invoice_by_code	読み取り	コードで請求書を取得
kiotviet_list_orders	読み取り	販売注文一覧を取得
kiotviet_get_order	読み取り	販売注文を取得
kiotviet_get_order_by_code	読み取り	コードで販売注文を取得
kiotviet_create_order	書き込み	販売注文を作成
kiotviet_list_branches	読み取り	支店一覧を取得
kiotviet_list_stock	読み取り	現在庫一覧を取得
kiotviet_list_suppliers	読み取り	仕入先一覧を取得
kiotviet_get_supplier	読み取り	仕入先を取得
kiotviet_list_purchase_orders	読み取り	入庫一覧を取得
kiotviet_get_purchase_order	読み取り	入庫を取得
kiotviet_list_supplier_orders	読み取り	仕入先注文一覧を取得
kiotviet_list_returns	読み取り	返品一覧を取得
kiotviet_get_return	読み取り	返品を取得
kiotviet_list_cashflow	読み取り	キャッシュフロー一覧を取得
kiotviet_list_users	読み取り	ユーザー一覧を取得
kiotviet_list_price_books	読み取り	価格表一覧を取得
kiotviet_get_price_book	読み取り	価格表の価格を取得
kiotviet_usage_status	メタ	使用状況（無料プランの利用量）
kiotviet_request_feature	メタ	不足している機能をリクエスト
kiotviet_upgrade	メタ	Pro にアップグレード（無制限*）
kiotviet_cancel_subscription	メタ	Pro サブスクリプションをキャンセル

read ツールは読み取り専用です。write ツールはデータを変更するため、クライアント側で確認が必要です。meta ツールは使用状況の報告、サブスクリプションの管理、または機能リクエストの送信を行います。

料金

プラン	料金	上限
Free	$0	月あたりツール呼び出し 50 回
Pro（ストアアカウントごと）	$9/月 または $90/年（2 か月分無料）	無制限*

*Pro では、このサーバーで月あたり 10,000 回のツール呼び出しをフェアユース上限として設定しています。これを超える場合は [email protected] までお問い合わせください。

Pro の対象はこのサーバーのみです。kiotviet_upgrade で登録すると、Stripe Checkout のリンクが返されます。kiotviet_cancel_subscription でいつでもキャンセルできます。Pro は支払い済み期間の終了まで利用でき、現在の期間の返金はありません。期間終了前に kiotviet_upgrade を実行すると、キャンセルは取り消されます。[email protected] へのお問い合わせも可能です。

ライセンス

MIT