> ## Documentation Index
> Fetch the complete documentation index at: https://docs.helloclever.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Hello Clever MCP

> Hello Clever の加盟店アカウントを Claude または ChatGPT に接続します。残高、手数料、取引、キャンペーンの成果を普段の言葉で確認でき、Merchant Portal を開かずに決済リンク、決済リクエスト、キャンペーンを作成できます。

Hello Clever MCP サーバーは、Hello Clever の加盟店アカウントを Claude または ChatGPT に接続します。接続すると、決済について Claude/ChatGPT に普段の言葉で質問でき、推測ではなくアカウントの最新データに基づいて回答が得られます。決済リンクの作成やキャンペーンの設定など、操作を Claude/ChatGPT に任せることもできます。

## 概要

Hello Clever MCP は Model Context Protocol（MCP）サーバーです。Claude/ChatGPT に、自社の Hello Clever 加盟店アカウントへのセルフサービスのアクセスを提供します。どちらのプラットフォームでも同じように動作します。

**対象：** Hello Clever の加盟店と、[Merchant Portal](/ja/portal/overview) を利用する財務、オペレーション、マーケティング、サポートの担当者。

**できること：**

<CardGroup cols={3}>
  <Card title="資金を確認する" icon="wallet" href="#money-movement-and-account-management">
    残高、決済手数料、精算、Payout を確認できます。
  </Card>

  <Card title="取引を調べる" icon="magnifying-glass" href="#transactions-and-reporting">
    決済を検索し、失敗した理由を確認し、上位の顧客やリピート顧客を把握できます。
  </Card>

  <Card title="データをエクスポートする" icon="envelope" href="#transactions-and-reporting">
    先月の取引などのレポートをメールで受け取れます。
  </Card>

  <Card title="キャンペーンを運用する" icon="gift" href="#campaigns">
    キャッシュバックキャンペーンとスタンプキャンペーンを作成、管理し、成果を確認できます。
  </Card>

  <Card title="支払いを受け取る" icon="link" href="#customer-facing-checkout">
    決済リンクを作成し、顧客に決済リクエストを送れます。
  </Card>

  <Card title="Top up の口座情報" icon="building-columns" href="#money-movement-and-account-management">
    Hello Clever の外部からアカウントに Top up するための銀行情報を確認できます。
  </Card>
</CardGroup>

質問は Claude/ChatGPT で行います。どの Hello Clever ツールを呼び出すかは Claude/ChatGPT が判断し、アカウントに対して実行して結果を説明します。インストールするものも、管理する API キーもありません。

すべてのリクエストは自社の加盟店アカウントに限定されます。サーバーが他の加盟店のデータを読み取ったり変更したりすることはできません。

<Note>
  このサーバーは [ドキュメント MCP サーバー](/ja/developer-reference/docs-mcp-server) とは別のものです。ドキュメント MCP サーバーは公開ドキュメントを読み取るだけで、アカウントのデータを参照することはありません。このページのサーバーは **自社の** アカウントデータを扱うため、サインインが必要です。
</Note>

## 機能

<a id="money-movement-and-account-management" />

### 資金の移動とアカウント管理

| 機能 | 内容 |
| - | - |
| **残高** | 各アカウントの現在の残高を通貨ごとに確認できます。Payout の予約や資金の移動の前に確認しておくと便利です。 |
| **決済手数料** | アカウントに設定されている手数料を決済手段ごとに確認できます。商品の価格設定や請求書の確認に役立ちます。 |
| **精算と Payout の履歴** | 過去の精算と Payout の金額、日付、ステータスを確認できます。資金がいつアカウントから出て、届いたかどうかがわかります。 |
| **Top up の口座情報** | Hello Clever の外部からアカウントに [Top up](/ja/portal/balances#top-up) するときの送金先の銀行情報を確認できます。 |

<a id="transactions-and-reporting" />

### 取引とレポート

| 機能 | 内容 |
| - | - |
| **取引の検索** | 参照番号、顧客、金額、日付で決済を検索し、ステータスを確認できます。失敗した決済はその理由もわかるため、顧客からの問い合わせにすぐ回答できます。 |
| **失敗した決済の内訳** | 任意の期間の失敗した決済を、理由と決済手段ごとに集計します。何がどのくらいの頻度で起きているかを把握できます。 |
| **上位の顧客とリピート顧客** | 購入額の多い顧客と、そのうち再購入している顧客の数を確認できます。誰に特典を提供するかの判断に役立ちます。 |
| **メールでのエクスポート** | 先月の取引などのレポートを依頼すると、Portal からエクスポートしなくてもファイルがメールで届きます。 |

<a id="campaigns" />

### キャンペーン

| 機能 | 内容 |
| - | - |
| **キャッシュバックキャンペーン** | 特典、対象となる支払額、期間を伝えるだけでキャッシュバックキャンペーンを作成できます。仕組みは [キャッシュバックキャンペーン](/ja/portal/cashback-campaigns) を参照してください。 |
| **スタンプキャンペーン** | 一定回数の購入で顧客が特典を受け取れるスタンプ（ロイヤルティ）キャンペーンを作成、管理できます。 |
| **キャンペーンの成果** | 参加数、特典の利用数、キャンペーンによる売上など、キャンペーンの成果を確認できます。 |

<a id="customer-facing-checkout" />

### 顧客向けチェックアウト

| 機能 | 内容 |
| - | - |
| **決済リンク** | SNS、請求書、メッセージなど、どこでも共有できる再利用可能なチェックアウトリンクを作成できます。 |
| **決済リクエスト** | 特定の顧客向けに 1 回限りの決済リクエストを作成し、送信できます。 |

<a id="actions-that-change-your-account" />

### アカウントを変更する操作

Hello Clever MCP の操作の大半はデータの読み取りです。次の機能は、何かを作成または変更します。

| 操作 | 実行される内容 |
| - | - |
| 決済リンクの作成 | 有効なチェックアウトリンクがアカウントに新しく作成されます。 |
| 決済リクエストの作成 | 決済リクエストが作成され、指定した顧客に送信されます。 |
| キャッシュバックキャンペーンの作成 | 新しいキャッシュバックキャンペーンがアカウントに作成されます。 |
| スタンプキャンペーンの作成と管理 | スタンプキャンペーンがアカウントに作成または更新されます。 |
| メールでのデータのエクスポート | ファイルが作成され、メールで送信されます。 |

これらの操作を実行する前に、Claude/ChatGPT が詳細を表示し、承認を求めます。承認する前に、特に金額、通貨、顧客を確認してください。Hello Clever では、この承認の手順を有効にしたままにすることをおすすめします。

Hello Clever MCP では、精算のリクエスト、Payout の送信、返金、アカウント設定やユーザーの変更はできません。資金を精算するには [Merchant Portal](/ja/portal/balances#settlement) を使用してください。

## 設定

有効な Hello Clever 加盟店アカウントと、Claude または ChatGPT のアカウントが必要です。手順はどちらのプラットフォームでも同じです。

<Steps>
  <Step title="コネクターのディレクトリを開く">
    Claude の場合は [claude.com/connectors](https://claude.com/connectors)、ChatGPT の場合は [chatgpt.com/plugins](https://chatgpt.com/plugins) を開きます。
  </Step>

  <Step title="Hello Clever を探す">
    **Hello Clever** を検索して選択し、**Connect** をクリックします。
  </Step>

  <Step title="Hello Clever でサインインする">
    Hello Clever のサインイン画面が開きます。Merchant Portal で使用しているメールアドレスとパスワードでサインインし、二要素認証を設定している場合は認証を完了します。
  </Step>

  <Step title="アクセスを承認する">
    Claude/ChatGPT が求めるアクセス権限を確認して承認します。Claude/ChatGPT に戻ると、**Hello Clever** が接続済みと表示されます。
  </Step>

  <Step title="最初の質問をする">
    新しい会話を始めて、「すべての決済アカウントの現在の残高を教えて」のように質問します。Claude/ChatGPT が Hello Clever を使わない場合は、その会話で **Hello Clever** が有効になっているか確認してください。[トラブルシューティング](#troubleshooting)も参照してください。
  </Step>
</Steps>

<a id="disconnect" />

### 接続を解除する

Claude でアクセスを取り消すには、**Settings**、**Connectors** の順に開き、**Hello Clever** を選択して **Disconnect** をクリックします。ChatGPT では [chatgpt.com/plugins](https://chatgpt.com/plugins) を開き、**Hello Clever** を選択して接続を解除します。もう一度接続するまで、Claude/ChatGPT はアカウントにアクセスできなくなります。

## 認証

* **必要なアカウント：** 有効な Hello Clever 加盟店アカウント。まだお持ちでない場合は、[加盟店アカウントの作成](/ja/create-merchant-account)を参照してください。
* **サインイン方法：** 既存の Hello Clever のログインを使う OAuth 2.0。Claude/ChatGPT にパスワードを渡すことはありません。Hello Clever のページでサインインすると、Claude/ChatGPT はアクセストークンを受け取ります。
* **Claude/ChatGPT がアクセスできる範囲：** サインインした加盟店アカウントのみ。サーバーが処理するすべてのリクエストはその加盟店に限定され、他の加盟店のデータを読み取ったり変更したりすることはできません。
* **アクセスの取り消し：** [接続を解除する](#disconnect)の手順で、Claude/ChatGPT から Hello Clever の接続を解除します。

## 使用例

各例では、入力するプロンプト、サーバーが行う処理、返ってくる回答の例を示します。例は Claude と ChatGPT のどちらでも同じように使えます。

<Note>
  これらの例に含まれる金額、料率、参照番号、名前は説明用の架空のものです。実際の回答には自社のアカウントデータが使われます。
</Note>

### 例 1：売上と手数料を確認する

**プロンプト**

```text theme={null}
過去 30 日間の AUD の売上と、適用されている決済手数料を教えて。
```

**実行される処理**

Claude/ChatGPT が過去 30 日間に成功した AUD の取引を検索して合計します。あわせて、アカウントに設定されている決済手数料を読み取ります。

**回答の例**

期間中の売上合計と取引件数、決済手段ごとの手数料率です。たとえば次のようになります。

> 過去 30 日間（2026 年 9 月 8 日から 10 月 7 日まで）に、AUD アカウントで **1,284 件の取引が成功** し、売上の合計は **A\$248,930.50** でした。
>
> 設定されている決済手数料は次のとおりです。
>
> | 決済手段 | 手数料 |
> | - | - |
> | PayID | 0.9% |
> | カード | 1.6% + A\$0.15 |

「前の 30 日間と比較して」や「USD アカウントについても同じように見せて」のように、続けて質問することもできます。

### 例 2：取引を調べる

**プロンプト**

```text theme={null}
参照番号 ABC123 の決済はどうなった？完了している？
```

**実行される処理**

Claude/ChatGPT が参照番号 `ABC123` で取引を検索します。サーバーは一致する記録を返します。

**回答の例**

決済のステータス、金額、日付と、成功しなかった場合はその理由です。たとえば次のようになります。

> 参照番号 **ABC123** の決済は完了していません。**2026 年 10 月 3 日午後 2 時 41 分** に作成された **A\$149.00** の Payin で、ステータスは **Failed** です。理由は、顧客が手続きを完了する前に決済の有効期限が切れたためです。アカウントへの入金はありません。

個別の決済ではなく傾向を知りたい場合は、「今週、決済が失敗しているのはなぜ？」と質問すると、理由ごとの内訳が得られます。

### 例 3：アカウントの残高を確認する

**プロンプト**

```text theme={null}
すべての決済アカウントの現在の残高を教えて。
```

**実行される処理**

Claude/ChatGPT がサーバーに各アカウントの最新の残高を問い合わせます。サーバーはアカウントと通貨ごとに 1 つの残高を返します。

**回答の例**

各アカウントの残高と通貨です。たとえば次のようになります。

> 現在の残高は次のとおりです。
>
> | アカウント | 通貨 | 残高 |
> | - | - | - |
> | Payments Account | AUD | A\$52,410.18 |
> | Payments Account | USD | US\$8,920.00 |
> | Payments Account | JPY | ¥1,204,500 |

アカウントの仕組みについては、[Payments Accounts](/ja/platform-overview/clever-concepts/payments-accounts) を参照してください。

### 例 4：決済リンクを作成する

**プロンプト**

```text theme={null}
「ギフトボックス」の商品用に A$89 の決済リンクを作成して。
```

**実行される処理**

Claude/ChatGPT が「ギフトボックス」という説明を付けた A\$89.00 の決済リンクを準備し、承認を求めます。承認すると、サーバーが AUD アカウントにリンクを作成して返します。

**回答の例**

すぐに共有できる新しいリンクです。たとえば次のようになります。

> AUD の Payments Account に入金される **A\$89.00**（「ギフトボックス」）の決済リンクを作成しました。
>
> `https://paylink.cleverhub.co/abc123xyz`
>
> このリンクは再利用できるため、何人の顧客にでも共有できます。

特定の顧客に請求する場合は、「山田花子さんに 10 月分の請求書として A\$240 の決済リクエストを送って」のように依頼します。

### その他のプロンプトの例

* 「今四半期に購入額が最も多かった顧客は誰？そのうちリピート顧客は何人？」
* 「先月のキャッシュバックキャンペーンの成果はどうだった？」
* 「スタンプキャンペーンを設定して。コーヒーを 9 杯買うと 10 杯目が無料、来週の月曜日から開始。」
* 「最後の精算はいつ？もう着金している？」
* 「AUD アカウントに Top up するときの銀行情報を教えて。」
* 「9 月のすべての取引を CSV でメールして。」

## プライバシーポリシー

Hello Clever MCP の利用には、[Hello Clever のプライバシーポリシー](https://helloclever.co/policy)が適用されます。弊社が収集する個人情報、その利用方法と保管方法、問い合わせ先が記載されています。

Hello Clever MCP を利用する場合：

* サーバーは自社の加盟店アカウントのみを扱います。既存の権限を超えるアクセスを付与することはありません。
* 質問に回答するためにサーバーが返すデータ（取引金額、参照番号、顧客名、残高など）は Claude/ChatGPT に送信されます。会話の取り扱いには各プラットフォームのプライバシーポリシーが適用されます。Claude は [Anthropic のプライバシーポリシー](https://www.anthropic.com/legal/privacy)、ChatGPT は [OpenAI のプライバシーポリシー](https://openai.com/policies/privacy-policy/)です。
* Hello Clever が Claude/ChatGPT との会話の内容を受け取ることはありません。弊社が受け取るのは、回答や操作の実行にサーバーが必要とするリクエストのみです。
* 承認した操作（決済リンク、決済リクエスト、キャンペーンなど）は、Merchant Portal で作成した場合と同じようにアカウントに記録されます。

データの保護について詳しくは、[データの取り扱い](/ja/platform-overview/compliance/how-handle-data)を参照してください。

## サポート

* **ヘルプセンター：** [加盟店向けナレッジベース](https://support.helloclever.co/merchant-knowledge-base)
* **お問い合わせ：** [helloclever.co/get-in-touch](https://helloclever.co/get-in-touch)

### 問題を報告する

Hello Clever MCP が想定どおりに動作しない場合は、[お問い合わせページ](https://helloclever.co/get-in-touch)から次の情報を添えてご連絡ください。

* 使用したプロンプトと、送信したおおよその日時
* 期待していた結果と、実際の結果
* 加盟店名または加盟店 ID（パスワードは絶対に含めないでください）
* 使用したプラットフォーム（Claude または ChatGPT）と、表示されたエラーメッセージ

意図せずに決済リンク、決済リクエスト、キャンペーンを作成してしまった場合は、すぐにご連絡ください。

回答の内容に誤りがあると思われる場合は、[Merchant Portal](/ja/portal/overview) で確認してください。アカウントの情報は常に Merchant Portal が正となります。

<a id="troubleshooting" />

## トラブルシューティング

<AccordionGroup>
  <Accordion title="Claude/ChatGPT が Hello Clever を使わない">
    **Hello Clever** が接続済みと表示されているか確認してください。Claude では **Settings**、**Connectors** で確認し、その会話のツールメニューで有効にします。ChatGPT では [chatgpt.com/plugins](https://chatgpt.com/plugins) で確認し、メッセージ欄の **+** をクリックして **Hello Clever** を選択します。「Hello Clever を使って、AUD の残高を教えて」のように、プロンプトで参照元を伝えるのも効果的です。
  </Accordion>

  <Accordion title="エクスポートのメールが届かない">
    大きなエクスポートには数分かかることがあります。迷惑メールフォルダを確認してから、Claude/ChatGPT にもう一度エクスポートを依頼してください。
  </Accordion>

  <Accordion title="Claude/ChatGPT がアカウントや取引を見つけられない">
    Hello Clever MCP は、サインインした加盟店アカウントのみを扱います。同じユーザーで [Merchant Portal](/ja/portal/overview) にサインインし、そのアカウントや取引が表示されるか確認してください。
  </Accordion>

  <Accordion title="サインイン画面が閉じる、またはエラーが表示される">
    claude.ai または chatgpt.com のポップアップを許可してから、もう一度接続してください。最近 Merchant Portal のパスワードを再設定した場合は、先に一度 Portal にサインインしてください。
  </Accordion>

  <Accordion title="接続していた Hello Clever が使えなくなった">
    アクセスの有効期限が切れたか、取り消された可能性があります。Claude/ChatGPT で **Hello Clever** の接続を解除してから、もう一度接続してください。
  </Accordion>
</AccordionGroup>

<Warning>
  AI が生成した回答には誤りが含まれる場合があります。会計、照合、顧客への返金のために数値を使う前に、[Merchant Portal](/ja/portal/overview) で確認してください。操作を承認する前には、必ず詳細を確認してください。
</Warning>


## Related topics

- [AI アプリをドキュメント MCP サーバーに接続する](/ja/developer-reference/docs-mcp-server.md)
- [Hello Clever とは](/ja/getting-started/introduction.md)
- [Hello Clever API の概要](/ja/api/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.