Finta MCP Server

什么是 Finta MCP Server？

Finta MCP Server 是 Finta 的托管 MCP 端点，让 Claude、ChatGPT、Codex 等 AI 工具读取和更新你初创公司的账簿，覆盖损益报表、交易、规则和税务申报等内容。

Finta 是面向美国初创公司的会计与税务软件，涵盖记账、报税和财务报告。位于 https://mcp.finta.com/mcp 的 MCP 服务器使用你的 Finta 登录，因此无需管理 API key，而且助手只能执行你在 Finta 中的角色所允许的操作。

如何使用 Finta MCP Server？

你需要一个 Finta 账户。所有客户端的登录方式都一样：在浏览器中登录 Finta，选择公司，然后点击 Allow access。Finta 支持带 Client ID Metadata Documents 和 Dynamic Client Registration 的 OAuth，因此无需事先注册任何东西。

服务器 URL：

https://mcp.finta.com/mcp

在 Finta 的 Settings > MCP 中，还有一段提示词可以粘贴到 Claude Code、Codex 或 Cursor 中，让它们替你完成连接设置。

Claude Desktop 与 claude.ai

1. 在 Claude 桌面应用或 claude.ai 中打开 Customize > Connectors。
2. 点击 + Add，然后选择 Add custom connector。
3. 名称填 Finta，URL 填 https://mcp.finta.com/mcp。
4. 点击 Continue，保留默认登录设置，再点击 Add 并登录。

在 Team 或 Enterprise 套餐中，需要先由 Owner 在 Organization settings > Connectors 中添加 Finta，成员再在 Customize > Connectors 中点击 Finta 的 Connect。

Claude Code

Finta 文档给出的命令：

claude mcp add --transport http --scope user finta https://mcp.finta.com/mcp

然后运行 /mcp，选择 finta，再选择 Authenticate。

Codex

需要 Codex 0.147.0 或更高版本：

codex mcp add finta --url https://mcp.finta.com/mcp

Codex 会在浏览器中打开 Finta 供你登录。之后如需重新登录，运行 codex mcp login finta。

Cursor

将服务器添加到 ~/.cursor/mcp.json 或项目的 .cursor/mcp.json：

{
  "mcpServers": {
    "finta": {
      "url": "https://mcp.finta.com/mcp"
    }
  }
}

VS Code

将服务器添加到 .vscode/mcp.json：

{
  "servers": {
    "finta": {
      "type": "http",
      "url": "https://mcp.finta.com/mcp"
    }
  }
}

对于其他客户端，将该 URL 添加为远程 Streamable HTTP 服务器，并请求 finta:read 和 finta:write 两个 scope。没有 finta:write 时，会修改数据的工具不可用。

Finta MCP Server 的主要功能

• 报表：按类别的利润表、按部门的 GAAP 损益表、资产负债表和现金流量表。还可以获取某个类别的合计、对其商户排名或按月拆分，并将报表导出为 PDF、CSV 或 XLSX。
• 交易：搜索、获取和编辑交易，一次批量编辑最多 5,000 笔，上传银行或信用卡导出文件，并对自有账户之间的转账进行匹配或取消匹配。
• 日记账分录：搜索报表背后的借贷记录。
• 账户、卡片和规则：列出银行和卡账户以及企业卡，创建用于上传的手动账户，列出、创建、更新或删除自动化规则。
• 公司与团队：获取公司详情、类别、部门、商户和集成，查看团队成员，邀请成员或管理待处理的邀请。
• 税务：搜索所得税和特拉华州特许经营税申报、R&D 抵免和供应商 1099 记录，并上传在 Finta 之外提交的申报表。
• 基于角色的访问：助手只能执行你在 Finta 中的角色所允许的操作。

Finta MCP Server 的使用场景

• 董事会和投资人汇报准备：“显示上季度按部门分组的 GAAP 损益表”，然后“把上季度的利润表导出为 PDF”。
• 支出分析：“今年按支出排名前 10 的供应商是哪些？”或“显示从一月起每月的 AWS 支出。”
• 账簿整理：“把所有 Gusto 交易重新归类为 Payroll”以及“创建一条把 Cursor 费用归类为 Software 的规则。”
• 导入对账单和匹配转账：“把这份 Chase 对账单上传到 Finta”以及“匹配从支票账户转到储蓄账户的 25,000 美元转账。”
• 税务状态检查：“我们提交 2025 年的税了吗？”或“哪些 2025 年的 1099 记录还缺 W-9？”
• 团队管理：“邀请 sam@example.com 以管理员身份加入 Finta。”

Finta MCP Server 常见问题排查

• 缺少写入工具：客户端没有请求 finta:write scope。请重新连接，并同时授予 finta:read 和 finta:write。
• Codex 无法连接：Finta 需要 Codex 0.147.0 或更高版本。如需重新登录，运行 codex mcp login finta。
• 工具调用被拒绝：助手只能执行你的 Finta 角色允许的操作，请让管理员调整你的权限。
• 月底调用失效：你的公司可能已用完每月的工具调用额度，额度会在每月 1 日重置。