MCPサーバーの仕様(開発者向け)
中古ドメイン販売屋さんのAIアシスタント連携は、MCP(Model Context Protocol)のリモートサーバーとして提供しています。自作のMCPクライアントやエージェントからも、次の仕様で接続できます。
利用者向けの案内は「AIアシスタント(Claude / ChatGPT)との連携方法」をご覧ください。
接続の仕様
| 項目 | 内容 |
|---|---|
| 接続URL | https://www.topshelfequestrian.com/mcp |
| トランスポート | Streamable HTTP(ステートレス)。POST のみ・応答は JSON。SSE は使用しません(GET は 405) |
| プロトコル | JSON-RPC 2.0。MCP 仕様 2025-03-26 〜 2026-07-28 に対応 |
| 提供ツール | 8つ。読み取り5つ(ドメインの検索・詳細・カートの確認・ご注文の一覧・入荷予定と入荷履歴)と書き込み3つ(カートへの追加・削除・ご注文の確定) |
| レート制限 | ツールの呼び出しは1分あたり60回まで(利用者×接続アプリごと)。超えた場合はエラーを返します |
| エラー | 他のお客様のカート中・在庫の変化などの業務上の失敗は、JSON-RPC のエラーではなく isError: true の結果で、理由コードと日本語のメッセージを返します |
認証の仕様
| 項目 | 内容 |
|---|---|
| 認証方法 | OAuth 2.1(認可コード+PKCE(S256)必須)。認証はすべてのメソッドで必須です |
| クライアントの識別 | CIMD(Client ID Metadata Documents)と DCR(動的クライアント登録・RFC 7591)の両方に対応 |
| 認可サーバーのメタデータ | https://www.topshelfequestrian.com/.well-known/oauth-authorization-server |
| 保護リソースのメタデータ | https://www.topshelfequestrian.com/.well-known/oauth-protected-resource/mcp |
| スコープ | domains:read(検索・詳細・カートの確認・入荷予定)/orders:read(ご注文の一覧)/cart:write(カートへの追加・削除)/orders:write(ご注文の確定。利用者が許可画面で外せます)/offline_access(接続の維持=リフレッシュトークンの発行。grant_types に refresh_token を持つクライアントだけ) |
| APIキー方式 | 提供していません(認証は OAuth 2.1 のみ) |
ご注文とお支払い
- ご注文の確定(
place_order)には、カートの確認(get_cart)が返す確認用のトークンが必要です。トークンの有効期限は10分で、カートの内容が変わると使えなくなります。利用者にカートの内容と合計金額を示し、了承を得てから確定してください。 - お支払い(決済)はMCPの対象外です。ご注文の確定はお支払い待ちのご注文を作るまでで、お支払いはサイトのユーザーページで行います。
利用条件
この記事は役に立ちましたか?
ご回答ありがとうございました。
「AI連携」の他の記事
- AIアシスタントが表示する情報と、サイトのドメイン詳細ページの情報は同じですか?
- Claude から接続する手順を教えてください
- ChatGPT から接続する手順を教えてください
- AIアシスタントとの連携を解除するには?解除するとどうなりますか?
- どのAIツールから接続できますか?
- AIアシスタント連携(AI連携)とは何ですか?何ができますか?
- お支払いはAIアシスタントからできますか?
- AIアシスタント連携の利用に料金はかかりますか?
- AIアシスタント連携の利用にはアカウントが必要ですか?
- 接続先のURL(エンドポイント)はどこですか?
- どんな聞き方をすればドメインを探してもらえますか?
- AIアシスタントからご注文を確定できますか?勝手に注文されることはありませんか?
- 接続時の許可画面では何を許可することになりますか?
- AIアシスタントに支払い情報やパスワードは渡りますか?
- ご注文の一覧だけAIアシスタントから取得できません(権限エラーになります)
ヘルプを検索
解決しない場合は、右下の【ヘルプ】ボタンからAIにお気軽にお尋ねください。


