AI アプリをドキュメント MCP サーバーに接続する

​

サーバーの詳細

​

AI アプリで利用できる機能

​

ツール

​

リソース

​

対象範囲

• はじめに、プラットフォームの概要、決済の概念、Clever Concepts
• Merchant Portal と Clever AI のガイド
• Shopify、WooCommerce、Magento、Xero などのプラットフォーム連携
• v1、v2、Payment Gateway 3、Card、Cashback の OpenAPI 仕様を含む API リファレンス全体
• セキュリティとコンプライアンスのページ

​

ドキュメントサイトから接続する

​

AI アプリを接続する

claude mcp add --transport http hello-clever https://docs.helloclever.co/mcp

{
  "mcpServers": {
    "hello-clever": {
      "url": "https://docs.helloclever.co/mcp"
    }
  }
}

{
  "servers": {
    "hello-clever": {
      "type": "http",
      "url": "https://docs.helloclever.co/mcp"
    }
  }
}

[mcp_servers.hello-clever]
url = "https://docs.helloclever.co/mcp"

npx add-mcp https://docs.helloclever.co/mcp

​

接続できたか確認する

• Hello Clever のドキュメント MCP を使って、PayTo 契約に必要なフィールドを教えてください。
• Hello Clever のドキュメントで、Payments Account と Treasury Account の違いを検索してください。
• Hello Clever のドキュメントから v2 の Payin エンドポイントを読み取り、curl リクエストを書いてください。

​

自作のコードから呼び出す

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"}
    }
  }'

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"}'

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"}
    }
  }'

​

レート制限

​

うまくいかないときは

​

セキュリティとプライバシー

• サーバーは読み取り専用です。私たちに情報を送信するツールは submit_feedback のみで、送信されるのはアシスタントが指定したページのパスとフィードバックの本文だけです。
• 提供されるのは公開済みのドキュメントです。アカウント固有の情報は含まれないため、接続してもお客様のデータが私たちに渡ることはありません。
• プロンプトはご利用の AI プロバイダー内にとどまります。ドキュメントサーバーに届くのは、アシスタントが発行した検索クエリとファイルコマンドだけです。
• .mcp.json や .vscode/mcp.json のような共有設定ファイルに追加してコミットしても安全です。機密情報は含まれません。

​

次のステップ

• 連携方法の選択: 開発を始める前に連携の方式を決める
• 連携キー: コードに必要な認証情報。MCP サーバーが扱うことはありません
• API の概要と認証: アシスタントが最も頻繁に読み取るリファレンスページ
• Clever AI のチュートリアル: Merchant Portal に組み込まれた AI。こちらは決済データを読み取ります