Quinyx MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.7.4更新於 Nov 7, 2026

Read groups, roles, employees, agreement metadata, role assignments and planned shifts.

發布方自己的服務:Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行效率與工作流商業與電商

概覽

AI 產生的概覽

以唯讀方式存取 Quinyx 人力資料(組織群組、角色、員工、協議、角色指派與排班班次),供 AI 助理查詢。

可以做什麼
  • 列出並取得組織群組,含單位與部門
  • 列出並取得組織角色
  • 列出並取得排班員工資訊
  • 列出協議排班中繼資料與員工角色指派
  • 列出已排班次,可依時間範圍篩選
  • 查看本月用量、提出功能請求、升級或取消訂閱
適用情境
適合讓助理不必開啟管理後台,就能回答關於組織架構、員工指派、協議起訖日期或預定班次的問題,例如查看某單位一週的排班,或某人擔任哪些角色。
執行需求
遠端 MCP 端點,只需加入 URL,不需 API 金鑰或 Authorization 標頭。透過 OAuth 以你自己的 Quinyx 帳號登入。免費方案每月 50 次工具呼叫,付費方案可提高上限。
安裝前請注意
此服務為第三方代理,會透過其託管的 OAuth 流程接收你的 Quinyx 登入資訊並代為讀取 HR 資料。資料工具為唯讀,但中繼工具可發起付費 Stripe 訂閱(quinyx_upgrade)或取消訂閱(quinyx_cancel_subscription),也可送出功能請求;升級前請確認費用。薪資、身分證號、私人聯絡方式與健康資料已由允許清單排除。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Quinyx MCP by usefulapi,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Fquinyx/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

README

Quinyx MCP by usefulapi

Remote MCP endpoint: https://quinyx.usefulapi.io/mcp

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://quinyx.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http quinyx https://quinyx.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": {    "quinyx": {      "url": "https://quinyx.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 Quinyx credentials.

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

Connect with your Quinyx credentials using the hosted authorization flow.

Tools

ToolTypeWhat it does
quinyx_list_groupsreadList organization groups (including units/sections)
quinyx_list_rolesreadList organization roles
quinyx_list_employeesreadList scheduling employee details
quinyx_list_agreementsreadList agreement scheduling metadata (v3preview1)
quinyx_list_role_assignmentsreadList employee role assignments
quinyx_list_shiftsreadList scheduled shifts
quinyx_get_groupreadGet group
quinyx_get_rolereadGet role
quinyx_get_employeereadGet employee
quinyx_get_agreementreadGet agreement
quinyx_usage_statusmetaUsage status (free-tier meter)
quinyx_request_featuremetaRequest a missing feature
quinyx_upgrademetaUpgrade to Pro or Pro+
quinyx_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 regional client ID)$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 quinyx_upgrade (it returns a Stripe Checkout link). Cancel any time with quinyx_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running quinyx_upgrade before then undoes the cancel. Or write to [email protected].

License

See the repository license.

來源:servers/quinyx/README.md,提交 4046075

工具

10

quinyx_list_groups

List organization groups (including units/sections)

Read one bounded page of organization groups (including units/sections). Requires organization:groups:read. Returns data plus opaque pagination tokens; pass pageToken for another page, no automatic crawl. Operational allowlist excludes payroll, national IDs, private contact/health information and free-text comments.

輸入參數idInpageSizepageToken

quinyx_list_roles

List organization roles

Read one bounded page of organization roles. Requires organization:roles:read. Returns data plus opaque pagination tokens; pass pageToken for another page, no automatic crawl. Operational allowlist excludes payroll, national IDs, private contact/health information and free-text comments.

輸入參數pageSizepageToken

quinyx_list_employees

List scheduling employee details

Read one bounded page of scheduling employee details. Requires hr:employees:read. Returns data plus opaque pagination tokens; pass pageToken for another page, no automatic crawl. Operational allowlist excludes payroll, national IDs, private contact/health information and free-text comments.

輸入參數idInpageSizepageToken

quinyx_list_agreements

List agreement scheduling metadata (v3preview1)

Read one bounded page of agreement scheduling metadata (v3preview1). Requires hr:agreements:read. Returns data plus opaque pagination tokens; pass pageToken for another page, no automatic crawl. Operational allowlist excludes payroll, national IDs, private contact/health information and free-text comments.

輸入參數groupIdpageSizepageTokenemployeeIdendDateGtetemplateIdbadgeNumberstartDateLte

quinyx_list_role_assignments

List employee role assignments

Read one bounded page of employee role assignments. Requires hr:role-assignments:read. Returns data plus opaque pagination tokens; pass pageToken for another page, no automatic crawl. Operational allowlist excludes payroll, national IDs, private contact/health information and free-text comments.

輸入參數idInpageSizeroleIdIngroupIdInpageTokenendDateGteendDateLteemployeeIdInstartDateGtestartDateLte

quinyx_list_shifts

List scheduled shifts

Read one bounded page of scheduled shifts. Requires schedule:shifts:read. Returns data plus opaque pagination tokens; pass pageToken for another page, no automatic crawl. Operational allowlist excludes payroll, national IDs, private contact/health information and free-text comments. beginGte/beginLte required here, at most93days apart; no writes or punches.

輸入參數idIndeletedbeginGte必填beginLte必填pageSizestatusIngroupIdInpageTokenemployeeIdIn

quinyx_get_group

Get group

Read operational group metadata by internal numeric ID or documented external reference. Requires organization:groups:read. Payroll/private fields omitted.

輸入參數id必填

quinyx_get_role

Get role

Read operational role metadata by internal numeric ID or documented external reference. Requires organization:roles:read. Payroll/private fields omitted.

輸入參數id必填

quinyx_get_employee

Get employee

Read operational employee metadata by internal numeric ID or documented external reference. Requires hr:employees:read. Payroll/private fields omitted.

輸入參數id必填

quinyx_get_agreement

Get agreement

Read operational agreement metadata by internal numeric ID or documented external reference. Requires hr:agreements:read. Payroll/private fields omitted. Uses documented v3preview1 agreement API.

輸入參數id必填

版本歷史

10
  1. v1.7.4最新Nov 7, 2026
  2. v1.6.3Nov 5, 2026
  3. v1.6.2Nov 5, 2026
  4. v1.6.1Nov 4, 2026
  5. v1.6.0Nov 3, 2026
  6. v1.5.1Nov 3, 2026
  7. v1.4.0Nov 1, 2026
  8. v1.2.0Oct 31, 2026
  9. v1.1.0Oct 31, 2026
  10. v1.0.0Oct 31, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合