Artesa MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.3.4更新于 Nov 7, 2026

Read customers, assignments, staff, time entries and absences; create customers in Artesa.

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行效率与工作流商业与电商

概览

AI 生成的概览

托管型 MCP 服务器,让助手读取 Artesa 的客户、任务单、项目、员工、工时与缺勤记录,并可创建客户。

可以做什么
  • 列出并获取客户,含电话、邮箱与账单地址
  • 列出并获取任务单(订单/工单)及其工作步骤或事件
  • 列出并获取项目、员工用户、班组与角色
  • 列出工时记录、员工缺勤与每周工时表
  • 列出任务单状态类型与任务单类型
  • 创建新客户记录;查看用量、提交功能请求、升级或取消订阅
适用场景
当公司使用 Artesa 管理外勤服务或工单排程,并希望助手回答下周排班、某客户的未完成任务单、员工缺勤或已记录工时等问题,或在不打开应用的情况下新增客户时适用。
运行要求
通过 streamable HTTP 连接的远程端点,无需本地安装。使用 OAuth 登录,首次连接时需提供 Artesa 设置中的 API 密钥,且需要管理员账号;服务器按用户保存该密钥。免费方案每月 50 次工具调用,付费方案按用户计费。
安装前请注意
Artesa API 密钥属于凭据,只应通过 OAuth 登录页提供,不要写入客户端配置。创建客户工具会写入数据且不可安全重试,重试会产生重复客户。升级工具会返回付款链接并开通付费订阅;取消当期不退款。用量按方案计量并受限。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Artesa MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fartesa/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "artesa-by-usefulapi": {
      "type": "http",
      "url": "https://artesa.usefulapi.io/mcp"
    }
  }
}

README

Artesa MCP by usefulapi

Use your Artesa account from Claude, Cursor, or any MCP client. Read customers, assignments, staff, time entries and absences, and create customers. Hosted, no local install: connect with your own credentials.

Live endpoint: https://artesa.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://artesa.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http artesa https://artesa.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "artesa": {      "url": "https://artesa.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Artesa credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/artesa/

On first connect you provide an Artesa API key (Artesa → Settings; an admin account is needed). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
artesa_list_customersreadList customers
artesa_get_customerreadGet a customer
artesa_create_customerwriteCreate a customer
artesa_list_assignmentsreadList assignments
artesa_get_assignmentreadGet an assignment
artesa_list_assignment_eventsreadList assignment events
artesa_get_assignment_eventreadGet an assignment event
artesa_list_projectsreadList projects
artesa_get_projectreadGet a project
artesa_list_usersreadList users
artesa_get_userreadGet a user
artesa_list_time_entriesreadList time entries
artesa_list_user_absencesreadList user absences
artesa_list_time_sheet_weeksreadList time sheet weeks
artesa_list_assignment_status_typesreadList assignment status types
artesa_list_assignment_typesreadList assignment types
artesa_list_gangsreadList gangs
artesa_list_rolesreadList roles
artesa_usage_statusmetaUsage status (free-tier meter)
artesa_request_featuremetaRequest a missing feature
artesa_upgrademetaUpgrade to Pro or Pro+
artesa_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with artesa_upgrade (it returns a Stripe Checkout link). Cancel any time with artesa_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running artesa_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

来源:servers/artesa/README.md,提交 4046075

工具

18

artesa_list_customers

List customers

List customers (private persons or companies that assignments are carried out for). Filter by company name, number or external id. Artesa API: GET /v2/customers.

输入参数pagesizenumberexternal_idcompany_name

artesa_get_customer

Get a customer

Get one customer with its phones, emails, URLs and billing address. Artesa API: GET /v2/customers/{customerUuid}.

输入参数customer_uuid必填

artesa_create_customer

Create a customer

Create a new customer record (company or private person). Not safe to retry: a retry creates a second customer. Artesa API: POST /v2/customers.

输入参数emailssurnamefirst_nametelephonesexternal_idcompany_name

artesa_list_assignments

List assignments

List assignments (orders/jobs) with their customer, project, type, responsible user and status. Artesa API: GET /v2/assignments.

输入参数namepagesizenumbertype_uuidexternal_idstatus_uuidproject_uuidcustomer_uuidresponsible_user_uuid

artesa_get_assignment

Get an assignment

Get one assignment with its details. Artesa API: GET /v2/assignments/{assignmentUuid}.

输入参数assignment_uuid必填

artesa_list_assignment_events

List assignment events

List work steps (appointments and events) of assignments, optionally in a time window. Artesa API: GET /v2/assignment-events.

输入参数namepagesizestarts_totype_uuidgroup_uuidstarts_fromassignment_uuid

artesa_get_assignment_event

Get an assignment event

Get one assignment event (work step). Artesa API: GET /v2/assignment-events/{assignmentEventUuid}.

输入参数assignment_event_uuid必填

artesa_list_projects

List projects

List projects that group assignments. Artesa API: GET /v2/projects.

输入参数pagesizenumberexternal_id

artesa_get_project

Get a project

Get one project. Artesa API: GET /v2/projects/{projectUuid}.

输入参数project_uuid必填

artesa_list_users

List users

List users (staff members) with their role. Filter by name, email or role. Artesa API: GET /v2/users.

输入参数pagesizeemailfull_namerole_uuidshort_nameexternal_idstaff_number

artesa_get_user

Get a user

Get one user (staff member). Artesa API: GET /v2/users/{userUuid}.

输入参数user_uuid必填

artesa_list_time_entries

List time entries

List recorded time entries (work time) per user, assignment or event, optionally in a time window. Artesa API: GET /v2/time-entries.

输入参数pagesizestarts_totype_uuiduser_uuidday_statusevent_uuidexternal_idstarts_fromassignment_uuid

artesa_list_user_absences

List user absences

List absences (holidays, sick days and similar) of users in a time window. Artesa API: GET /v2/user-absences.

输入参数pagesizestatusstarts_totype_uuiduser_uuidstarts_from

artesa_list_time_sheet_weeks

List time sheet weeks

List weekly time sheets per user, with their status. Artesa API: GET /v2/time-sheet-weeks.

输入参数pagesizestatususer_uuidweek_start

artesa_list_assignment_status_types

List assignment status types

List the assignment status types (Auftragsstatus) your company uses. Artesa API: GET /v2/assignment-status-types.

输入参数namepagesizecategory

artesa_list_assignment_types

List assignment types

List the assignment types (Auftragstypen) your company uses. Artesa API: GET /v2/assignment-types.

输入参数pagesize

artesa_list_gangs

List gangs

List gangs (work crews or teams) of your company. Artesa API: GET /v2/gangs.

输入参数namepagesizeexternal_id

artesa_list_roles

List roles

List the user roles (Benutzerrollen) of your company. Artesa API: GET /v2/roles.

输入参数pagesize

版本历史

7
  1. v1.3.4最新Nov 7, 2026
  2. v1.2.3Nov 5, 2026
  3. v1.2.2Nov 5, 2026
  4. v1.2.1Nov 4, 2026
  5. v1.2.0Nov 3, 2026
  6. v1.1.1Nov 3, 2026
  7. v1.0.0Nov 1, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成