costclocker mcp
MCP服务器 Costlocker --您的项目管理和时间跟踪工具。将您的AI助手连接到Costlocker，并通过自然语言处理项目、预算、时间表等。
快速启动
1.从Costlocker获取您的API代币
只有帐户 所有者 可以创建API令牌。请参阅 带截图的分步指南.
- 登录 Costlocker
- 点击您的 名字 在右上角，选择 设置
- 去 API 选项卡（或直接转到 new.costlocker.com/settings/api)
- 复制您的 个人访问令牌 （点击“复制到剪贴板”或“再生令牌”，如果你还没有一个）
2.配置您的MCP客户端
添加 costlocker 服务器到MCP客户端配置。桌面应用程序示例：
- macOS配置：
~/Library/Application Support/Claude/claude_desktop_config.json - Windows配置：
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"costlocker": {
"command": "npx",
"args": ["-y", "costlocker-mcp"],
"env": {
"COSTLOCKER_API_TOKEN": "your-api-token"
}
}
}
}替换 your-api-token 使用步骤1中的令牌。
3.重新启动MCP客户端
就是这样。你的人工智能助理现在可以访问你的Costlocker数据。试着问：
- *“显示所有正在运行的项目”*
- *“我这周记录了多少小时？”*
- *“项目X的预算状况如何？”*
它能做什么？
| 类别 | 工具 | 描述 |
|---|---|---|
| 项目 | list_projects, get_project, search_projects | 浏览和搜索项目 |
create_project, update_project | 创建或更新项目（确认） | |
| 时间表 | log_time | 记录时间条目（带确认） |
get_timesheet, get_monthly_timesheet | 查看时间表数据 | |
get_running_entry, get_assignments | 检查运行计时器和可用分配 | |
| 人们 | list_people, get_me, get_project_people | 查看团队成员和任务 |
| 金融 | get_project_budget, get_project_billing, get_project_expenses | 查看预算、账单和费用 |
| 查找 | list_clients, list_activities, list_tags, list_groups | 浏览参考数据 |
所有工具名称前面都有前缀 costlocker_ （例如。 costlocker_list_projects).
安全
- 写入操作 (
create_project,update_project,log_time)需要用户确认——人工智能在做出更改之前总是会询问 - 输入验证 所有写操作（Zod模式）
- 访问控制 由您的个人API令牌处理-您只能看到Costlocker角色允许的数据
- 凭证检查 通过启动
/me端点--无效令牌立即失败 - 错误清理 -API错误响应被截断以防止敏感数据泄漏
配置
| 环境变量 | 必填 | 说明 |
|---|---|---|
COSTLOCKER_API_TOKEN | 是 | Costlocker API设置中的个人访问令牌 |
COSTLOCKER_HOST | 没有 | API主机（默认值： https://rest.costlocker.com) |
许可证
麻省理工学院