Tripletex MCP Server

Tripletex MCP服务器

一 MCP（模型上下文协议） 服务器 Tripletex 会计API。使AI助手能够通过自然语言记录小时数、管理时间表和处理发票。

特性

• 时间跟踪 --记录小时数、启动/停止计时器、搜索条目
• 项目和活动 --按名称查找项目和活动
• 时间表审批 --完成、批准并重新打开每周/每月时间表
• 发票 --搜索传出和传入发票
• 供应商发票审批 --批准或拒绝供应商发票

设置

1.获取您的Tripletex API代币

您需要Tripletex的两个代币：

• 消费者代币 --提供之后 API 2.0注册
• 员工令牌 -由Tripletex中的管理员在用户设置>“API访问”下创建

服务器在首次使用时自动创建会话令牌（有效期为1天）。

2.配置您的MCP客户端

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tripletex": {
      "command": "npx",
      "args": ["-y", "tripletex-mcp"],
      "env": {
        "TRIPLETEX_CONSUMER_TOKEN": "",
        "TRIPLETEX_EMPLOYEE_TOKEN": ""
      }
    }
  }
}

或者直接从GitHub安装：

{
  "mcpServers": {
    "tripletex": {
      "command": "npx",
      "args": ["-y", "github:adriantr/tripletex-mcp"],
      "env": {
        "TRIPLETEX_CONSUMER_TOKEN": "",
        "TRIPLETEX_EMPLOYEE_TOKEN": ""
      }
    }
  }
}

环境变量

工具

认证

• whoami --获取当前已验证用户的信息

项目与活动

• search_projects --按名称或其他筛选器搜索项目
• search_activities --搜索活动（如开发、会议、度假）

时间追踪

• search_timesheet_entries --在时间表条目中搜索日期范围
• get_timesheet_entry --按ID获取单个时间表条目
• create_timesheet_entry --记录项目/活动/日期的小时数
• update_timesheet_entry --更新现有时间表条目
• delete_timesheet_entry --删除时间表条目
• get_total_hours --获取日期范围的总小时数
• get_recent_projects --获取最近使用的项目
• get_recent_activities --获取项目最近使用的活动

时间时钟

• start_time_clock --启动实时计时器
• stop_time_clock --停止正在运行的计时器
• get_current_time_clock --获取当前正在运行的计时器

时间表审批

• search_timesheet_weeks --搜索每周时间表状态
• approve_timesheet_week --批准时间表周
• complete_timesheet_week --标记一周为完成
• reopen_timesheet_week --重新开启已完成/已批准的一周
• get_timesheet_month --获取月度时间表状态
• approve_timesheet_month --批准时间表月份
• complete_timesheet_month --标记一个月为完成
• reopen_timesheet_month --重新打开已完成/已批准的月份

发票

• search_invoices --搜索传出（客户）发票
• get_invoice --按ID获取单个出库发票
• search_supplier_invoices --搜索收到的（供应商）发票
• get_supplier_invoice --按ID获取单个供应商发票
• get_supplier_invoices_for_approval --获取待批准的发票
• approve_supplier_invoice --批准供应商发票
• approve_supplier_invoices --批准多个供应商发票
• reject_supplier_invoice --拒绝供应商发票（需要评论）
• reject_supplier_invoices --拒绝多张供应商发票（需要评论）

发展

npm install
npm run build

许可证

ISC