会计API协议服务器

Tripletex MCP服务器是一个用于Tripletex会计API的模型上下文协议服务器,支持通过自然语言管理工时、时间表和发票。

  • by adriantr
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 adriantr/tripletex-mcp

使用说明

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": "<your-consumer-token>",
        "TRIPLETEX_EMPLOYEE_TOKEN": "<your-employee-token>"
      }
    }
  }
}

或者直接从GitHub安装:

{
  "mcpServers": {
    "tripletex": {
      "command": "npx",
      "args": ["-y", "github:adriantr/tripletex-mcp"],
      "env": {
        "TRIPLETEX_CONSUMER_TOKEN": "<your-consumer-token>",
        "TRIPLETEX_EMPLOYEE_TOKEN": "<your-employee-token>"
      }
    }
  }
}

环境变量

变量 必填 描述
TRIPLETEX_CONSUMER_TOKEN 是 API消费者代币
TRIPLETEX_EMPLOYEE_TOKEN 是 员工令牌
TRIPLETEX_COMPANY_ID 否 公司ID(默认值: 0 =自己的公司)
TRIPLETEX_API_URL 没有 API基本URL(默认值: https://tripletex.no/v2)

工具

认证

  • 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