DealFlowPro MCP Server 是 DealFlowPro 平台提供的 MCP（Model Context Protocol）服务器，用于从 Claude Code、Cursor、Claude Desktop 或任何兼容 MCP 的客户端分析多户住宅房地产交易。DealFlowPro 本身是一个 AI 驱动的多户住宅交易分析平台，该 MCP 服务器封装了 DealFlowPro REST API，使 AI 智能体能够访问机构级承销计算。
用途 用户可以用自然语言向 Claude 提问，Claude 会自动调用正确的工具。例如：分析 Charlotte 一处 24 单元交易（要价 200 万美元，月租金 1.36 万美元，支出 5500 美元）；为 12 单元、150 万美元、月收入 9000 美元的交易评分；在希望获得 8% 现金回报率的情况下，月租金 2.88 万美元的物业最高应出价多少；查询某地址是否位于洪水区。
主要能力 四个计算工具均带有 MCP 2025-06-18 注解（title、readOnlyHint、destructiveHint、idempotentHint、openWorldHint），且每个工具都是只读的。作为 Claude 插件安装时，连接的是远程服务器 https://dealflowpro.io/mcp，而非 npm 包，因此提供八个工具而非四个：额外增加 list_my_deals、get_deal_analysis、get_my_criteria 和 portfolio_summary，用于访问已保存的交易、买入标准（buy-box criteria）和管道，且范围限定在用户账户内。插件使用 OAuth 而非 API Key，无需导出 DFP_API_KEY，连接时登录 DealFlowPro 账户即可。若需要本地 stdio 服务器、偏好 API Key 认证，或将 DealFlowPro 接入非 Claude 的 MCP 客户端，则应使用 npm 包。
面向机构 AI 团队 DealFlowPro 可接入 AI 评估管道和生产 AI 栈。MCP 服务器（npm 包及远程端点）封装与 REST API 相同的引擎，具有 schema 严格、幂等、可预测的特点。认证与作用域方面，每次工具调用都经过认证（Bearer API Key 或远程端点的 OAuth 登录），调用范围限定在签发密钥或登录的账户内，无跨租户访问路径。每个工具的审计行记录在账户的 logs/mcp_tool_calls.log 中，捕获工具名称和扁平化参数键（不含值），因此使用可审计而不暴露交易内容。速率限制按层级划分，每个响应返回速率限制头（X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset），429 响应包含 Retry-After。错误码稳定且文档化于 dealflowpro.io/api/docs/#errors，所有错误均为 JSON {success: false, error: {code, message}} 格式，代码包括 invalid_input (400)、invalid_json (400)、unauthorized (401)、tier_required (403)、method_not_allowed (405)、payload_too_large (413)、rate_limit_exceeded (429)、internal_error (500)。工具 schema 方面，每个 MCP 工具都有 schema 严格的输入定义，可对远程端点调用 tools/list 获取运行时规范 schema；REST OpenAPI 规范覆盖四个计算工具（analyze_deal、score_deal、reverse_calc、market_data）的相同形状。远程服务器上的四个已保存管道工具（list_my_deals、get_deal_analysis、get_my_criteria、portfolio_summary）仅限 MCP 使用，且需要 Essentials 计划或更高层级。评估框架模式建议：维护（交易负载 → 预期指标）的固定测试集，对 score_deal（最轻量工具，每次调用仍计为一次请求）运行，断言指标在容差范围内；端点具有确定性，相同输入产生相同输出。数据处理方面，请求负载在内存中处理，不持久化到磁盘；传输使用 TLS 1.2+；当 DealFlowPro 内部使用 Claude 进行文档提取时，Anthropic API 调用通过 DealFlowPro 的零数据保留 Anthropic 工作区进行。完整安全态势见 dealflowpro.io/security#api-mcp-data-handling。
使用方式 有两种安装路径。路径 A——远程 MCP URL（无需本地安装）：适用于 claude.ai 网页版（自定义连接器）、使用 HTTP 传输的 Claude Code 或 Claude API mcp_servers。端点为 https://dealflowpro.io/mcp（Streamable HTTP，MCP 2025-06-18）。在 claude.ai 网页版 / Claude Desktop 中，DealFlowPro 已列在 Claude Connectors Directory 中，可直接添加，也可自行添加为自定义连接器：Customize → Connectors → "Add custom connector" → 命名为 DealFlowPro，粘贴 https://dealflowpro.io/mcp → Add → Connect → 登录 DealFlowPro → 点击 Allow。OAuth 自动处理认证（无需管理 API Key）。然后在聊天中点击 "+" → Connectors → 打开 DealFlowPro 开关。团队/企业计划成员不能自行添加自定义连接器，需由组织 Owner 在 Organization settings → Connectors → Add → Custom（type: Web）添加一次，然后每个成员从 Customize → Connectors 连接自己的 DealFlowPro 账户。Claude Code（HTTP）需在 dealflowpro.io/api 获取 Bearer 密钥（免费 5 次请求密钥，无需信用卡，或按量付费积分）。完整设置详情和已连接应用撤销见 dealflowpro.io/api/docs#mcp。路径 B——本地 stdio（此 npm 包）：适用于希望本地运行 MCP 服务器或客户端无远程 URL 路径的情况。Claude Desktop 两者都支持：通过 Settings → Connectors 使用远程，或使用下方本地配置。首先在 dealflowpro.io/api 获取 API 密钥（免费 5 次请求密钥，无需信用卡，或购买按量付费积分），通过电子邮件发送。然后添加到客户端，例如 Claude Desktop 的 claude_desktop_config.json。之后只需向 Claude 询问交易，它会自动选择正确的工具。
适用场景 适用于运营商、联合组织者和私募股权公司快速筛选交易。DealFlowPro 自动化 2-200 单元物业的多户住宅承销，上传经纪人邮件或 OM，10 分钟即可获得完整投资分析，而非 2 小时。也适用于需要将 DealFlowPro 接入 AI 评估管道和生产 AI 栈的机构 AI 团队。
限制 四个计算工具为只读；远程服务器的四个已保存管道工具需要 Essentials 计划或更高层级。速率限制按层级划分。定价方面：按量付费 $1/API 请求，起价 $5；Essentials 每月 $79，含每天 50 次 API 请求；Premium 每月 $149，含每天 200 次请求及反向计算器；Enterprise 每月 $399，含每天 1,000 次请求。请求负载在内存中处理，不持久化到磁盘。
