プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Clover POS

作者:SBolivarLoLバージョン 0.7.0i★ 1iパソコンで動くリポジトリ ↗
レジストリ名io.github.SBolivarLoL/clover-mcp

インストール方法

What it does

Clover POS for a single merchant: sales, inventory, orders, customers (reads + safe writes).

  • Connects パソコンで動く
  • Account or key Needs CLOVER_ACCESS_TOKEN, CLOVER_AUTH_MODE, CLOVER_REFRESH_TOKEN, CLOVER_OAUTH_CLIENT_SECRET · 1 setting to fill in (CLOVER_MERCHANT_ID)
  • Category ネットショップ・決済

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気4/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア16/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Clover POS をインストールして。https://mcp.popnx.com/i/sbolivarlol-clover-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

Clover POS のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (CLOVER_MERCHANT_ID) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server Clover POS を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "clover": { "command": "uvx", "args": [ "clover-mcp" ], "env": { "CLOVER_MERCHANT_ID": "your-value", "CLOVER_ACCESS_TOKEN": "your-value", "CLOVER_AUTH_MODE": "your-value", "CLOVER_REFRESH_TOKEN": "your-value", "CLOVER_OAUTH_CLIENT_SECRET": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) CLOVER_ACCESS_TOKEN, CLOVER_AUTH_MODE, CLOVER_REFRESH_TOKEN, CLOVER_OAUTH_CLIENT_SECRET, CLOVER_MERCHANT_ID は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Clover POS のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. Clover POS に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • CLOVER_MERCHANT_ID Clover マーチャント ID
      英語の原文を見るClover merchant ID

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  5. この設定を貼り付けて保存

    {
      "mcpServers": {
        "clover": {
          "command": "uvx",
          "args": [
            "clover-mcp"
          ],
          "env": {
            "CLOVER_MERCHANT_ID": "your-value",
            "CLOVER_ACCESS_TOKEN": "your-value",
            "CLOVER_AUTH_MODE": "your-value",
            "CLOVER_REFRESH_TOKEN": "your-value",
            "CLOVER_OAUTH_CLIENT_SECRET": "your-value"
          }
        }
      }
    }

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Claude を終了してもう一度開く

  7. 試してみる

    Clover POS を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Clover POS を使っていると言うか、回答に Clover POS のツール名が出れば接続成功です

追加の設定 3 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • CLOVER_REGION Clover APIのリージョン: na eu la
    英語の原文を見るClover API region: na | eu | la
    · 初期値 na
  • CLOVER_SANDBOX true の場合、Clover サンドボックスホストを使用します。
    英語の原文を見るUse the Clover sandbox host when true
    · 初期値 false
  • CLOVER_OAUTH_CLIENT_ID OAuth アプリのクライアント ID(oauth_refresh モード)。
    英語の原文を見るOAuth app client ID (oauth_refresh mode)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Clover POS につなげません

Clover POS はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Clover POS につなげるアプリを使う

  • Clover POS のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (CLOVER_MERCHANT_ID) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • Clover POS のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (CLOVER_MERCHANT_ID) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • Clover POS のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (CLOVER_MERCHANT_ID) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • Clover POS のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (CLOVER_MERCHANT_ID) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

B · ネットショップ・決済 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

Clover POS のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (CLOVER_MERCHANT_ID) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server Clover POS を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user clover --env CLOVER_MERCHANT_ID=your-value --env CLOVER_ACCESS_TOKEN=your-value --env CLOVER_AUTH_MODE=your-value --env CLOVER_REFRESH_TOKEN=your-value --env CLOVER_OAUTH_CLIENT_SECRET=your-value -- uvx clover-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) CLOVER_ACCESS_TOKEN, CLOVER_AUTH_MODE, CLOVER_REFRESH_TOKEN, CLOVER_OAUTH_CLIENT_SECRET, CLOVER_MERCHANT_ID は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Clover POS のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. Clover POS に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • CLOVER_MERCHANT_ID Clover マーチャント ID
      英語の原文を見るClover merchant ID

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  5. このコマンドを貼り付けて Enter

    claude mcp add --scope user clover --env CLOVER_MERCHANT_ID=your-value --env CLOVER_ACCESS_TOKEN=your-value --env CLOVER_AUTH_MODE=your-value --env CLOVER_REFRESH_TOKEN=your-value --env CLOVER_OAUTH_CLIENT_SECRET=your-value -- uvx clover-mcp

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Claude Code で /mcp と入力

    Clover POS が一覧にあり、接続済みと表示されれば OK です

  7. 試してみる

    Clover POS を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Clover POS を使っていると言うか、回答に Clover POS のツール名が出れば接続成功です

追加の設定 3 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • CLOVER_REGION Clover APIのリージョン: na eu la
    英語の原文を見るClover API region: na | eu | la
    · 初期値 na
  • CLOVER_SANDBOX true の場合、Clover サンドボックスホストを使用します。
    英語の原文を見るUse the Clover sandbox host when true
    · 初期値 false
  • CLOVER_OAUTH_CLIENT_ID OAuth アプリのクライアント ID(oauth_refresh モード)。
    英語の原文を見るOAuth app client ID (oauth_refresh mode)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

Clover POS のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (CLOVER_MERCHANT_ID) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server Clover POS を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "clover": { "command": "uvx", "args": [ "clover-mcp" ], "env": { "CLOVER_MERCHANT_ID": "your-value", "CLOVER_ACCESS_TOKEN": "your-value", "CLOVER_AUTH_MODE": "your-value", "CLOVER_REFRESH_TOKEN": "your-value", "CLOVER_OAUTH_CLIENT_SECRET": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) CLOVER_ACCESS_TOKEN, CLOVER_AUTH_MODE, CLOVER_REFRESH_TOKEN, CLOVER_OAUTH_CLIENT_SECRET, CLOVER_MERCHANT_ID は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Clover POS のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. Clover POS に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • CLOVER_MERCHANT_ID Clover マーチャント ID
      英語の原文を見るClover merchant ID

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  5. キーを入力

    Clover POS の設定で CLOVER_ACCESS_TOKEN, CLOVER_AUTH_MODE, CLOVER_REFRESH_TOKEN, CLOVER_OAUTH_CLIENT_SECRET, CLOVER_MERCHANT_ID が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Cursor の AI チャットを Agent モードで開く

  7. 試してみる

    Clover POS を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Clover POS を使っていると言うか、回答に Clover POS のツール名が出れば接続成功です

追加の設定 3 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • CLOVER_REGION Clover APIのリージョン: na eu la
    英語の原文を見るClover API region: na | eu | la
    · 初期値 na
  • CLOVER_SANDBOX true の場合、Clover サンドボックスホストを使用します。
    英語の原文を見るUse the Clover sandbox host when true
    · 初期値 false
  • CLOVER_OAUTH_CLIENT_ID OAuth アプリのクライアント ID(oauth_refresh モード)。
    英語の原文を見るOAuth app client ID (oauth_refresh mode)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

Clover POS のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (CLOVER_MERCHANT_ID) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server Clover POS を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "clover": { "type": "stdio", "command": "uvx", "args": [ "clover-mcp" ], "env": { "CLOVER_MERCHANT_ID": "your-value", "CLOVER_ACCESS_TOKEN": "your-value", "CLOVER_AUTH_MODE": "your-value", "CLOVER_REFRESH_TOKEN": "your-value", "CLOVER_OAUTH_CLIENT_SECRET": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) CLOVER_ACCESS_TOKEN, CLOVER_AUTH_MODE, CLOVER_REFRESH_TOKEN, CLOVER_OAUTH_CLIENT_SECRET, CLOVER_MERCHANT_ID は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Clover POS のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. Clover POS に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • CLOVER_MERCHANT_ID Clover マーチャント ID
      英語の原文を見るClover merchant ID

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  5. キーを入力

    Clover POS の設定で CLOVER_ACCESS_TOKEN, CLOVER_AUTH_MODE, CLOVER_REFRESH_TOKEN, CLOVER_OAUTH_CLIENT_SECRET, CLOVER_MERCHANT_ID が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. VS Code の AI チャットを Agent モードで開く

  7. 試してみる

    Clover POS を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Clover POS を使っていると言うか、回答に Clover POS のツール名が出れば接続成功です

追加の設定 3 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • CLOVER_REGION Clover APIのリージョン: na eu la
    英語の原文を見るClover API region: na | eu | la
    · 初期値 na
  • CLOVER_SANDBOX true の場合、Clover サンドボックスホストを使用します。
    英語の原文を見るUse the Clover sandbox host when true
    · 初期値 false
  • CLOVER_OAUTH_CLIENT_ID OAuth アプリのクライアント ID(oauth_refresh モード)。
    英語の原文を見るOAuth app client ID (oauth_refresh mode)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Clover POS を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user clover --env CLOVER_MERCHANT_ID=your-value --env CLOVER_ACCESS_TOKEN=your-value --env CLOVER_AUTH_MODE=your-value --env CLOVER_REFRESH_TOKEN=your-value --env CLOVER_OAUTH_CLIENT_SECRET=your-value -- uvx clover-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "clover": {
      "command": "uvx",
      "args": [
        "clover-mcp"
      ],
      "env": {
        "CLOVER_MERCHANT_ID": "your-value",
        "CLOVER_ACCESS_TOKEN": "your-value",
        "CLOVER_AUTH_MODE": "your-value",
        "CLOVER_REFRESH_TOKEN": "your-value",
        "CLOVER_OAUTH_CLIENT_SECRET": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "clover": {
      "command": "uvx",
      "args": [
        "clover-mcp"
      ],
      "env": {
        "CLOVER_MERCHANT_ID": "your-value",
        "CLOVER_ACCESS_TOKEN": "your-value",
        "CLOVER_AUTH_MODE": "your-value",
        "CLOVER_REFRESH_TOKEN": "your-value",
        "CLOVER_OAUTH_CLIENT_SECRET": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "clover": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "clover-mcp"
      ],
      "env": {
        "CLOVER_MERCHANT_ID": "your-value",
        "CLOVER_ACCESS_TOKEN": "your-value",
        "CLOVER_AUTH_MODE": "your-value",
        "CLOVER_REFRESH_TOKEN": "your-value",
        "CLOVER_OAUTH_CLIENT_SECRET": "your-value"
      }
    }
  }
}

自分で入力する値

  • CLOVER_MERCHANT_ID 必須 env
    Clover マーチャント ID
    英語の原文を見るClover merchant ID
  • CLOVER_ACCESS_TOKEN 秘密 必須 env
    Clover APIアクセストークン
    英語の原文を見るClover API access token
  • CLOVER_REGION env
    Clover APIのリージョン: na eu la
    英語の原文を見るClover API region: na | eu | la
  • CLOVER_SANDBOX env
    true の場合、Clover サンドボックスホストを使用します。
    英語の原文を見るUse the Clover sandbox host when true
  • CLOVER_AUTH_MODE 秘密 必須 env
    認証モード: token oauth_refresh
    英語の原文を見るAuth mode: token | oauth_refresh
  • CLOVER_REFRESH_TOKEN 秘密 必須 env
    OAuth リフレッシュトークン(oauth_refresh モード)
    英語の原文を見るOAuth refresh token (oauth_refresh mode)
  • CLOVER_OAUTH_CLIENT_ID env
    OAuth アプリのクライアント ID(oauth_refresh モード)。
    英語の原文を見るOAuth app client ID (oauth_refresh mode)
  • CLOVER_OAUTH_CLIENT_SECRET 秘密 必須 env
    OAuth アプリのクライアントシークレット(oauth_refresh モード)。
    英語の原文を見るOAuth app client secret (oauth_refresh mode)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
41/週
接続方法
パソコンで動く
最新バージョンi
0.7.0
レジストリ公開日i
2026年7月2日
コードの最終更新i
2026年11月18日
作者
SBolivarLoL
パッケージ
pypi: clover-mcp
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント SBolivarLoL で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に clover-mcp@0.7.0 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月16日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/sbolivarlol-clover-mcp.svg)](https://mcp.popnx.com/en/servers/sbolivarlol-clover-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

ネットショップ・決済のほかのサーバーとの比較i

  • このカテゴリのほかの2932件のうち89%よりスターが多い
  • このカテゴリのほかの2932件のうち11%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの2932件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Clover POSは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:CLOVER_ACCESS_TOKEN, CLOVER_AUTH_MODE, CLOVER_REFRESH_TOKEN, CLOVER_OAUTH_CLIENT_SECRET

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(0.7.0)がレジストリに届いたのは5 か月前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。

代わりに使えるものは?

同じカテゴリには:Stripe MCP, flightclaw, Trade It, Marketplace Ad Pros: Amazon Ads & Seller Central, idealo MCP Server

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Stripe MCP

MCP server integrating with Stripe - tools for customers, products, payments, and more.

作者:stripe広く使われている★ 207213 か月前更新

クラウドで動く✓ 提供元 · stripe.com

flightclaw

Search ~300 airlines and book flights with a checkout link. OAuth sign-in by email code.

作者:flightclaw成長中★ 862 か月前更新

クラウドで動く✓ 提供元 · flightclaw.com

Trade It

Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.

作者:trade-it-inc初期★ 6234 日前更新

クラウドで動く✓ 提供元 · tradeit.app

idealo MCP Server

Search products, compare prices and discover deals across 6 European markets with your AI assistant.

作者:idealo初期★ 286 か月前更新

クラウドで動く✓ 提供元 · mcp.idealo.com
似たものと比べる
これ
Clover POS
Stripe MCPflightclawTrade ItMarketplace Ad Pros: Amazon Ads & Seller Centralidealo MCP Server
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえはいいいえいいえいいえいいえ
基本チェック3/34/44/45/54/44/4
ライセンスMITMITMITCC0-1.0MITMIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

clover-mcp

MCP server for the Clover POS REST API — gives AI assistants (Claude, Cursor, etc.) read and safe-write access to a Clover merchant's sales, inventory, orders, and customers.

Status: v0.7.0 released; working tree (unreleased) — 56 tools, 6 prompts, both auth modes, 399 tests. Runs locally (stdio, single merchant) or remotely over HTTP with OAuth, single- or multi-tenant (see docs/DEPLOY.md). Endpoint contracts are sandbox-verified in docs/endpoints.md.

⚠️ Independent project — not affiliated with, endorsed by, or sponsored by Clover Network, LLC or Fiserv, Inc. "Clover" is a trademark of its respective owner and is used here only nominatively to describe interoperability. Provided as is, without warranty — see Legal & disclaimer.

What it can do

  • Sales summaries, payment and refund reports
  • Inventory lookups and low-stock alerts
  • Order history and open-order inspection
  • Customer search and creation
  • Employee, shift, role, category, modifier, tax, tender, and device lookups; best-selling items
  • Pricing config lookups: discount catalogue, tip-suggestion presets, default service charge
  • Safe writes: update item prices, set stock quantities, create customers/items/categories/orders, add line items, update customers, rename items, apply order discounts, create modifier groups/modifiers/tags
  • AI tools (reason via your client's model — the server holds no LLM key): sales briefings, reorder suggestions, anomaly detection, category suggestions, customer-message drafts
  • Predefined prompt workflows: daily briefing, weekly sales report, inventory health check, end-of-day closeout, customer lookup, monthly tax summary

What it cannot do (by design): process refunds, capture payments, void charges, delete records. Those stay in the Clover dashboard.

Tools

ToolKindNotes
get_merchant_info / get_merchant_propertiesreadprofile + POS config (banking fields never returned)
get_sales_summaryreadaggregated window (see Sales summary semantics)
get_sales_by_employee / get_tips_by_employee / get_sales_by_hourreademployee attribution, tip-out, and merchant-local daypart reporting (PAYMENTS_R; employee names are best-effort)
list_payments / list_refunds / list_credits / list_tendersreadpayments, refunds, credits, tender types
list_orders / get_order / list_open_orders / list_order_typesreadorder history + detail
list_items / get_item / list_low_stock_itemsreadinventory + stock; get_item(include=[...]) opts in to modifier_groups/tax_rates/categories/tags association detail
list_categories / list_modifiers / list_taxes / list_item_groups / list_attributes / list_tags / list_discountsreadcatalog structure
list_tip_suggestions / get_default_service_chargereadtip presets + service-charge config
list_devices / list_opening_hours / list_cash_eventsreadterminals, hours, cash-drawer log
get_top_itemsreadbest-sellers by units in a window
list_employees / get_employee / list_shifts / list_active_shifts / list_rolesreadPINs never returned (EMPLOYEES_R)
search_customers / get_customerreadcards never returned
whoamireadmulti-tenant identity diagnostic (no secrets)
summarize_sales / inventory_reorder_suggestions / detect_sales_anomalies / suggest_item_categories / draft_customer_messageAIreason via your client's model; read-only suggestions
create_customer / update_customerwritedup-check + dry_run; update confirms via elicitation
create_item / create_category / create_order / add_line_itemwriteguarded: dry_run + confirm before writing
set_item_price_cents / set_item_stock_quantity / update_item_namewriteoptimistic-lock pre-check, bounds, dry_run
apply_order_discountwriteexactly one of percentage / amount_cents / catalogue_discount_id; negates positive amount_cents to Clover's required negative wire value; catalogue path resolves name+value client-side; dry_run preview includes a client-computed line-item subtotal
create_modifier_group / create_modifier / create_tagwritedup-guard (group/tag) or parent pre-check (modifier); guarded: dry_run + confirm before writing

Every tool carries MCP behaviour annotations (readOnlyHint / destructiveHint / idempotentHint) so clients can parallelize reads and prompt before writes.

Install

Published on PyPI — no clone needed:

uvx clover-mcp          # run directly (recommended)

or

pip install clover-mcp # then launch with: clover-mcp

From source (for development):

git clone https://github.com/SBolivarLoL/clover-mcp-server

cd clover-mcp-server uv pip install -e .

Configuration

Copy .env.example to .env and fill in your values:

cp .env.example .env

Required:

VariableDescription
CLOVER_MERCHANT_IDYour Clover merchant ID
CLOVER_ACCESS_TOKENYour Clover API access token

Optional:

VariableDefaultDescription
CLOVER_REGIONnana, eu, or la
CLOVER_SANDBOXfalsetrue to use the Clover sandbox
CLOVER_AUTH_MODEtokentoken or oauth_refresh
CLOVER_READ_ONLYfalseRefuse every write before making a Clover request
CLOVER_WRITE_LIMIT_COUNT10Maximum writes per safety window; 0 disables, negative values are rejected
CLOVER_WRITE_LIMIT_WINDOW_S300Positive write-safety window in seconds
Auth modes
  • `token` — paste a static access token. Works for sandbox and single-merchant production use. If the token expires, regenerate it in the Clover Developer Dashboard.
  • `oauth_refresh` — the server auto-refreshes on expiry and persists the new token pair to CLOVER_TOKEN_STORE (default: ~/.config/clover-mcp/tokens.json, mode 0600). Clover refresh tokens are single-use, so the rotated pair is written back after each refresh. Run scripts/get_sandbox_token.py to obtain tokens — it writes them straight to the store, so you only set CLOVER_AUTH_MODE, CLOVER_OAUTH_CLIENT_ID, CLOVER_OAUTH_CLIENT_SECRET, and CLOVER_MERCHANT_ID in .env (no token values needed). Pasting CLOVER_ACCESS_TOKEN / CLOVER_REFRESH_TOKEN into .env still works as an alternative.

Use a least-privilege token. Grant only the permission scopes the tools you actually use require (see the table below). A read-only deployment needs no *_W scopes at all. Don't reuse a production token in sandbox or vice versa.

Claude Desktop setup

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{

"mcpServers": { "clover": { "command": "uvx", "args": ["clover-mcp"], "env": { "CLOVER_MERCHANT_ID": "your_merchant_id", "CLOVER_ACCESS_TOKEN": "your_token", "CLOVER_REGION": "na" } } } }

Cursor setup

Add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json globally):

{

"mcpServers": { "clover": { "command": "uvx", "args": ["clover-mcp"], "env": { "CLOVER_MERCHANT_ID": "your_merchant_id", "CLOVER_ACCESS_TOKEN": "your_token" } } } }

Required Clover permissions

Your token must have the following Clover permission scopes:

PermissionUsed by
MERCHANT_Rget_merchant_info
ORDERS_Rlist_orders, get_order, list_open_orders
PAYMENTS_Rlist_payments, list_refunds, list_credits, get_sales_summary, get_sales_by_employee, get_tips_by_employee, get_sales_by_hour
ORDERS_R…also get_top_items
INVENTORY_Rlist_items, get_item, list_low_stock_items, list_categories, list_modifiers, list_taxes, list_discounts, list_item_groups, list_attributes, list_tags
INVENTORY_Wset_item_price_cents, set_item_stock_quantity, create_item, create_category, update_item_name, create_modifier_group, create_modifier, create_tag
ORDERS_Wcreate_order, add_line_item, apply_order_discount
CUSTOMERS_Rsearch_customers, get_customer
CUSTOMERS_Wcreate_customer, update_customer
EMPLOYEES_Rlist_employees, get_employee, list_shifts, list_active_shifts, list_roles (optional)
MERCHANT_R…also list_devices, list_tenders, list_order_types, list_opening_hours, list_cash_events, list_tip_suggestions, get_default_service_charge

Read scopes (*_R) are probed at startup; the server warns about any missing ones (it no longer exits — a hosted server must still start) and the affected tools return a 403 when called. EMPLOYEES_R is optional. Write scopes (*_W) are not probed (a probe would mutate data) — a missing write scope surfaces as a 403 the first time you call that tool. Permission changes on a Clover app require the merchant to reinstall the app.

Remote / hosted (v2)

By default this runs locally over stdio for a single merchant. To run it remotely:

  • FastMCP Cloud / Horizon (easiest): deploy with entrypoint server.py:mcp, enable the platform's built-in auth, and set single-merchant Clover env vars. The platform handles OAuth, HTTPS, and transport — no IdP setup, and do not set CLOVER_TRANSPORT/CLOVER_AUTH_* (that path needs an IdP and will fail).
  • Self-host: use server.py:create_server, which makes clover-mcp an OAuth 2.1 resource server (validates your IdP's JWTs, publishes Protected Resource Metadata per RFC 9728, routes by token claim) and refuses to start without an IdP so it can't run open.

Full setup for both in [docs/DEPLOY.md](docs/DEPLOY.md). How SSO/SAML, SCIM, audit, and multi-tenant authorization fit: [docs/enterprise-identity.md](docs/enterprise-identity.md).

Sales summary semantics

get_sales_summary makes the accounting explicit so the LLM can explain it:

  • Gross = sum of result=SUCCESS payment amounts. FAIL/AUTH/uncaptured PRE_AUTH are excluded.
  • Refunds come from the dedicated /refunds endpoint (Clover refunds are separate objects with a positive amount, not negative payments). Voids are counted from voided payments. Both are reported separately (refund_count/refund_amount, void_count) — never netted into payment_count. net_sales = gross_sales - refund_amount.
  • Tips and taxes are broken out as their own line items.
  • Service charges are *not* reported separately: Clover exposes them on the order only as a percentage (no computed amount), and what customers actually paid is already in gross_sales via payment totals.
  • Offline payments are included; a note flags the window when any are present.
  • Currency comes from the merchant record, never defaulted.
  • Windows longer than 90 days are split and concatenated transparently.

Development

uv pip install -e ".[dev]"

pytest ruff check src/ tests/ scripts/ ruff format --check src/ tests/ scripts/ mypy src/clover_mcp/

Correctness eval + latency/load benchmark against a sandbox: uv run python scripts/benchmark.py — methodology, results, and failure analysis in docs/eval.md.

Architecture (diagrams + module map): docs/ARCHITECTURE.md. Run a 5-minute demo: uv run python scripts/demo.py (or the

冒頭だけを表示しています。続きはリポジトリで読めます