Freee Chat MCP Server

freee聊天mcp服务器💸

freee会计API的Claude Desktop容易MCP服务器。经费登记、交易管理、帐票确认等Claude中描述的相应参数的值。

主要功能

智能经费登记

• create_smart_expense：自动选择适当的帐户和税分类，只需指定费用类型
• 軽减税率（食品8%）と标准税率（10%）に自动对应
• 支持收据图像上传：收据、收据的图像Claude Desktop上传到的话，读取图像的内容自动注册经费
• 可以从图像中自动提取金额、店铺名、购买内容，作为经费数据使用

会社管理

• 建议_公司：有多家公司时的自动选择、提案
• 列表_公司：获取所有可访问的地点列表

経费管理

• 建议_共同_费用：经常使用的经费科目的提案（交际费、旅费交通费、消耗品费等）
• get_cent_deals：查看最近的事务处理列表
• delete_deal：删除错误注册的事务处理

取引・帐票

• create_deal：创建事务处理（收入/支出）
• list_deals：检索事务处理列表（可按期间、种类进行筛选）
• list_计数_项目: 勘定科目一覧
• list_partners: 取引先一覧
• list_taxs: 税区分一覧

需要的东西

• Claude桌面版
• freee会计帐户
• freee的访问标记（freee开发人员获得）
• Node.js 18以上

安装方法

1.克隆存储库

git clone https://github.com/YOUR_USERNAME/freee-mcp-server.git
cd freee-mcp-server

2.安装依赖关系

npm install

3.构建

npm run build

4. freee获取访问令牌

1. freee开发人员访问
2. 创建应用程序
3. 获取访问令牌

5. Claude Desktop配置

Claude Desktop打开配置文件：

macOS：

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

窗户：

%APPDATA%\Claude\claude_desktop_config.json

在配置文件中添加：

{
  "mcpServers": {
    "freee": {
      "command": "node",
      "args": ["/path/to/freee-mcp-server/dist/index.js"],
      "env": {
        "FREEE_ACCESS_TOKEN": "your_freee_access_token_here"
      }
    }
  }
}

注意: /path/to/freee-mcp-server请用实际项目路径替换。

6. Claude Desktop重新启动

为了反映设定Claude Desktop中所述修改相应参数的值。

使用例

从收据图像的经费登记

1. Claude Desktopにレシート・領収書の画像をアップロード
2. 「この画像から経費登録して」と依頼
3. Claudeが画像を解析して金額、店舗名、内容を抽出
4. create_smart_expense で自動で適切な勘定科目・税区分を選択して登録

智能经费登记

食材の買い物を経費登録したい

create_smart_expense を使用:
- company_id: 12345
- amount: 1500
- description: "スーパーマーケット - 野菜、肉類"
- expense_type: "food"
- transaction_date: "2024-01-15"

→ 自動で「消耗品費」+ 軽減税率8%で登録

修改错误的注册

1. get_recent_deals で最近の取引を確認
2. delete_deal で間違った取引を削除
3. 正しい内容で再登録

自动选择公司

suggest_company を実行
→ 複数会社がある場合は選択肢を表示
→ 単一会社の場合は自動選択

配置选项

环境变数

费用类型

｜类型｜说明｜自动选择的帐户｜税分类｜ |------|------|-------------------|---------| | food |食品・饮食物|消耗品费|軽减税率8% | | office_supplies |事务用品|消耗品费・事务用品费|标准税率10% | | transportation |交通费|旅费交通费|标准税率10% | | utilities |光热费|水道光热费|标准税率10% | | rent |地代家赁|地代家赁|标准税率10% | | entertainment |接待・会议|交际费・会议费|标准税率10% | | other ｜其他｜杂费・消耗品费｜标准税率10%｜

质问（FAQ）

Q1: 「401 Unauthorized」出现错误

A. 访问令牌问题：

• freee developers重新提交标记
• Claude Desktop在配置文件中更新标记
• 确认令牌的权限（经费申请、交易管理）是否有效

Q2: 把经费登记错了

A. 请使用删除功能：

1. get_recent_deals确认最近的交易
2. 想要删除的交易的ID确认
3. delete_deal删除相应的事务处理

Q3: 未自动确定减轻税率和标准税率

A. expense_type请正确指定：

• 食品・饮食物→ "food" （軽减税率8%）
• 其他消耗品→ "office_supplies" （标准税率10%）
• 如果要手动指定帐户create_deal使用

分发

错误报告和功能要求问题请通知我。

也欢迎拉要求！

许可证

MIT许可证

相关链接

• freee API仕样书
• Claude桌面版
• MCP（模型上下文协议）