> ## 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. # AI アプリをドキュメント MCP サーバーに接続する > Claude、Cursor、VS Code、Codex、または自作のエージェントを Hello Clever のドキュメント MCP サーバーに接続し、推測ではなく最新のドキュメントに基づいて回答してもらいましょう。 Hello Clever では、このドキュメントサイト用の Model Context Protocol（MCP）サーバーを公開しています。AI コーディングアシスタントに接続すると、回答を作成しながら公開済みのすべてのページを検索して読み取れます。API リファレンスと OpenAPI 仕様も含まれます。 接続すると何がうれしいのかというと、MCP サーバーがない場合、アシスタントは記憶だけを頼りに回答します。存在しないエンドポイントを作り出したり、古いバージョンのフィールド名を持ち出したり、Hello Clever を別の決済プロバイダーと取り違えたりすることがあります。接続しておけば、回答する前に最新のページを確認するため、あとから訂正する手間が減ります。 設定にかかる時間は 1、2 分ほどで、インストールするものもありません。サーバーは無料で、一般公開されており、読み取り専用です。API キーも不要です。 どのサーバーなのかを念のためお伝えすると、読み取るのは公開済みのドキュメントだけです。Hello Clever アカウントへの API ではないため、マーチャントのデータ、残高、取引を参照することはできません。自社の決済データについて知りたい場合は、Merchant Portal の [Clever AI](/ja/clever-ai/tutorials) をご利用ください。 ## サーバーの詳細 設定に必要な情報は次のとおりです。 | 項目 | 値 | | -------- | -------------------------------------------------------------- | | サーバー URL | `https://docs.helloclever.co/mcp` | | トランスポート | HTTP（ストリーミング対応） | | 認証 | なし。一般公開されています。 | | アクセス権限 | 読み取り専用 | | ディスカバリー | `https://docs.helloclever.co/.well-known/mcp` | | サーバーカード | `https://docs.helloclever.co/.well-known/mcp/server-card.json` | サーバーは `Hello Clever` という名前で自身を伝えます。URL は上記のとおりそのまま使用してください。別のホスト、ポート、インストールする `npx` パッケージはありません。 ## AI アプリで利用できる機能 ### ツール 3 つあり、どれを使うかはアシスタントが自分で選びます。 サイト全体を検索し、ページタイトルとリンクを添えて該当箇所を返します。「認証はどうすればよいか」といった概念的で範囲の広い質問に向いています。 `search_hello_clever` `ls`、`tree`、`rg`、`cat`、`head`、`jq` を使い、ドキュメントを読み取り専用の仮想ファイルシステムとして読み取ります。キーワードの完全一致、構造の把握、ページ全文の取得に便利です。 `query_docs_filesystem_hello_clever` ドキュメントの問題を私たちのドキュメントチームに届けます。内容の誤り、情報の古さ、記載漏れ、動作しないサンプルなどが対象です。 `submit_feedback` 通常はまず検索し、次に関連性の高いページを全文で読み取ります。 2 つ目のツールは名前が少し物騒に見えるので念のためお伝えすると、`query_docs_filesystem_hello_clever` がお使いの端末に触れることは一切ありません。Hello Clever 側のメモリ上に展開された公開ドキュメントのコピーに対して実行されるだけで、ネットワークアクセス、書き込み権限、ローカルファイルへの参照権限はいずれもありません。 ### リソース `helloclever` というスキルファイルも、MCP リソースとして利用できます。ツールがコンテンツへのアクセスを提供するのに対し、スキルはそのコンテンツの使い方をアシスタントに伝えます。ペイインとペイアウトに適用されるフロー、Webhook の設定方法、サンドボックスでのテスト方法などです。MCP リソースに対応したクライアントなら接続時に自動で読み込まれるため、追加でインストールするものはありません。 ### 対象範囲 サイトが提供するすべての言語について、公開ナビゲーションに含まれるすべての内容が対象です。 * はじめに、プラットフォームの概要、決済の概念、Clever Concepts * Merchant Portal と Clever AI のガイド * Shopify、WooCommerce、Magento、Xero などのプラットフォーム連携 * v1、v2、Payment Gateway 3、Card、Cashback の OpenAPI 仕様を含む API リファレンス全体 * セキュリティとコンプライアンスのページ ## ドキュメントサイトから接続する 設定ファイルを触りたくない場合は、こちらから始めてください。 このサイトの任意のページで、右上にある **Copy page** ボタンの横の矢印を選択します。 **Copy MCP Server** を選ぶと `https://docs.helloclever.co/mcp` がクリップボードにコピーされ、そのままクライアントに貼り付けられます。**Connect to Cursor** を選ぶと、Cursor にワンクリックでインストールされます。 このメニューは、MCP サーバーを使わない場面でも便利です。**Open in ChatGPT** と **Open in Claude** はいま読んでいるページについて会話を始められます。**Copy page** と **View as Markdown** では、そのページをプレーンな Markdown として取得し、好きな場所に貼り付けられます。 ## AI アプリを接続する お使いのツールを選んでください。 ターミナルでコマンドを 1 つ実行するだけです。 ```bash theme={null} claude mcp add --transport http hello-clever https://docs.helloclever.co/mcp ``` `--scope project` を付けるとリポジトリの `.mcp.json` に登録され、チームで共有できます。`--scope user` を付けると、その端末のすべてのプロジェクトで使えるようになります。 確認するには、Claude Code 内で `/mcp` を実行してください。サーバーが接続済みとして表示されます。 Claude の設定にある [Connectors](https://claude.ai/settings/connectors) ページを開きます。 **Add custom connector** を選択し、次の内容を入力します。 * 名前: `Hello Clever Docs` * URL: `https://docs.helloclever.co/mcp` **Add** を選択します。 会話画面で添付ボタン（プラスアイコン）を選択し、**Hello Clever Docs** を選択します。 いちばん手軽なのは、このページ右上の **Copy page** ボタンの横のメニューから **Connect to Cursor** を使う方法です。自分で設定したい場合は次のとおりです。 Cmd + Shift + P（Windows では Ctrl + Shift + P）を押し、`Open MCP settings` を検索して **Add custom MCP** を選択します。`mcp.json` が開きます。 ```json mcp.json theme={null} { "mcpServers": { "hello-clever": { "url": "https://docs.helloclever.co/mcp" } } } ``` プロジェクトに `.vscode/mcp.json` を作成します。 ```json .vscode/mcp.json theme={null} { "servers": { "hello-clever": { "type": "http", "url": "https://docs.helloclever.co/mcp" } } } ``` このファイルをコミットすれば、リポジトリで作業する全員が同じサーバーを使えます。 `~/.codex/config.toml` にサーバーを追加します。 ```toml ~/.codex/config.toml theme={null} [mcp_servers.hello-clever] url = "https://docs.helloclever.co/mcp" ``` 多くのエージェントでは `add-mcp` ヘルパーに URL を渡すだけで、選んだクライアント向けの設定を自動で書き込めます。 ```bash theme={null} npx add-mcp https://docs.helloclever.co/mcp ``` お使いのクライアントが見当たらない場合は、リモート MCP サーバーの設定箇所に手動で追加してください。必要なのは HTTP トランスポートと URL `https://docs.helloclever.co/mcp` だけです。ヘッダーや認証情報は不要です。 ## 接続できたか確認する ドキュメントには正確に書かれていて、一般的な Web 検索では答えにくい内容を質問してみてください。次のような質問が確認に向いています。 * *Hello Clever のドキュメント MCP を使って、PayTo 契約に必要なフィールドを教えてください。* * *Hello Clever のドキュメントで、Payments Account と Treasury Account の違いを検索してください。* * *Hello Clever のドキュメントから v2 の Payin エンドポイントを読み取り、curl リクエストを書いてください。* 回答に `docs.helloclever.co` へのページリンクが含まれていれば、接続できています。出典のない漠然とした回答が返る場合は、まだ記憶だけで答えています。クライアント側でサーバーが接続済みと表示されているか確認して、もう一度試してください。 ## 自作のコードから呼び出す 独自の連携を開発する場合も、MCP クライアントのライブラリであれば、どれでもこのサーバーと通信できます。まずターミナルから試すには、JSON-RPC の `initialize` を送信します。 ```bash Initialize theme={null} curl -X POST https://docs.helloclever.co/mcp \ -H 'Content-Type: application/json' \ -H 'Accept: application/json, text/event-stream' \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "initialize", "params": { "protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": {"name": "my-integration", "version": "1.0.0"} } }' ``` ```bash ツール一覧 theme={null} curl -X POST https://docs.helloclever.co/mcp \ -H 'Content-Type: application/json' \ -H 'Accept: application/json, text/event-stream' \ -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/list"}' ``` ```bash 検索を実行 theme={null} curl -X POST https://docs.helloclever.co/mcp \ -H 'Content-Type: application/json' \ -H 'Accept: application/json, text/event-stream' \ -d '{ "jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": { "name": "search_hello_clever", "arguments": {"query": "PayTo agreement"} } }' ``` 覚えておきたい点が 2 つあります。レスポンスは Server-Sent Events で返るため、`Accept` ヘッダーには `text/event-stream` を含めたままにしてください。もう 1 つは、検索ツールに任意の `language` パラメータがあることです。たとえば `"language": "ja"` を指定すると、日本語ページから結果を取得できます。既定値は `en` です。 ## レート制限 サーバーを誰もが使えるように、次の制限を設けています。通常の対話的な利用でこの上限に達することはありません。 | 対象 | 上限 | | -------------------------- | -------------------- | | ユーザー単位（IP アドレス） | 1 時間あたり 5,000 リクエスト | | 検索（サイト単位） | 1 時間あたり 10,000 リクエスト | | ドキュメントファイルシステムへのクエリ（サイト単位） | 1 時間あたり 10,000 リクエスト | 上限を超えた場合、サーバーは `429 Too Many Requests` を返します。制限は 1 時間のローリングウィンドウでリセットされるので、間隔を空けて再試行すればすぐに復旧します。 ## うまくいかないときは まず URL が `https://docs.helloclever.co/mcp` と完全に一致しているか確認してください。末尾のスラッシュや、その後ろに続く文字列は不要です。次に、クライアントのトランスポートが stdio や SSE ではなく HTTP になっているか確認してください。なお、ブラウザでこの URL を開いて `405` が返るのは問題ありません。このエンドポイントは `POST` にのみ応答するためです。 本来は不要です。サーバーは一般公開されており、認証情報を受け取りません。クライアントがトークンを求める場合は、その項目を空欄にするか、認証なしの選択肢を選んでください。 質問がツールを明確に必要としている場合にのみ MCP ツールを使うクライアントもあります。「Hello Clever のドキュメントを検索して...」のように、プロンプトで参照元を伝えてみてください。Claude の Web 版とデスクトップ版では、その会話で添付ボタンからコネクターが選択されているかもあわせて確認してください。 このサーバーが索引付けしているのは、このサイトだけです。`legacy-docs.helloclever.co` の内容は索引の対象外なので、そこを引用する回答は私たちのサーバーではなく、モデルの学習データか Web 検索に由来しています。 ぜひお知らせください。ページのパスと問題の説明を添えて `submit_feedback` ツールを使うようアシスタントに伝えていただければ、私たちのドキュメントチームに直接届きます。 ## セキュリティとプライバシー このサーバーへの接続によるリスクはごくわずかです。詳細は次のとおりです。 * サーバーは読み取り専用です。私たちに情報を送信するツールは `submit_feedback` のみで、送信されるのはアシスタントが指定したページのパスとフィードバックの本文だけです。 * 提供されるのは公開済みのドキュメントです。アカウント固有の情報は含まれないため、接続してもお客様のデータが私たちに渡ることはありません。 * プロンプトはご利用の AI プロバイダー内にとどまります。ドキュメントサーバーに届くのは、アシスタントが発行した検索クエリとファイルコマンドだけです。 * `.mcp.json` や `.vscode/mcp.json` のような共有設定ファイルに追加してコミットしても安全です。機密情報は含まれません。 データの取り扱い全般については、[データの取り扱いについて](/ja/platform-overview/compliance/how-handle-data)と [API セキュリティ](/ja/security/api-security)を参照してください。 ## 次のステップ * [連携方法の選択](/ja/integrations/choosing-integration): 開発を始める前に連携の方式を決める * [連携キー](/ja/integration-keys): コードに必要な認証情報。MCP サーバーが扱うことはありません * [API の概要](/ja/api/overview)と[認証](/ja/api/authentication): アシスタントが最も頻繁に読み取るリファレンスページ * [Clever AI のチュートリアル](/ja/clever-ai/tutorials): Merchant Portal に組み込まれた AI。こちらは決済データを読み取ります ## Related topics - [Hello Clever 開発者ドキュメント](/ja/index.md) - [Payment Gateway のセキュリティ](/ja/security/payment-gateway-security.md) - [適切な Hello Clever の連携方法を選ぶ](/ja/integrations/choosing-integration.md)