網頁應用程式
開啟虛擬頭像 → 設定 → 已連線的 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 連線。同時在服務商端移除/中斷連線。後續存取將停止，但已傳送資訊不會刪除。
應使用哪個環境？
本指南使用正式環境。測試環境有獨立帳號與存取控制。不要誤將私人紀錄分享給測試連線。