Juicy Designs Quote

Juicy Designs — 报价 MCP 服务 + REST API（Cloudflare Worker）

为 AI Agent 提供请求和只读功能，通过两种方式公开：

传输方式	路径	适用对象
MCP（Streamable HTTP）	POST /mcp	ChatGPT / Claude / Agent 连接器
REST 请求	POST /quote、POST /strategy-session	Agent 浏览器 / 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）。读取工具仅返回精心整理的静态数据；不含个人身份信息，也不会发起外部调用。

保证

• 绝不返回或暗示价格。 已公布的“起价”仅供了解入门价格，不构成报价或估算。只确认已收到请求，并告知四个工作小时的服务级别协议（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 服务，并使用相同的 /mcp URL。 连接器会列出一个工具：get_quote。Agent 应先向用户复述各字段内容并确认其同意，然后再调用。无需身份验证（该工具只会创建一条潜在客户信息）。

连接器发现（方便 Agent 找到它）

部署后，从网站公布这些端点：

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——部署后再填入，避免出现失效链接。）

输入 → Apps Script 字段对照

MCP/REST 输入	发送为	电子邮件/表格中显示为
service（枚举）	services（标签）	Services
budget_range（枚举）	budget（标签）	Budget
project_summary（+ 时间线 + 来源）	message	Message
name / email / phone / company	相同	原样显示
form_type	quote	路由至报价邮件/模板

替换 src/index.ts 中 forwardLead() 的函数体，即可将潜在客户信息发送到其他位置（CRM、webhook、Resend）。