Milkee MCP

MILKEE MCP服务器

让Claude AI直接访问您的 牛奶 瑞士会计软件。

德语指南 / German Guide

什么是牛奶？

牛奶 是面向自由职业者和小型企业的瑞士会计软件：

• 开具发票 -二维码发票（瑞士二维码标准）
• 提案 -转换为发票的报价
• 簿记 -复式记账法，增值税
• 时间跟踪 -小时数、计时器、计费跟踪
• 客户 -联系人和账单管理

这是什么MCP服务器？

此MCP服务器将Claude连接到您的MILKEE帐户，让您可以自然地询问有关业务财务的问题、创建发票、管理提案等。

使用 克劳德桌面版 和 克劳德代码（CLI）.

______________________________________________________________________

牛奶 | API文件 | MCP协议 | 更新日志 | 建立日记

免责声明

独立的社区项目，不是MILKEE GmbH的官方产品。按“原样”提供，不提供任何保证。使用风险自负。

披露

作者(托马斯·温特)担任MILKEE GmbH的顾问。

许可证

麻省理工学院

______________________________________________________________________

目录

• 你能做什么
• 报告类型
• 示例提示
• 所有工具
• 设置
• 参考

______________________________________________________________________

你能做什么

______________________________________________________________________

报告类型

Claude根据您的提问方式生成不同级别的报告：

快速摘要

提示： “我的生意怎么样？”

使用单个API调用进行快速概述：

• 收入、支出、净利润、利润率
• 银行存款余额
• 按状态统计发票数量
• 未清应收账款

Financial Health
┌────────────────┬───────────────┐
│ Total Income   │ CHF 52'275.75 │
│ Total Expenses │ CHF 19'793.32 │
│ Net Profit     │ CHF 32'482.43 │
│ Profit Margin  │ 62.1%         │
│ Bank Balance   │ CHF 12'136.35 │
└────────────────┴───────────────┘

深度财务评估

提示： “给我一份完整的财务评估”

使用多个API调用进行全面分析。以上所有内容加：

• 月度收入趋势
• 按收入排名的前10位客户
• 按类别分列的费用明细
• 资产负债表摘要
• 客户集中度分析
• 季节性洞察

Monthly Revenue Trend
┌──────────┬──────────┐
│ Dec 2025 │ 9'053.25 │
│ Nov 2025 │ 2'602.70 │
│ Oct 2025 │ 1'804.00 │
│ ...      │ ...      │
└──────────┴──────────┘

Top Customers by Revenue
┌─────────────────┬───────────────┐
│ Migros          │ CHF 9'236.00  │
│ Veloblitz       │ CHF 6'856.70  │
│ Bridge AG       │ CHF 3'853.00  │
└─────────────────┴───────────────┘

发票和建议书报告

提示： “显示我的发票”、“列出待处理的提案”、“什么逾期了？”

客户分析

提示： “显示\[客户名称\]的统计数据”

______________________________________________________________________

示例提示

业务概述

开具发票

提案

分析

______________________________________________________________________

所有工具

Click to expand (71 tools)

公司

• milkee_get_company_summary -您的业务概述

发票

• milkee_list_invoices -带过滤的列表
• milkee_get_invoice -详细信息
• milkee_create_invoice -新建
• milkee_update_invoice -修改
• milkee_delete_invoice -删除草稿
• milkee_mark_invoice_paid -马克支付
• milkee_send_invoice -通过电子邮件发送

提案

• milkee_list_proposals -列出报价
• milkee_get_proposal -详细信息
• milkee_create_proposal -新建
• milkee_update_proposal -修改
• milkee_delete_proposal -删除
• milkee_convert_proposal_to_invoice -转换
• milkee_send_proposal -通过电子邮件发送

客户

• milkee_list_customers -带过滤的列表
• milkee_get_customer -详细信息
• milkee_create_customer -新建
• milkee_update_customer -修改
• milkee_delete_customer -删除
• milkee_get_customer_statistics -财务统计

簿记

• milkee_list_entries -分类账条目
• milkee_get_entry -参赛详情
• milkee_create_entry -创建条目
• milkee_update_entry -修改
• milkee_delete_entry -删除
• milkee_get_next_entry_number -下一个号码
• milkee_bulk_delete_entries -批量删除

项目

• milkee_list_projects, milkee_get_project, milkee_create_project, milkee_update_project, milkee_delete_project, milkee_bulk_archive_projects

任务

• milkee_list_tasks, milkee_get_task, milkee_create_task, milkee_update_task, milkee_delete_task

时间跟踪

• milkee_list_times, milkee_get_time, milkee_create_time, milkee_update_time, milkee_delete_time
• milkee_get_timer, milkee_start_timer, milkee_stop_timer, milkee_update_timer_description, milkee_discard_timer

产品

• milkee_list_products, milkee_get_product, milkee_create_product, milkee_update_product, milkee_delete_product

账户

• milkee_list_accounts, milkee_get_account, milkee_create_account, milkee_update_account, milkee_delete_account

标签

• milkee_list_tags, milkee_get_tag, milkee_create_tag, milkee_update_tag, milkee_delete_tag, milkee_get_tag_colors

税率

• milkee_list_tax_rates, milkee_get_tax_rate

联系人

• milkee_list_contacts, milkee_create_contact, milkee_update_contact, milkee_delete_contact

______________________________________________________________________

设置

获取您的凭据

1. 登录到 牛奶
2. 首选 设置>API
3. 生成新的API令牌
4. 记下你的 公司编号 从URL（例如。， app.milkee.ch/companies/1234/... → ID is 1234)

克劳德桌面版

配置文件位置：

• 窗户： %APPDATA%\Claude\claude_desktop_config.json
• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

完全访问权限：

{
  "mcpServers": {
    "milkee": {
      "command": "npx",
      "args": ["-y", "milkee-mcp@latest"],
      "env": {
        "MILKEE_API_TOKEN": "your-api-token-here",
        "MILKEE_COMPANY_ID": "your-company-id-here"
      }
    }
  }
}

只读 （仅用于分析-不创建/更新/删除）：

{
  "mcpServers": {
    "milkee": {
      "command": "npx",
      "args": ["-y", "milkee-mcp@latest"],
      "env": {
        "MILKEE_API_TOKEN": "your-api-token-here",
        "MILKEE_COMPANY_ID": "your-company-id-here",
        "MILKEE_READ_ONLY": "true"
      }
    }
  }
}

保存后重新启动Claude Desktop。测试：“列出我的MILKEE发票”

克劳德代码（CLI）

完全访问权限：

claude mcp add milkee -e MILKEE_API_TOKEN=your-token -e MILKEE_COMPANY_ID=your-id -- npx -y milkee-mcp@latest

只读：

claude mcp add milkee -e MILKEE_API_TOKEN=your-token -e MILKEE_COMPANY_ID=your-id -e MILKEE_READ_ONLY=true -- npx -y milkee-mcp@latest

______________________________________________________________________

参考

了解您的数据

• “怎么样 我的事业 做什么？" → 贵公司的财务状况
• “显示 客户 Acme的统计数据”→您开具发票的人的统计数据

安全

• API令牌留在您的计算机上
• MCP在本地运行-凭证仅发送到MILKEE的API
• 使用 只读模式 用于安全分析

故障排除

发展

git clone https://github.com/thwinter-ch/milkee-mcp.git
cd milkee-mcp
npm install
npm run build

本地测试：

MILKEE_API_TOKEN=xxx MILKEE_COMPANY_ID=123 node dist/index.js

将Claude Desktop指向本地构建：

{
  "mcpServers": {
    "milkee": {
      "command": "node",
      "args": ["/path/to/milkee-mcp/dist/index.js"],
      "env": {
        "MILKEE_API_TOKEN": "your-token",
        "MILKEE_COMPANY_ID": "your-id"
      }
    }
  }
}