Tillhub MCP by usefulapi について
Tillhub MCP by usefulapi は、Tillhub の小売記録にアクセスするホスト型 MCP サーバーです。商品、在庫、売上、顧客、業務レポートを読み取り専用ツールで照会でき、OAuth でログインします。
主な機能
- 01商品一覧と検索
- 02在庫と在庫移動の確認
- 03取引とレシートの照会
- 04売上高と販売レポートの確認
- 05顧客、店舗、スタッフの照会
活用シーン
- 01在庫数と商品情報の確認
- 02期間別・時間別の販売状況確認
- 03顧客や取引記録の検索
MCP 対応
読み取り専用ツールで、Tillhub のアカウント情報と小売データを MCP クライアントに公開します。クライアントはホスト型エンドポイントに接続し、OAuth で認証します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://tillhub.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-tillhub https://tillhub.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-tillhub":{"type":"http","url":"https://tillhub.usefulapi.io/mcp"}}}Cursor で開く{"servers":{"io-usefulapi-tillhub":{"type":"http","url":"https://tillhub.usefulapi.io/mcp"}}}VS Code で開く{"mcpServers":{"io-usefulapi-tillhub":{"type":"http","url":"https://tillhub.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-tillhub":{"serverUrl":"https://tillhub.usefulapi.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
usefulapi の Tillhub MCP
https://tillhub.usefulapi.io/mcp で小売データを読み取ります。
接続
- Claude(claude.ai、Desktop):Customize → Connectors を開き、+ Add → Add custom connector をクリックして、
https://tillhub.usefulapi.io/mcpを貼り付けます。 - Claude Code:
claude mcp add --transport http tillhub https://tillhub.usefulapi.io/mcpを実行し、続けて/mcpを実行してログインします。 - VS Code: VS Code に追加。
- Cursor などのクライアント: リモート MCP サーバーとして URL を追加します。
{
"mcpServers": {
"tillhub": {
"url": "https://tillhub.usefulapi.io/mcp"
}
}
}
URL のみを追加してください。クライアントの設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインを行い、ログインページで Tillhub の認証情報を求められます。
手順ごとのセットアップ方法、認証情報の確認場所、よくある質問:https://usefulapi.io/tillhub/
ツール
| ツール | 種類 | 説明 |
|---|---|---|
tillhub_get_account | 読み取り | API ユーザーとアカウントを取得 |
tillhub_list_products | 読み取り | 商品一覧を取得 |
tillhub_search_products | 読み取り | 商品を検索 |
tillhub_get_product | 読み取り | 商品を取得 |
tillhub_list_product_groups | 読み取り | 商品グループ一覧を取得 |
tillhub_list_tags | 読み取り | タグ一覧を取得 |
tillhub_list_transactions | 読み取り | 取引一覧を取得 |
tillhub_get_transaction | 読み取り | 取引を取得 |
tillhub_transactions_report | 読み取り | 取引レポート |
tillhub_list_receipts | 読み取り | レシート一覧を取得 |
tillhub_revenue_sum | 読み取り | 期間内の売上合計 |
tillhub_sales_aggregate | 読み取り | 時間別または日別の売上 |
tillhub_top_products | 読み取り | 人気商品 |
tillhub_list_balances | 読み取り | レジ残高一覧を取得 |
tillhub_list_customers | 読み取り | 顧客一覧を取得 |
tillhub_search_customers | 読み取り | 顧客を検索 |
tillhub_get_customer | 読み取り | 顧客を取得 |
tillhub_list_branches | 読み取り | 店舗一覧を取得 |
tillhub_list_registers | 読み取り | レジ一覧を取得 |
tillhub_list_staff | 読み取り | スタッフ一覧を取得 |
tillhub_list_payment_options | 読み取り | 支払い方法一覧を取得 |
tillhub_list_taxes | 読み取り | 税一覧を取得 |
tillhub_list_discounts | 読み取り | 割引一覧を取得 |
tillhub_list_stock | 読み取り | 在庫数一覧を取得 |
tillhub_list_stock_locations | 読み取り | 在庫ロケーション一覧を取得 |
tillhub_list_stock_book | 読み取り | 在庫移動一覧を取得 |
tillhub_list_orders | 読み取り | 注文一覧を取得 |
tillhub_usage_status | メタ | 使用状況(無料プランの利用回数) |
tillhub_request_feature | メタ | 不足している機能をリクエスト |
tillhub_upgrade | メタ | Pro または Pro+ にアップグレード |
tillhub_cancel_subscription | メタ | Pro サブスクリプションをキャンセル |
read ツールは読み取り専用です。write ツールはデータを変更するため、クライアント側で確認が必要です。meta ツールは使用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。
料金
| プラン | 料金 | 上限 |
|---|---|---|
| Free | $0 | 月50回のツール呼び出し |
| Pro(Tillhub アカウントごと) | $9/mo または $90/yr(2か月分無料) | 無制限* |
*Pro には、このサーバーで月10,000回のツール呼び出しという公正利用上限があります。それ以上必要な場合は、[email protected] にお問い合わせください。
Pro の対象はこのサーバーのみです。tillhub_upgrade で登録してください(Stripe Checkout リンクが返されます)。tillhub_cancel_subscription でいつでもキャンセルできます。Pro は支払い済み期間の終了まで利用でき、現在の期間分の返金はありません。その前に tillhub_upgrade を実行すると、キャンセルは取り消されます。または [email protected] にお問い合わせください。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。