Artesa MCP by usefulapi

usefulapi 的 Artesa MCP

在 Claude、Cursor 或任何 MCP 客户端中使用你的 Artesa 账户。读取客户、任务、员工、工时记录和缺勤信息，并创建客户。托管服务，无需本地安装：使用你自己的凭据连接。

实时端点： https://artesa.usefulapi.io/mcp · 主页： https://usefulapi.io

连接

• Claude（claude.ai、桌面版）：打开 Customize → Connectors，点击 + Add → Add custom connector，然后粘贴 https://artesa.usefulapi.io/mcp。
• Claude Code： claude mcp add --transport http artesa https://artesa.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code： 添加到 VS Code。
• Cursor 和其他客户端： 将该 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "artesa": {
      "url": "https://artesa.usefulapi.io/mcp"
    }
  }
}

只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求你提供 Artesa 凭据。

分步设置说明、凭据查找方法和常见问题：https://usefulapi.io/artesa/

首次连接时，你需要提供 Artesa API 密钥（Artesa → Settings；需要管理员账户）。服务会验证密钥并按用户保存。配置文件中无需填写密钥。

工具

工具	类型	功能
artesa_list_customers	读取	列出客户
artesa_get_customer	读取	获取客户信息
artesa_create_customer	写入	创建客户
artesa_list_assignments	读取	列出任务
artesa_get_assignment	读取	获取任务信息
artesa_list_assignment_events	读取	列出任务事件
artesa_get_assignment_event	读取	获取任务事件
artesa_list_projects	读取	列出项目
artesa_get_project	读取	获取项目信息
artesa_list_users	读取	列出用户
artesa_get_user	读取	获取用户信息
artesa_list_time_entries	读取	列出工时记录
artesa_list_user_absences	读取	列出用户缺勤记录
artesa_list_time_sheet_weeks	读取	列出工时表周记录
artesa_list_assignment_status_types	读取	列出任务状态类型
artesa_list_assignment_types	读取	列出任务类型
artesa_list_gangs	读取	列出班组
artesa_list_roles	读取	列出角色
artesa_usage_status	元信息	使用情况（免费套餐用量计数）
artesa_request_feature	元信息	申请添加缺失功能
artesa_upgrade	元信息	升级到 Pro（不限量*）
artesa_cancel_subscription	元信息	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应在执行前征求确认）；meta 工具用于报告使用情况、管理订阅或发送功能申请。

定价

套餐	价格	限额
免费	$0	每月 50 次工具调用
Pro（每位用户）	$9/月 或 $90/年（免费 2 个月）	不限量*

*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多，请发送邮件至 [email protected]。

Pro 仅适用于此服务。使用 artesa_upgrade 订阅（它会返回 Stripe Checkout 链接）。你可以随时使用 artesa_cancel_subscription 取消：Pro 会持续到已付费周期结束，当前周期不予退款；在此之前运行 artesa_upgrade 可以撤销取消操作。也可以发送邮件至 [email protected]。

许可证

MIT — 参见 LICENSE。仅提供文档；服务由托管方运行。