在 Claude 或 ChatGPT 里直接用 Put Roots

一个地址

https://www.putroots.com/mcp

claude.ai / ChatGPT：加成自定义连接器。地址要逐字一致——它是精确比对的。

Claude Code：

claude mcp add --transport http putroots https://www.putroots.com/mcp

授权走标准 OAuth：你在我们的页面上用 Put Roots 账号登录，看清这条连接会读到什么，之后随时可以在「我授过哪些权」撤销。

它能回答什么

• 搜房源——我们的旧金山房源，每条带来源、抓取日期，以及房东到底写没写要求。不用账号（免费样本；登录后是全库）。
• 这套我够不够得着——一套房写明的门槛逐条对照你的档案：房东写了什么、你填了什么、差在哪，带房东原句。要登录，因为比的是你自己填的资质。
• 银行、卡、电话卡、SSN——没有 SSN 也走得通的路，带门店地址、营业时间和每条答案的核验日期。不用账号。
• 开始我的搬家——给你一条注册链接，搬家日和新地址已经填好，60 天计划从你刚才告诉助手的那些开始。链接不打开、不自己注册，什么都不会建。要登录。

三条规矩跟着每个回答走：不说「你能 / 不能租到」——那是房东的决定；「房东没写」是答案不是空白；每条事实带来源和日期。

这些工具后面是什么

一个替租客跑完 60 天搬家的 agent：七段 40 多件事，每一件发出去之前都要租客点头。今天生产上已经在做的：选免 SSN 的银行；按房东自己写的规则排房；给搬家、仓储、保洁各发报价请求；给旧房东写退租通知；取消网络和健身房；搬家前一天确认搬家公司和取钥匙时段；预开宽带和水电；在宽带、DMV、USCIS、保险网站上填到最后一格；在地图上挑健身房、牙医、兽医并打电话；组第一车家具；追押金。连接器开放的是其中「读」的那一半，下面的 REST API 开放的是合作方那一半。

只读，而且是故意的

这条连接读得到我们的答案。以你的名义做事——给房东写信、打那通电话、追那次跟进——只发生在 Put Roots 这边，而且要你自己按下发送。 它唯一能「开始」的是一条你还得自己打开的链接。这条边界正是重点：读的那半可以到处去，动手的那半不出门。

合作方与开发者：同一套东西的 API 形态

连接器能做的，加上只给合作方的操作，都出自同一张表。三种拿法：

• MCP——就是这页。给用 Claude、ChatGPT 或自己 agent 的人。
• REST——https://www.putroots.com/v1/，说明书在 /v1/openapi.json（OpenAPI 3.1）。给房源站、物管、搬家公司这些跑平台而不是跑助手的一方。
• 出站推送——搬家、仓储、保洁公司：租客批准报价请求那一刻，我们把一条签了名的 JSON 线索推到你的 CRM 端点，和他发给你的那封信一起到。

拿 key：POST /v1/partners，表单在 OpenAPI 里（code、名字、kind、段、联系邮箱；provider 还要说自己是哪类服务、怎么收）。key 只显示一次。key 按旅程的段给 scope：core 人人有，再按登记的段给 rental_readiness、move_intake 或 life_setup。

curl -X POST https://www.putroots.com/v1/partners \
  -H 'Content-Type: application/json' -d '{
  "code": "acme-movers-test", "name": "Acme Movers",
  "kind": "provider", "service": "movers",
  "stages": ["move_planning"], "contact_email": "you@acme.example",
  "delivery": { "intake_email": "leads@acme.example" }, "test": true }'

先跑沙箱，不用等：登记时带 "test": true，回来的 pr_test_ key 当场就能用，没有放行这一步。它是演练档：线索回来是脱敏的，真线索永远不会投给它，什么都不落库，交接不计费。你那头跑通了，再单独登记你的正式 code（一个 code 只能登记一次，key 的档次登记时就定死）、不带这个开关：那把 pr_live_ key 在我们邮件放行（一个工作日内）之前一律回 403 pending_approval。

affiliate 服务商（保险、宽带、手机卡）：把整条追踪链接填进 delivery.affiliate_code；只有这一种收法时 config.vendor（任务图里认你的名字）必填。助手替用户办这件事时用那条链接进站，每次打开都是 GET /v1/events 里的一条 link_out。

联调：POST /v1/leads/sample 往你登记的端点或信箱发一条虚构的、签了名的线索，形态与真的一样。

合作方永远拿不到的：租客逐行的资质对照（那是租客自己的，只在连接器里给本人）、测试 key 上的姓名和地址、别家合作方的用户。错误直说：401 没 key，403 待放行 / 已撤销 / scope 不对，404 不是你的，429 带 Retry-After。