Juicy Designs Quote

Juicy Designs — 見積もり MCP サーバー + REST API（Cloudflare Worker）

AI エージェント向けのリクエスト機能と読み取り専用機能を、2 つの方法で公開します。

トランスポート	パス	用途
MCP（Streamable HTTP）	POST /mcp	ChatGPT / Claude / エージェントコネクター
REST リクエスト	POST /quote, POST /strategy-session	エージェント対応ブラウザー / OpenAPI クライアント
REST 読み取り	GET /service-catalog /service-areas /case-studies /client-reviews /faqs	参照データの読み取り
検出	GET /, GET /openapi.json	ヘルスチェック + 機械可読な仕様

ツール

ツール	種類	目的
get_quote	リクエスト	無料で、義務のない見積もりをリクエストします。同意が必要です。
book_strategy_session	リクエスト	無料の戦略セッションをリクエストします。同意が必要です。
get_service_catalog	読み取り	サービス + 参考用の「〜から」の料金（参考情報のみ）。
get_service_areas	読み取り	Juicy Designs の対応地域です。
get_case_studies	読み取り	実績とポートフォリオへのリンクです。
get_client_reviews	読み取り	Google の総合評価とレビュー元です。
get_faqs	読み取り	よくある質問と回答です。

どちらのリクエストツールも、同じサーバー側の検証と同じ forwardLead() シンクを使用します。リードは form_type=quote として、既存の Juicy Designs Apps Script フォームハンドラー に送信されます。リードはウェブサイトのフォームからのリードとまったく同じ場所 （メール +「Leads」Google Sheet）に届きます。読み取りツールが返すのは、厳選された静的データのみです。PII は含まず、 外部への呼び出しもありません。

保証

• 価格を返したり、価格を示唆したりすることはありません。 公開されている「〜から」の金額は、あくまで開始価格の参考情報であり、見積もりや概算ではありません。受付の確認と 4 営業時間の SLA のみを伝えます。
• すべてのリクエストツールで consent_to_contact !== true を拒否します（POPIA）。
• すべての入力をサーバー側で検証します — モデルによる抽出結果を信頼することはありません。
• 読み取りツールは副作用がなく、ユーザーごとの計算も行いません。
• 列挙型の入力は、Apps Script のメール／シートが想定するラベルに対応付けられます。

デプロイ

cd mcp-quote-worker
npm install

# 1) Lead sink (the existing Apps Script /exec URL)
npx wrangler secret put LEAD_ENDPOINT
#   paste: https://script.google.com/macros/s/AKfycb.../exec

# 2) (optional) per-IP rate limit — Apps Script already throttles 5/10min
# npx wrangler kv namespace create RATELIMIT   # then paste id into wrangler.toml + uncomment

npx wrangler deploy

デプロイ時に Worker の URL が出力されます。例：https://juicy-designs-quote.<subdomain>.workers.dev。 そのオリジンを openapi.yaml の servers.url と、エンドポイントを案内するすべての場所に設定してください。

ローカルでのテスト

npx wrangler dev          # serves on http://localhost:8787

# REST
curl -s localhost:8787/quote -H 'content-type: application/json' -d '{
  "name":"Sipho Dlamini","email":"[email protected]","service":"seo",
  "project_summary":"E-commerce store, want to rank for running shoes in SA.",
  "budget_range":"25k_75k","timeline":"1_3_months","consent_to_contact":true
}'

# MCP: list tools
curl -s localhost:8787/mcp -H 'content-type: application/json' -d \
  '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# MCP: call get_quote
curl -s localhost:8787/mcp -H 'content-type: application/json' -d \
  '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_quote","arguments":{"name":"Sipho","email":"[email protected]","service":"seo","project_summary":"Need SEO for a new store in Pretoria.","consent_to_contact":true}}}'

consent_to_contact:true を含まないリクエストは、エラーとして返される必要があります。これは POPIA によるゲートが機能していることを示します。

コネクターとして接続する

Claude（Settings → Connectors → Add custom connector）： URL = https://<worker>/mcp。 ChatGPT（Settings → Connectors / Developer mode）： 同じ /mcp URL を使って MCP サーバーを追加します。 コネクターに表示されるツールは get_quote の 1 つです。エージェントは呼び出す前にフィールドの内容をユーザーに読み上げ、同意を確認してください。リードを作成するだけのツールなので、認証は不要です。

コネクターの検出（エージェントが見つけられるようにする）

デプロイ後、サイトからエンドポイントを案内します。

1. 簡潔なドキュメントページ（例：/connect/ または /quote/ のセクション）に MCP と OpenAPI の URL を掲載します。
2. llms.txt（juicydesigns.co.za のルート）に追記します。

## For AI agents
- MCP server (request a quote): https://<worker>/mcp
- OpenAPI 3.1 spec: https://<worker>/openapi.json

（実際の Worker URL が決まるまでは、リンク切れを防ぐため llms.txt への追記を見送ってください。デプロイ後に URL を貼り付けてください。）

入力から Apps Script フィールドへの対応表

MCP/REST の入力	送信先	メール／シートでの表示
service（列挙型）	services（ラベル）	サービス
budget_range（列挙型）	budget（ラベル）	予算
project_summary（+ スケジュール + 参照元）	message	メッセージ
name / email / phone / company	同じ	入力どおり
form_type	quote	見積もり用メール／テンプレートに振り分け

リードの送信先を変更する場合は、src/index.ts の forwardLead() の本体を差し替えてください（CRM、Webhook、Resend など）。