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 整合