网页应用
打开头像 → 设置 → 已连接的 AI 助手。
FINANCEIA · AI 连接指南
将 Financeia 连接到 ChatGPT、Gemini 和 Claude
从首次连接到批准交易：选择要分享的信息，询问自己的财务记录，并逐项审核所有修改建议。
生产环境 MCP 服务器 URL
https://api.financeia.app/mcp请选择 OAuth，无需提供服务商 API 密钥。能否使用取决于账号、地区和工作区政策；界面可能变化。
先确认账号和资料档案
登录 Financeia 并同步记录。所有套餐均包含 AI 连接功能，但在您同意之前，该功能保持关闭。
启用“已连接的 AI 助手”，阅读每项同意声明，并使用当前密码确认。
仅分享需要的个人或共同档案。读取权限允许查询报告；提案权限还允许向 AI 审核箱发送建议。共同档案的访问范围不会超出您自身的权限。
手机应用
打开头像 → 设置 → 安全偏好设置 → 已连接的 AI 助手。开启开关并阅读同意页面。
ChatGPT
在 ChatGPT 中添加自定义 MCP 插件
请在允许自定义 MCP 服务器的工作区中使用网页版 ChatGPT。
打开插件 → 添加（+）→ 添加自定义 MCP 服务器。旧版界面可能将其放在“应用”或“开发者模式”中。
名称填写 Financeia，输入上方的生产环境 URL，并选择 OAuth。除非 Financeia 已向您的组织发放客户端凭据，否则请留空。
阅读提示并确认，选择创建为插件，再选择安装/连接。完成下方的 Financeia 授权步骤。
开始新聊天，输入 @ 并选择 Financeia，请助手列出您分享的档案。继续之前确认账号无误。
Gemini
在 Gemini 中创建自定义应用
Google 目前要求使用美国境内符合条件的成年人个人账号、英语以及已开启的活动保存功能。仅有订阅并不保证可用，请查看 Google 最新要求。
打开自定义 → 连接器，或设置 → 个人智能 → 已连接的应用。
选择创建自定义应用，输入生产环境 MCP URL，然后选择下一步。
阅读 Google 提示，继续关联账号，并完成下方的 Financeia 授权。
在新聊天中输入 @ 并选择 Financeia，询问已分享的档案。如果没有自定义应用选项，请查看 Google 的资格要求。
Claude
在 Claude 中添加远程连接器
Team 或 Enterprise 组织可能需要先由组织所有者添加连接器，然后由每位成员授权自己的 Financeia 账号。
打开自定义 → 连接器 → 添加 → 添加自定义连接器。所有者也可使用组织设置 → 连接器。
输入 Financeia 和生产环境 MCP URL，然后选择继续。
选择立即登录，使用 Claude 支持的已发布客户端身份或自动注册。不要选择无需登录，也不要粘贴访问令牌。选择添加 → 连接。
完成下方的 Financeia 授权。在聊天的连接器/工具菜单中启用 Financeia，然后在新对话中询问已分享的档案。
将建议变为已确认的记录
虚构数据请求示例
在我的个人档案中，提议从 Everyday checking 支出 25 USD，类别为 Food & groceries，日期为2026年10月21日，说明为“指南演示午餐”。请询问缺失的信息，并且只提交一次供我审核。
先让助手找到准确的档案、账户和类别，并确认币种、日期及时区。信息缺失时，助手应当询问。
允许提案前，检查服务商工具调用的具体数据。提案不会记账，也不会改变余额。
在 Financeia 网页或手机应用中打开 AI 审核，选择正确档案，核对金额、账户、币种、日期、类别、说明和重复警告。批准已审核的确切版本，或修改后重新审核，也可以拒绝。批量批准前请检查选中项。
等待确认。发生中断后，先使用 get_proposal_status 或 get_batch_status，并通过搜索/详情核实交易，再决定是否重试。切勿重复提交结果不明的批次。
30秒内出现至少3项疑似重复记录时，可能触发提示性警告。助手应检查重复提交；警告本身不会自动拒绝请求。
全部支持的操作
包含全部58个工具及其权限和输入字段。技术标识符保持原样，以便对应实际工具调用。
先调用 list_profiles，再传入选定的 profile_id。使用 get_capabilities、get_profile_context 和 get_data_completeness 确认支持的流程、时区、币种和数据覆盖情况。
已分享的档案及权限list_profiles读取 / 模拟
权限: financeia:read
输入: 无
查找获准访问的账户find_accounts读取 / 模拟
权限: financeia:read
输入: profile_id (必填), query, include_inactive, offset
查找类别find_categories读取 / 模拟
权限: financeia:read
输入: profile_id (必填), kind, query, offset
查找投资持仓find_holdings读取 / 模拟
权限: financeia:read
输入: profile_id (必填), query, offset
查找房产find_properties读取 / 模拟
权限: financeia:read
输入: profile_id (必填), query, offset
查找金融工具find_instruments读取 / 模拟
权限: financeia:read
输入: query (必填)
财务状况快照get_financial_snapshot读取 / 模拟
权限: financeia:read
输入: profile_id (必填), currency
按类别和期间汇总支出get_spending_summary读取 / 模拟
权限: financeia:read
输入: profile_id (必填), period_start (必填), period_end (必填), currency
现金流摘要get_cashflow_summary读取 / 模拟
权限: financeia:read
输入: profile_id (必填), months, currency
应急储备可支撑时长get_emergency_runway读取 / 模拟
权限: financeia:read
输入: profile_id (必填), currency
模拟购买而不记账simulate_purchase_impact读取 / 模拟
权限: financeia:read
输入: profile_id (必填), amount (必填), currency (必填)
搜索已记账交易search_transactions读取 / 模拟
权限: financeia:read
输入: profile_id (必填), period_start, period_end, text, category_id, account_id, limit, cursor
账户余额及摘要get_account_summary读取 / 模拟
权限: financeia:read
输入: profile_id (必填), offset, limit
投资持仓摘要get_holdings_summary读取 / 模拟
权限: financeia:read
输入: profile_id (必填), offset, limit
房产摘要get_property_summary读取 / 模拟
权限: financeia:read
输入: profile_id (必填), offset, limit
数据覆盖和质量get_data_completeness读取 / 模拟
权限: financeia:read
输入: profile_id (必填)
提议交易propose_transactions提交审核建议
权限: financeia:propose
输入: profile_id (必填), request_summary (必填), items (必填)
提议更正交易propose_correction提交审核建议
权限: financeia:propose
输入: profile_id (必填), request_summary (必填), correction (必填)
提议类别propose_category提交审核建议
权限: financeia:propose
输入: profile_id (必填), request_summary (必填), category (必填)
提议账户propose_account提交审核建议
权限: financeia:propose
输入: profile_id (必填), request_summary (必填), account (必填)
提议投资持仓propose_holding提交审核建议
权限: financeia:propose
输入: profile_id (必填), request_summary (必填), holding (必填)
提议房产propose_property提交审核建议
权限: financeia:propose
输入: profile_id (必填), request_summary (必填), property (必填)
提议账户显示顺序propose_account_order提交审核建议
权限: financeia:propose
输入: profile_id (必填), request_summary (必填), order (必填)
提案状态get_proposal_status读取 / 模拟
权限: financeia:read
输入: profile_id (必填), proposal_id (必填)
批次状态get_batch_status读取 / 模拟
权限: financeia:read
输入: profile_id (必填), batch_id (必填)
实体及其标识符find_entities读取 / 模拟
权限: financeia:read
输入: profile_id (必填), offset, limit, expected_version, query
已设置的类别预算list_budget_categories读取 / 模拟
权限: financeia:read
输入: profile_id (必填), offset, limit, expected_version, query
已保存的历史预算快照list_budget_snapshots读取 / 模拟
权限: financeia:read
输入: profile_id (必填), offset, limit, expected_version, query
计划及周期性事项list_planned_events读取 / 模拟
权限: financeia:read
输入: profile_id (必填), offset, limit, expected_version, query
储蓄目标和预留款项list_savings_goals读取 / 模拟
权限: financeia:read
输入: profile_id (必填), offset, limit, expected_version, query
债务计划和假设list_debt_plans读取 / 模拟
权限: financeia:read
输入: profile_id (必填), offset, limit, expected_version, query
已保存的录入模板list_entry_templates读取 / 模拟
权限: financeia:read
输入: profile_id (必填), offset, limit, expected_version, query
商户名称匹配规则list_merchant_aliases读取 / 模拟
权限: financeia:read
输入: profile_id (必填), offset, limit, expected_version, query
已设置的支出观察列表list_spending_watchlists读取 / 模拟
权限: financeia:read
输入: profile_id (必填), offset, limit, expected_version, query
已保存的报告定义list_saved_reports读取 / 模拟
权限: financeia:read
输入: profile_id (必填), offset, limit, expected_version, query
仅查看而不执行报告计划list_report_schedules读取 / 模拟
权限: financeia:read
输入: profile_id (必填), offset, limit, expected_version, query
可用功能get_capabilities读取 / 模拟
权限: financeia:read
输入: profile_id (必填)
档案时区和币种get_profile_context读取 / 模拟
权限: financeia:read
输入: profile_id (必填)
财务日历get_finance_calendar读取 / 模拟
权限: financeia:read
输入: profile_id (必填), period_start (必填), period_end (必填)
计划事项的发生日期get_planned_occurrences读取 / 模拟
权限: financeia:read
输入: profile_id (必填), period_start (必填), period_end (必填), series_id
实体表现get_entity_performance读取 / 模拟
权限: financeia:read
输入: profile_id (必填), period_start (必填), period_end (必填), currency, entity_code (必填)
预算周期回顾get_budget_period_review读取 / 模拟
权限: financeia:read
输入: profile_id (必填), period_start (必填), period_end (必填)
预算周期历史list_budget_period_history读取 / 模拟
权限: financeia:read
输入: profile_id (必填), offset, limit
交易详情get_transaction_detail读取 / 模拟
权限: financeia:read
输入: profile_id (必填), event_id (必填)
交易变更历史get_transaction_history读取 / 模拟
权限: financeia:read
输入: profile_id (必填), event_id (必填), cursor
交易分配get_transaction_allocations读取 / 模拟
权限: financeia:read
输入: profile_id (必填), event_id (必填)
已记账的账户余额历史get_account_balance_history读取 / 模拟
权限: financeia:read
输入: profile_id (必填), account_id (必填), months, through
持仓估值历史get_holding_valuation_history读取 / 模拟
权限: financeia:read
输入: profile_id (必填), holding_id (必填), offset, limit, expected_version
投资持仓详情get_holding_detail读取 / 模拟
权限: financeia:read
输入: profile_id (必填), holding_id (必填)
房产详情get_property_detail读取 / 模拟
权限: financeia:read
输入: profile_id (必填), property_id (必填)
房产估值历史get_property_valuation_history读取 / 模拟
权限: financeia:read
输入: profile_id (必填), property_id (必填), offset, limit, expected_version
待审核交易队列get_transaction_review_queue读取 / 模拟
权限: financeia:read
输入: profile_id (必填), query
支出观察进度get_spending_watchlist_progress读取 / 模拟
权限: financeia:read
输入: profile_id (必填)
通知偏好设置get_notification_preferences读取 / 模拟
权限: financeia:read
输入: profile_id (必填)
报告使用的汇率get_reporting_rates读取 / 模拟
权限: financeia:read
输入: profile_id (必填), currency
账簿中已保存的搜索get_saved_book_searches读取 / 模拟
权限: financeia:read
输入: profile_id (必填)
投资组合价值的依据get_portfolio_evidence读取 / 模拟
权限: financeia:read
输入: profile_id (必填), period_start (必填), period_end (必填), currency
结合上下文理解每个结果
保留期间、币种、观察日期、修订版本及数据质量元信息。按分页继续读取；交易搜索每页最多返回25条。版本变化时，应重新读取以保证一致。缺失值不等于零。已保存的预算快照是历史依据。助手的解释不属于专业财务建议。
帮助、恢复与访问控制
找不到自定义连接器选项
检查服务商套餐、地区、语言和工作区政策。可能需要团队所有者先添加；请参阅上方官方说明。
安全验证不可用
重新加载 Financeia 登录标签页，等待正常的 Cloudflare 检查完成。检查网络和内容拦截器。若持续失败，请向支持团队提供时间和错误信息，不要绕过验证。
助手看到错误档案或没有数据
请求 list_profiles。核对 Financeia 账号、所选档案、同步状态和数据完整性。授权过期时重新连接。
提案出现两次
先检查提案/批次状态和 AI 审核箱。查看重复警告并拒绝不需要的待审核建议，不要盲目重新发送。
断开连接或缩小权限
在 Financeia 设置 → 已连接的 AI 助手中撤销连接、移除共享档案或关闭 AI 连接。同时在服务商处移除/断开连接。今后的访问将停止，但已发送的信息不会被删除。
应该使用哪个环境？
本指南使用生产环境。测试环境具有独立账号和访问控制。不要误将私人记录分享给测试连接。