实用指南：家族办公室如何运用 Claude + FMP MCP 进行风险检测

本指南将逐步演示如何从原材料构建出可运行的系统，主题为：家族办公室如何利用 Claude + FMP MCP 在重新平衡前检测投资组合的偏离情况。重点在于具体的操作步骤、明确的检查点，以及可直接放入代码库中的代码，无需猜测其用途。 在概览阶段，应在修改代码之前明确输入参数、各步骤的负责人以及结束标准。操作人员应能够从已知的检查点重新运行相应步骤，而无需推测隐藏的状态。 配置信息应与应用程序代码分开存放。环境文件、密钥存储以及功能开关应集中管理，以便操作人员无需查看整个系统结构即可进行审计。

为何在重新平衡前需关注投资组合偏离

在处理“为何投资组合漂移很重要”这一阶段时，首先写下相关契约：所需的输入参数、成功标志以及部分失败时的处理方式。这样的检查清单能确保后续的代码修改保持一致性。 同时记录正常流程和异常恢复流程。重试机制、人工审核环节以及错误处理都属于产品功能的一部分，而非后续的优化工作。 需为每次调用记录工具名称、参数哈希值、延迟时间以及最终结果。没有这些记录，调试代理循环将会耗费大量时间。

各持仓与目标值的偏离程度如何？

在分析每个阶段的进展时，首先写下相关契约：所需的输入参数、成功标志以及部分失败时的处理方式。这样的检查清单能确保后续的代码修改保持一致性。 优先选择小型且可测试的单元，而非冗长的脚本。当某个步骤失败时，故障应能指向单一的责任模块，而非复杂的流程链。 为每次调用记录工具名称、参数哈希值、延迟时间以及最终结果。没有这些记录，调试过程将会浪费大量时间。

与初始分配相比，偏差程度有多大？

在处理“规模有多大”这一阶段时，首先需明确合同条款：所需输入、成功标志以及部分失败时的处理方式。这样的清单能确保后续的代码修改保持一致性。 将这一阶段视为输入与验证后输出之间的契约。为相关成果命名，定义成功检测标准，并杜绝无声的半完成状态。 需记录每次调用的工具名称、参数哈希值、延迟时间以及最终结果。没有这些记录，调试过程将会浪费大量时间。 在处理“规模有多大”这一阶段时，首先需明确合同条款：所需输入、成功标志以及部分失败时的处理方式。这样的清单能确保后续的代码修改保持一致性。 应将配置信息置于应用程序代码之外。环境文件、密钥存储以及功能开关应集中存放于一个位置，以便操作人员无需查看整个系统结构即可进行审计。

投资组合在行业层面是否出现偏移？

“投资组合是否出现偏移”这一阶段若被视为可度量的指标，则效果最佳。在扩大范围之前，需记录一个成功的案例、一个失败案例以及回滚说明。同时将正常流程与恢复流程都记录下来。重试机制、人工审核环节以及错误处理方式都是产品本身的一部分，而非后续需要补充的内容。应提供具有明确结构定义和清晰副作用标识的工具，这样主机才能在自动批准之前知道哪些调用会改变状态。

是哪些资产推动了变化？

“哪些控股公司在起推动作用”这一阶段若被视为可度量的指标则最为有效。在扩大范围之前，先记录一个成功的案例、一个失败案例以及回滚说明。 相较于庞大的脚本，应优先选择小型且可测试的单元。当某一步骤失败时，故障应能指向单一的责任主体，而非复杂的流程链。 使用结构清晰、带有明确副作用标注的工具。主机需要在自动批准之前知道哪些调用会改变状态。

FMP数据与Claude MCP配置

FMP Data与Claude阶段若被视作可度量的处理界面，效果会最佳。在扩大范围之前，需记录一份理想的处理结果、一个失败案例以及回滚说明。 应将此阶段视为输入与已验证输出之间的契约。为相关成果命名，明确成功标准，绝不允许默许部分完成的情况。 应使用具有严格结构定义且带有明确副作用标注的工具。主机需要在自动批准之前知晓哪些调用会改变系统状态。 FMP Data与Claude阶段若被视作可度量的处理界面，效果会最佳。在扩大范围之前，需记录一份理想的处理结果、一个失败案例以及回滚说明。 配置应置于应用程序代码之外。环境文件、密钥存储及功能开关应集中存放于一处，以便操作人员无需查看整个系统结构即可进行审计。

通过FMP MCP获取的数据

对于通过FMP阶段获取的数据，在修改代码之前需明确输入参数、该步骤的负责人以及终止标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。 需同时记录正常流程和异常恢复流程。重试机制、人工审核环节以及错误处理都是产品本身的组成部分，而非后续需要补充的内容。 必须引用实际作为答案依据的段落。如果没有引用，操作人员就无法区分是虚假信息还是索引缺失导致的错误。

为何使用经股息调整后的价格

在修改代码之前，对于“为何要使用经股息调整的价格”这一阶段，需先明确输入参数、该步骤的负责人以及终止标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。相比庞大的脚本，更应采用小型且可测试的单元。当某个步骤出现故障时，故障原因应能指向单一责任主体，而非复杂的流程链。应在网关处进行身份验证，在数据层面重新授权——仅凭承载令牌并不足以界定租户边界。

从目标权重到偏差

在进入“从目标权重”阶段之前，需先明确输入参数、该步骤的负责人以及终止标准，然后再进行代码修改。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测其中的隐藏状态。 应将此阶段视为输入与经过验证的输出之间的契约。为相关成果命名，设定成功检测标准，并杜绝无声的半完成状态。 在网关处进行身份验证，在数据层面重新授权。仅凭承载令牌并不足以界定租户边界。 在进入“从目标权重”阶段之前，需先明确输入参数、该步骤的负责人以及终止标准，然后再进行代码修改。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测其中的隐藏状态。 将配置信息置于应用程序代码之外。环境文件、密钥存储以及功能标志应集中存放于一个位置，以便操作人员无需查看整个系统结构即可进行审计。

衡量投资组合偏差与审查阈值

在处理“衡量投资组合偏差”这一阶段时，首先需明确相关约定：所需的输入参数、成功标志，以及部分失败时的处理方式。这样的检查清单能确保后续的代码修改保持一致性。 需同时记录正常流程与异常恢复流程。重试机制、人工审核环节以及错误处理方式都是产品本身的一部分，而非后续需要补充的内容。 对于每次调用，都要记录工具名称、参数哈希值、延迟时间以及最终结果。没有这些记录，调试代理循环将会耗费大量时间。

持仓级审查规则

在处理“职位级审查规则”阶段时，首先写下相关契约：所需的输入参数、成功标志以及部分失败时的处理方式。这样的检查清单能确保后续的代码修改保持一致性。 优先选择小型、可测试的单元，而非庞大的脚本。当某个步骤失败时，故障应能指向单一的责任模块，而非复杂的流程链。 需为每次调用记录工具名称、参数哈希值、延迟时间以及最终结果。没有这些记录，调试过程将会浪费大量时间。

行业级偏差

在处理“领域级漂移”阶段时，首先需写下相关契约：所需输入、成功标志以及部分失败时的处理方式。这样的清单能确保后续的代码修改保持一致性。 将此阶段视为输入与验证后输出之间的契约。为相关产物命名，明确成功判定标准，杜绝无声的半完成状态。 需记录每次调用的工具名称、参数哈希值、延迟时间以及最终结果。没有这些记录，调试过程将会浪费大量时间。 在处理“领域级漂移”阶段时，首先需写下相关契约：所需输入、成功标志以及部分失败时的处理方式。这样的清单能确保后续的代码修改保持一致性。 应将配置信息置于应用程序代码之外。环境文件、密钥存储以及功能开关应集中存放于一处，以便操作人员无需查看整个系统结构即可进行审计。

衡量整体投资组合的漂移情况

将“衡量整体投资组合偏移”阶段视为可测量的对象来处理时，其效果最佳。在扩大范围之前，需记录一个成功的案例、一个失败案例以及回滚说明。同时记录正常流程与恢复流程。重试机制、人工审核环节以及错误处理都属于产品本身的功能，而非后续需要补充的内容。应提供具有明确结构规范和清晰副作用标识的工具，以便主机在自动批准之前能够知晓哪些调用会改变状态。

识别导致偏移的主要因素

将“识别主要贡献者”阶段视为可度量的对象来处理效果最佳。在扩大范围之前，先收集一份典型的成功案例、一个故障实例以及回滚说明。 优先选择小型且可测试的单元，而非庞大的脚本。当某个步骤出现故障时，故障应指向单一的责任模块，而非复杂的流程链。 使用结构清晰、带有明确副作用标注的工具。主机需要在自动批准之前知道哪些调用会修改状态。

使用 Claude 执行分析

将“执行分析”阶段视为可度量的工作面时，其效果最佳。在扩大范围之前，需记录一份理想状态的输出样本、一个失败案例以及回滚说明。 应将此阶段视为输入与已验证输出之间的契约。为相关成果命名，明确成功标准，杜绝默许的半完成状态。 需使用具有严格结构定义且带有明确副作用标签的工具。主机需要在自动批准之前知晓哪些调用会改变系统状态。 将“执行分析”阶段视为可度量的工作面时，其效果最佳。在扩大范围之前，需记录一份理想状态的输出样本、一个失败案例以及回滚说明。 配置应置于应用程序代码之外。环境文件、密钥存储及功能开关应集中存放于一处，以便操作人员无需查看整个系统结构即可进行审计。

Act as an investment-research analyst supporting a family office.

Using only the Financial Modeling Prep (FMP) MCP server, analyze how far the following hypothetical portfolio has drifted from its original target allocation.

Do not use web search or outside data.

Portfolio:

MSFT — Target Weight: 20% — Initial Allocation: $200,000
NVDA — Target Weight: 15% — Initial Allocation: $150,000
JPM — Target Weight: 20% — Initial Allocation: $200,000
GOOGL — Target Weight: 15% — Initial Allocation: $150,000
XOM — Target Weight: 15% — Initial Allocation: $150,000
JNJ — Target Weight: 15% — Initial Allocation: $150,000

Total portfolio value at inception = $1,000,000.

Assume:
- no trades occurred after the initial allocation;
- no capital was added or withdrawn;
- no manual rebalancing occurred;
- transaction costs, taxes, and cash balances are outside the scope of this demonstration.

Analysis date: August 27, 2026.
Use August 26, 2026, the last completed U.S. trading session, as the ending price date.

Retrieve for each ticker:
- company name;
- sector;
- industry;
- dividend-adjusted historical price for January 2, 2026;
- dividend-adjusted historical price for August 26, 2026.

Use the FMP dividend-adjusted historical price series if available.

If an exact date is unavailable, use the closest valid trading date and state the date actually used.

Do not estimate missing FMP values.

Reconstruct the portfolio using the dividend-adjusted price change as a total-return proxy.

Calculate for each holding:
- growth factor;
- ending value;
- current portfolio weight;
- absolute drift in percentage points;
- relative drift as a percentage of target weight.

Classify each holding using these illustrative rules:

Within Range:
- absolute drift below 2 percentage points; AND
- absolute relative drift below 15%.

Monitor:
- absolute drift between 2 and 4 percentage points inclusive; OR
- absolute relative drift between 15% and 25% inclusive;
- provided Review Required has not already been triggered.

Review Required:
- absolute drift above 4 percentage points; OR
- absolute relative drift above 25%.

Also calculate target and current sector weights using FMP sector classifications.

Classify sector drift as:
- Within Range: below 3 percentage points;
- Monitor: 3–5 percentage points inclusive;
- Review Required: above 5 percentage points.

Calculate Portfolio Allocation Distance as:

0.5 × sum of the absolute position-level weight deviations.

Do not assign a Low, Medium, or High label to this metric.

Also calculate each holding's contribution to total absolute drift.

Based strictly on the calculated evidence, identify:
- the largest overweight;
- the largest underweight;
- Monitor positions;
- Review Required positions;
- the sectors with the largest drift;
- the holdings contributing most to total drift;
- the highest-priority deviations for analyst review.

Do not recommend buying, selling, trimming, adding to, or rebalancing any security.

If important price, sector, or classification data is missing or conflicting, use Review Required rather than guessing.

Do not claim that corporate events were checked unless data capable of verifying them was actually retrieved.

Present the results clearly and concisely using tables where useful.

Include:
- methodology and actual dates used;
- reconstructed portfolio weights;
- position-level drift;
- sector-level drift;
- Portfolio Allocation Distance;
- contribution to total drift;
- key findings;
- Review Required items;
- FMP MCP tools and data types used.

Claude的发现：哪些资源分配的变化最大

在“What Claude Found Which”阶段，应在修改代码之前明确输入内容、该步骤的负责人以及终止标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。 需同时记录正常流程和异常恢复流程。重试机制、人工审核环节以及错误处理都是产品本身的组成部分，而非后续需要补充的功能。 在网关处进行身份验证，在数据层进行重新授权。仅凭承载令牌并不足以界定租户边界。

JNJ和XOM的表现远超目标

在JNJ和XOM的迁移阶段，应在修改代码之前明确输入参数、该步骤的负责人以及完成标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。相比庞大的脚本，更应采用小型且可测试的单元。当某个步骤失败时，故障原因应能明确指向某个特定责任方，而非整个复杂的流程链。应在网关处进行身份验证，在数据层再次授权——仅凭承载令牌并不足以界定租户边界。

MSFT成为被低估最严重的股票

在将代码改为“MSFT Became the Largest”阶段之前，需先明确输入参数、该步骤的负责人以及结束标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测其中的隐藏状态。 应将此阶段视为输入与已验证输出之间的契约。为相关产物命名，设定成功检测标准，并杜绝默许的半完成状态。 在网关处进行身份验证，在数据层面重新授权。仅凭承载令牌并不足以界定租户边界。 在将代码改为“MSFT Became the Largest”阶段之前，需先明确输入参数、该步骤的负责人以及结束标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测其中的隐藏状态。 应将配置信息置于应用程序代码之外。环境文件、密钥存储以及功能标志应集中存放于一个位置，以便操作人员无需查看整个系统结构即可进行审计。

整体分配距离提升了4.15个百分点

在处理“整体分配距离已达到”这一阶段时，首先需记录下相关合同细节：所需输入参数、成功标志以及部分失败时的处理方式。这样的清单能确保后续的代码修改不会出错。 同时记录正常流程和故障恢复流程。重试机制、人工审核环节以及错误处理方式都是产品本身的一部分，而非后续需要补充的内容。 需为每次调用记录工具名称、参数哈希值、延迟时间以及最终结果。没有这些记录，调试过程将会浪费大量时间。

JNJ和XOM导致了总偏差的一半

在处理 JNJ 和 XOM 的驱动阶段时，首先写下相关契约：所需的输入参数、成功标志以及部分失败时的处理方式。这样的检查清单能确保后续的代码修改保持一致性。 建议使用小型、可测试的单元，而非冗长的脚本。当某个步骤失败时，故障应能指向单一的责任模块，而非复杂的流程链。 需为每次调用记录工具名称、参数哈希值、延迟时间以及最终结果。没有这些记录，调试过程将会浪费大量时间。

行业偏离程度仍在可控范围内

在处理“Sector Drift Stayed Within”阶段时，首先需写下相关契约：所需的输入参数、成功标志以及部分失败时的处理方式。这样的清单能确保后续的代码修改始终符合约定。 将此阶段视为输入与验证后输出之间的契约。为相关产物命名，明确成功判定标准，杜绝无声的半完成状态。 需记录每次调用的工具名称、参数哈希值、延迟时间以及最终结果。没有这些记录，调试过程将会浪费大量时间。 在处理“Sector Drift Stayed Within”阶段时，首先需写下相关契约：所需的输入参数、成功标志以及部分失败时的处理方式。这样的清单能确保后续的代码修改始终符合约定。 应将配置信息置于应用程序代码之外。环境文件、密钥存储以及功能开关应集中存放于一个位置，以便操作人员无需查看整个系统结构即可进行审计。

何时需要分析师介入

将“何时需要分析师介入”这一阶段视为可度量的指标会更为有效。在扩大范围之前，先记录一份最佳操作案例、一个故障实例以及回滚说明。 同时记录正常流程和恢复流程。重试机制、人工审核环节以及错误处理都属于产品功能的一部分，而非后续需要补充的内容。 应提供具有明确结构定义和清晰副作用标注的工具。主机需要在自动批准之前知道哪些调用会改变系统状态。

阈值被突破并不一定意味着必须进行交易

将“A阈值突破”这一流程视为可测量的界面来处理时，其效果最佳。在扩大范围之前，先记录一份理想的执行日志、一个故障案例以及回滚说明。 相较于庞大的脚本，应优先选择小型且可测试的单元。当某个步骤出现故障时，故障点应指向单一责任主体，而非复杂的流程链。 使用结构清晰、带有明确副作用标注的工具。主机需要在自动批准之前知道哪些调用会改变状态。

企业事件可能解释大幅价格波动

“企业事件可解释性”阶段若被视为可度量的对象，效果最佳。在扩大范围之前，需记录一份理想案例、一个失败案例以及回滚说明。 应将此阶段视为输入与已验证输出之间的契约。为相关成果命名，明确成功标准，杜绝默许的半完成状态。 应使用具有严格结构且带有明确副作用标签的工具。在自动批准之前，负责人必须清楚哪些操作会改变系统状态。 “企业事件可解释性”阶段若被视为可度量的对象，效果最佳。在扩大范围之前，需记录一份理想案例、一个失败案例以及回滚说明。 配置应置于应用程序代码之外。环境文件、密钥存储及功能开关应集中存放，以便操作人员无需查看整个系统结构即可进行审计。

单一所有制行业需谨慎解读

对于需要谨慎处理的单一持有领域，在修改代码之前应明确输入参数、该步骤的负责人以及退出标准。操作人员应当能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。 需同时记录正常流程和故障恢复流程。重试机制、人工审核环节以及错误处理都是产品本身的组成部分，而非后续需要补充的功能。 在网关处进行身份验证，在数据层再次授权。仅凭承载令牌并不能作为租户边界。

实际的资产组合操作可能会打破模拟结果

在修改代码之前，需为实际的投资组合操作阶段明确输入参数、该步骤的负责人以及结束标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。相比冗长的脚本，更应采用小型且可测试的单元。当某个步骤失败时，故障原因应能指向单一责任主体，而非复杂的流程链。应在网关处进行身份验证，在数据层再次授权——仅凭承载令牌并不足以界定租户边界。

缺失或冲突的数据应触发审查

在“缺失或冲突数据”阶段，修改代码之前需明确输入参数、该步骤的负责人以及终止标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。 应将此阶段视为输入与已验证输出之间的契约。为相关成果命名，定义成功判定条件，并杜绝无声的半完成状态。 在网关处进行身份验证，在数据层面重新授权。仅凭承载令牌并不足以界定租户边界。 在“缺失或冲突数据”阶段，修改代码之前需明确输入参数、该步骤的负责人以及终止标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。 将配置信息置于应用程序代码之外。环境文件、密钥存储以及功能标志应集中存放于操作人员可审计的位置，无需查看整个系统结构。

从漂移检测到持续平衡性检查

在处理“从漂移检测”这一阶段时，首先需明确合同规范：所需的输入参数、成功信号以及部分失败时的处理方式。这样的检查清单能确保后续的代码修改保持一致性。 同时记录正常流程与故障恢复路径。重试机制、人工审核环节以及死信处理都属于产品功能的一部分，而非后续需要补充的内容。 需为每次调用记录工具名称、参数哈希值、延迟时间以及最终结果。没有这些记录，调试代理将陷入无休止的循环，耗费大量时间。

运营检查清单

将“运营检查清单”阶段视为可衡量的工作面，能使其发挥最佳作用。在扩大范围之前，应先收集一份标准操作记录、一个故障案例以及回滚说明。

在功能结果旁记录执行时间以及令牌或查询成本。提前显示成本可避免在系统从演示环境切换到共享环境时出现意外账单。

提供具有严格数据结构且带有明确副作用标签的工具。主机需要在自动批准之前知道哪些调用会修改状态。

在预算允许的情况下，使用测试数据而非真实的付费 API，在持续集成过程中对关键路径进行冒烟测试。

将配置信息与应用程序代码分开。环境文件、密钥存储和功能开关应集中存放，以便操作人员无需查看整个系统结构即可进行审计。

提供具有严格数据结构且带有明确副作用标签的工具。主机需要在自动批准之前知道哪些调用会修改状态。

在推广该技术栈之前，应先冻结版本，为关键流程记录标准输出日志，并明确回滚步骤。共享环境需要设置速率限制、租户验证机制，以及负责密钥轮换的明确责任人。与其展示花哨的一次性演示，不如注重扎实的可靠性。

f24d8fb9fdeb 的批量处理说明：不要将提供商密钥放入代码仓库，为每个会话设置令牌使用上限，并将日志存储在评估用示例文件旁边，以便后续模型更换时保持数据可比性。