何ができるか {#overview}
CDNTの製品カタログを、AIチャットの中から直接検索できるようにした公開MCPサーバーです。
- 「シマノ ステラの最安値を調べて」→ AIが自分で検索ツールを呼び、候補と価格を返す
- JANコードを渡すと、該当商品のスペックとショップ別価格を取得
- 結果にはCDNTの商品ページURLが付くので、そのまま確認に移れる
MCPそのものの仕組みは MCP(Model Context Protocol)とは何か で解説しています。この記事は実際につないで使う手順に絞ったマニュアルです。
登録やAPIキーは不要です(読み取り専用)。
接続先とツール一覧 {#endpoint}
| 項目 | 値 |
|---|---|
| MCP URL | https://www.cd-nt.com/api/mcp |
| 通信方式 | Streamable HTTP(JSON応答) |
| 認証 | なし |
| サーバー名 | cdnt-product-search |
提供しているツールは2つです。
| ツール | 入力 | 使いどころ |
|---|---|---|
search_products |
query(JAN または キーワード)、limit(1〜30、既定10) |
候補を安い順に一覧で出す |
get_product |
id(検索結果の商品ID)または query |
1商品のスペックとショップ別価格 |
AIは通常「search_products で候補を出す → 気になる商品を get_product で詳しく見る」という順番で使います。こちらからツール名を指定する必要はありません。
AIごとの接続方法 {#setup}
どのAIでも、やることは「上のURLをMCPサーバーとして登録する」だけです。設定場所がアプリごとに違います。
Cursor {#setup-cursor}
プロジェクト直下の .cursor/mcp.json(全プロジェクトで使うなら ~/.cursor/mcp.json)に追記します。
{
"mcpServers": {
"cdnt-product-search": {
"url": "https://www.cd-nt.com/api/mcp"
}
}
}
保存後、Settings → MCP に cdnt-product-search が表示されます。プロジェクト単位の設定は初回に有効化(承認)が必要です。緑色になればエージェントのチャットから使えます。
Claude(Desktop / Code) {#setup-claude}
Claude Desktop は、設定の「コネクタ」からカスタムコネクタとしてURLを追加できます(プランにより利用可否が異なります)。
URL追加が使えない環境では、claude_desktop_config.json に mcp-remote 経由で登録します。
{
"mcpServers": {
"cdnt-product-search": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://www.cd-nt.com/api/mcp"]
}
}
}
mcp-remote はリモートMCPをローカルのstdioに中継する小さなツールです。Node.js が入っていれば追加インストールは不要です。
Claude Code はコマンド1行で登録できます。
claude mcp add --transport http cdnt-product-search https://www.cd-nt.com/api/mcp
ChatGPT {#setup-chatgpt}
ChatGPTでは、プラグイン開発者向けの接続・テスト画面でMCPサーバーURLを指定します。手順は公式の Connect and test your plugin を参照してください。
URLには https://www.cd-nt.com/api/mcp を入れます。認証は「なし」で接続できます。
一般ユーザーがディレクトリからインストールできる形(公開プラグイン)にするには、別途Skillsのパッケージ化と審査が必要です。考え方は GPTプラグインを作ると何ができるか にまとめています。
VS Code / Gemini CLI / その他 {#setup-others}
VS Code(Copilot Chat のエージェントモード) は .vscode/mcp.json に書きます。
{
"servers": {
"cdnt-product-search": {
"type": "http",
"url": "https://www.cd-nt.com/api/mcp"
}
}
}
Gemini CLI は ~/.gemini/settings.json に追記します。
{
"mcpServers": {
"cdnt-product-search": {
"httpUrl": "https://www.cd-nt.com/api/mcp"
}
}
}
それ以外のMCPクライアントでも、「リモートMCP / Streamable HTTP / URL指定」の項目があればそのままURLを入れれば動きます。URL指定がないクライアントは、Claude Desktopの例と同じく mcp-remote を使ってください。
チャットでの頼み方 {#prompts}
普通の日本語で頼めば、AIが必要なツールを選びます。「CDNTで」と添えると確実です。
- 「CDNTで シマノ ステラ を検索して、安い順に3つ教えて」
- 「JAN 4969363043825 の商品のスペックとショップ別の価格を見せて」
- 「ダイワのスピニングリールで2万円以下のものをCDNTで探して」
- 「この3商品の価格を比較して表にして」(検索結果のあとに続けて)
コツ
- キーワードは短く。「シマノ ステラ 1000」のようにブランド+シリーズ+番手程度が一番ヒットします
- スペース区切りの単語はすべて含む商品に絞られます(AND検索)
- 型番やJANが分かっているなら、それを渡すのが最も正確で高速です
返ってくるデータ {#response}
search_products の結果(抜粋):
{
"success": true,
"query": "シマノ ステラ",
"mode": "text",
"count": 3,
"items": [
{
"id": 3728,
"jan": "4969363043825",
"name": "ステラ 1000SSPG",
"brand": "シマノ",
"category": "スピニングリール",
"price_yen": 68000,
"store_count": 2,
"url": "https://www.cd-nt.com/items/3728"
}
]
}
| フィールド | 意味 |
|---|---|
mode |
jan(JAN完全一致)か text(キーワード検索)か |
price_yen |
取得時点で確認できた最安の店頭価格(税込・送料別の場合あり) |
store_count |
価格を確認できたショップ数 |
url |
CDNTの商品ページ |
get_product はこれに加えて、prices(ショップ名・価格・送料込みかどうか・商品URL、最大8件)と specs(カテゴリごとのスペック項目、最大20件)を返します。
curlで直接試す {#curl}
AIを通さずに動作確認したいときは、JSON-RPCを直接送れます。
# ツール一覧
curl -sS -X POST https://www.cd-nt.com/api/mcp \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# 検索
curl -sS -X POST https://www.cd-nt.com/api/mcp \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"シマノ ステラ","limit":3}}}'
ブラウザで https://www.cd-nt.com/api/mcp を開くと、サーバー情報とツール名の一覧が表示されます。
制限・キャッシュ・注意事項 {#limits}
- 読み取り専用です。購入・予約などの操作はできません
- 結果は最大6時間キャッシュされます。同じ検索語なら、6時間以内は同じ結果が返ります
- 価格はCDNTが最後に取得した時点のスナップショットです。リアルタイムの在庫・価格ではありません。購入前は必ずショップのページで確認してください
- ショップへのリンクにはアフィリエイトリンクが含まれる場合があります
- 公開サーバーのため、大量の機械的な連続呼び出しは控えてください。負荷状況により予告なく制限・停止することがあります
- 対象はCDNTに登録済みの製品(釣具・アウトドア・飲料・家電周辺など約10万件)です。すべての商品を網羅しているわけではありません
データの出典や利用条件は 公開APIの仕様と利用ルール もあわせて確認してください。
うまく動かないとき {#troubleshooting}
| 症状 | 対処 |
|---|---|
| ツールが一覧に出ない | アプリを再起動、またはMCP設定画面で再接続。Cursorのプロジェクト設定は有効化(承認)が必要 |
| URL指定で接続に失敗する | mcp-remote 経由の設定に切り替える(Claude Desktopの例を参照) |
| AIがツールを使わず推測で答える | 「CDNTのツールで検索して」と明示する |
| 検索結果が0件 | キーワードを短くする、ブランド名だけにする、JANで検索する |
| 価格が古い | キャッシュ(最大6時間)と取得時点の問題。商品ページとショップで最新を確認 |
不具合や追加してほしいツールの要望は お問い合わせ からお送りください。