AIエージェントのためのMCPサーバー

Seldons は mcp.seldons.ai で Model Context Protocol サーバーを運用しています。 このサイトが人に提供している越境取引ツール — HSコード推定、着地原価と推奨小売価格、認証確認、 商品ページ分析 — を、AIエージェントが呼び出せるツールとして公開しています。

キーなしで最初の計算を試す

アカウントや支払いなしで、以下のリクエストをターミナルで実行できます。原価10米ドル、重量0.5kgの化粧品を米国で販売する例です。

curl https://mcp.seldons.ai/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "calculate_export_price",
    "arguments": {
      "factory_cost": 10,
      "factory_currency": "USD",
      "weight_kg": 0.5,
      "destination_market": "us",
      "category": "cosmetics",
      "dimensions_cm": {
        "length": 10,
        "width": 10,
        "height": 10
      }
    }
  }
}'

recommended_retailは推奨小売価格、breakdown_usdは費用内訳です。assumptionsとwarningsも確認してください。運賃や税率は計画用の前提であり、実際の見積もりや税関の判断ではありません。

商品URLから海外発売の確認リストを作るには

次の商品群を海外で発売する準備ですか。商品URLごとにanalyze_product_pageを呼び出し、ページの根拠・修正案・優先度を確認表へ記録するようエージェントを接続できます。有料MCPは繰り返す業務向けの構造化データを返します。同じ分析はWebツールで無料で利用できます。

ローカル例：原産国の英語表記を補う

架空の美容液ページには「제조국: 대한민국」と韓国語で記載されています。以下は既存のテスト応答を実際のパーサーとMCPアダプターで再生した抜粋です。出力の使い方を示す例であり、新しいAI分析、実際の顧客事例、売上改善の実績ではありません。

入力：ツール名と引数

tools/callリクエストのparams部分です。example.comのURLはテスト用なので、実際のリクエストには使わないでください。実行時は自分の商品の公開URLと発行されたキーを使います。この例では英語の結果を指定しています。

{
  "name": "analyze_product_page",
  "arguments": {
    "product_url": "https://shop.example.com/products/serum-30ml",
    "language": "en"
  }
}

出力：確認表に使える部分

エージェントは「原産国の英語表記がない」、ページの根拠、「英語で原産国を一行追加」と中程度の優先度を確認表に記録できます。担当者が原文を確認し、修正を判断します。表への保存や定期実行はエージェント側で接続する処理です。MCPサーバーが商品ページを直接変更することはありません。

{
  "result": {
    "gaps": [
      {
        "point": "No country-of-origin in English",
        "evidence": "제조국 appears only in Korean",
        "fix": "Add an English origin line",
        "impact": "medium"
      }
    ]
  },
  "read": {
    "html_only": true,
    "paginated_reviews": false
  },
  "redirected": false
}

判断の前に読み取り範囲を確認

html_onlyはJavaScript実行後にだけ現れる内容を読めなかったことを示します。ページ送りが必要なレビューも読んでいません。redirectedがtrueならrequested_urlとurlを比較してください。ページに記載がないことだけで、認証の未取得や販売の適法性は判断できません。

次のSKUにも同じ列を使えば、問題と根拠・修正案をまとめて確認できます。成功した分析は以下の課金規則に従って8クレジットを使います。この例に時間短縮や購入率向上の実測値はありません。自分の商品一件を評価用キーで確認してから、繰り返す業務につなげてください。

自分の商品をWebで試す · 評価用キーを依頼

どう接続しますか？

https://mcp.seldons.ai/mcp · Streamable HTTP.

キーなしでも全ツールの一覧を確認できます。check_business_numberとcalculate_export_priceは無料で実行でき、有料ツールにはキーとクレジットが必要です。

Claude Code:

claude mcp add --transport http seldons https://mcp.seldons.ai/mcp \
  --header "Authorization: Bearer sk_live_YOUR_KEY"

mcpServers ブロックを読むクライアントであれば同じ形式です — Claude Code の .mcp.json、Claude Desktop の設定ファイル、Cursor の mcp.json:

{
  "mcpServers": {
    "seldons": {
      "type": "http",
      "url": "https://mcp.seldons.ai/mcp",
      "headers": { "Authorization": "Bearer sk_live_YOUR_KEY" }
    }
  }
}

キーなしで接続するなら headers ブロックを外してください。

どんなツールがありますか？

完全なスキーマは tools/list で取得できます。各説明は、そのツールが何をするか とどこから信用してはいけないかを併記します。読む価値があるのは後半です。

課金はどうなりますか？

クレジットは前払いで、ツールが実行された後に差し引きます。先に引くことは ありません。ツールごとに決まったクレジット数があり（上の表）、有料の応答には _meta.credits_remaining が含まれるので、エージェントが自分の残高を把握して お伝えできます。評価用キーは 100 クレジットから始まります — 回答の質を判断するには十分で、 本番運用には足りない量です。

課金しない場合 — この一覧を公開すること自体が方針です：

• 認証・検証・レート制限の失敗
• 当方側のエラーとタイムアウト
• isError: true で返ったすべての呼び出し。モデル料金を既に支払っていても、 分析が失敗したならそれは当方の損失であってお客様の損失ではありません
• すでに応答した要求の5分以内の再試行

差し引きはツールが実行された後に行います。先に受け取って後で返すことはしません。 有料応答には _meta.credits_remaining が含まれ、エージェントが自ら残高を把握して ユーザーに伝えられます。

冪等性。エージェントは再試行が多いものです。 params._meta["ai.seldons/requestId"] を送れば、5分以内の再要求は最初の答えを そのまま無料で返します。送らない場合はアカウント・ツール・引数から当方が生成します。

エラーはどんな形ですか？

ツールの失敗は JSON-RPC エラーではなく、isError: true の通常の結果 として返ります。MCP 規格がそう求めており、そうしなければモデルが読んで自ら修正できません。

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Not enough credits for this call.",
    "retryable": false,
    "required": 3,
    "remaining": 0
  }
}

コード: AUTH_REQUIRED · INSUFFICIENT_CREDITS · INVALID_INPUT · RATE_LIMITED · URL_UNREACHABLE · INTERNAL_ERROR · UPSTREAM_UNAVAILABLE。retryable は必ず入ります。これがないとエージェントは 無限に再試行するか、逆に一時的な障害を恒久的な失敗として扱い、自分の推測で答えを作ります。

呼び出し上限は？

キーなしで毎分10回・1日100回（IP単位）。キーがあればプランに応じて毎分20回・1日500回から 始まります。上限は依存している一次データ提供元の制限から逆算しています — 当方の上限が 提供元より緩ければ提供元が先に止まり、そのときは一人ではなく全員が同時に失敗します。

キーはどう取得しますか？

クレジットパックをご購入ください。Lemon Squeezy がライセンスキーをメールでお送りします。 そのキーをクレーム ページに貼り付けると、クレジットが 入った状態の sk_live_… キーをその場でお渡しします。先に作るアカウントも、 こちらの対応をお待ちいただく必要もありません。

購入前に有料ツールをお試しになりたい場合は何を作られているかお知らせ ください。100 クレジット入りの評価用キーをお渡しします — 回答の質を判断するには十分で、 本番運用には足りない量です。こちらからご依頼ください。

クレジットに期限はなく、サブスクリプションでもありません。Starter は 商品ページ分析 約375回にあたります。輸出価格計算は無料で、パックのクレジットを消費しません。 無料の呼び出しにもレート制限は適用されます。パックは呼び出し速度も決めます。 Starter は starter ティア、Team と Scale は team ティアです:

同じメールアドレスで再度ご購入いただくと、お使いのアカウントに追加されます — キーが増えず、 これまでのキーをそのままお使いいただけます。返金の際はクレジットを戻し、すでにお使いの場合は 残高がマイナスになります。隠すよりそのままお見せする方がよいと考えています。

価格は米ドルで、Lemon Squeezy が販売者（merchant of record）です。VAT・GST の処理と 請求書は当社ではなく同社から発行されます。

キーは sk_live_… の形です。保存しているのはハッシュだけなので、紛失しても 再表示できません — 失効させて新しく発行します。

なぜ作ったのですか？

このサイトのツールは、ブランドが国境を越えて売るときに生じる問いに答えます。あの市場に 届けるといくらか、どの認証が要るか、国内で通用したページがなぜ海外で通用しないのか。 人はブラウザで無料で使います。

同じ仕事をするエージェントはブラウザのフォームを使えません。同じ答えをデータとして 受け取る必要があり、前提には名札が、出典には出典が付いていて、照会が失敗したときには明確な わからないが返らなければなりません。最後の点は思うより重要です — きれいな「不明」を 受け取れなかったエージェントは、空白を推測で埋めてそれを答えとして提示します。

ウェブのツールとこのサーバーは同じコードを呼びます。ここで得た数値は、このサイトの計算機が 返す数値と同じです — 主張ではなく、ビルドのたびに検査しています。