使用说明
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: 税区分一覧
需要的东西
安装方法
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获取访问令牌
- freee开发人员访问
- 创建应用程序
- 获取访问令牌
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 を実行
→ 複数会社がある場合は選択肢を表示
→ 単一会社の場合は自動選択
配置选项
环境变数
| 变数名 | 说明 | 必须 |
|---|---|---|
FREEE_ACCESS_TOKEN |
freee API访问令牌｜是｜ |
费用类型
｜类型｜说明｜自动选择的帐户｜税分类｜
|------|------|-------------------|---------|
| 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. 请使用删除功能：
get_recent_deals确认最近的交易- 想要删除的交易的ID确认
delete_deal删除相应的事务处理
Q3: 未自动确定减轻税率和标准税率
A. expense_type请正确指定：
- 食品・饮食物→
"food"（軽减税率8%） - 其他消耗品→
"office_supplies"（标准税率10%） - 如果要手动指定帐户
create_deal使用
分发
错误报告和功能要求问题请通知我。
也欢迎拉要求！
许可证
MIT许可证
