freeagent-mcp-vercel
一个连接AI与FreeAgent会计系统的MCP服务器，实现智能财务管理。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：freeagent-mcp-vercel。 它的用途是：一个连接AI与FreeAgent会计系统的MCP服务器，实现智能财务管理。 完整的 Skill 内容见：https://321skill.com/skills/freeagent-mcp-vercel/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请为客户‘ABC公司’创建一张金额为500英镑的发票，项目是网站设计服务。”，它会通过此Skill调用FreeAgent API，自动查找联系人并生成草稿发票。或者说：“帮我核对一下上个月银行流水里标记为‘办公用品’的所有交易。”，AI会使用`reconcile_bank_transaction`工具进行智能对账。
介绍
FreeAgent MCP Server 是一个基于Model Context Protocol (MCP)的服务器，它充当了大型语言模型（LLM）与FreeAgent在线会计软件API之间的桥梁。它解决了AI无法直接操作专业商业软件进行数据查询和业务处理的问题，让AI助手能够帮助用户管理联系人、发票、账单、费用、项目等核心财务数据。
使用方式有两种：对于个人用户，可以将其作为本地MCP服务器集成到Claude Desktop等客户端中；对于团队或需要云端访问的场景，可以将其部署到Vercel等无服务器平台，通过HTTP流进行调用。部署后，AI助手即可获得一系列以FreeAgent数据为上下文的工具能力。
该工具非常适合需要频繁处理财务数据但又希望借助AI提升效率的团队或个人，例如中小企业的财务人员、自由职业者或项目经理。它能够将自然语言指令转化为具体的会计操作，简化了繁琐的数据录入和查询流程。
使用前需要注意，你需要拥有FreeAgent的账户并获取相应的API访问凭证（访问令牌或OAuth客户端信息）。此外，建议先在FreeAgent的沙盒环境中进行测试，以确保操作的安全性和准确性。对于云端部署，需妥善配置OAuth回调地址等环境变量。
核心特点
1. 提供“意图捆绑工具”，如`reconcile_bank_transaction`，能将多步操作合并为单次工具调用，并自动解析人名、代码等友好提示为系统内部URL，大幅简化AI调用逻辑。2. 支持可选的“工具搜索模式”，通过两个元工具动态加载所需工具定义，有效优化了连接多个MCP服务器时的Token消耗。
注意事项
不适合没有FreeAgent账户或不需要进行会计相关操作的用户。
常见问题
如何获取FreeAgent的API访问令牌？
需要登录FreeAgent账户，在开发者设置中创建个人访问令牌或注册OAuth应用获取Client ID和Secret。
支持FreeAgent的沙盒环境吗？
支持，通过设置环境变量`FREEAGENT_USE_SANDBOX=true`即可连接到测试沙盒，安全进行实验。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/freeagent-mcp-vercel/raw/index.md 读取 freeagent-mcp-vercel 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/freeagent-mcp-vercel/raw/index.md（查看排版版本）