HERO Software MCP by usefulapi

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

Read contacts, projects, documents and log entries, and run read-only queries in HERO Software.

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

已驗證Streamable HTTP可網頁執行資料與分析商業與電商

概覽

AI 產生的概覽

託管式 HERO Software 唯讀連接器,讓助理列出聯絡人、專案與單據,並執行唯讀 GraphQL 查詢。

可以做什麼
  • 列出聯絡人,含編號、姓名、公司、電子郵件、電話與地址,可依類別篩選並分頁
  • 列出專案,含專案編號、工種、客戶、聯絡人、專案地址與狀態,也可依 id 只取部分專案
  • 取得單一專案及其客戶單據與專案日誌(log book)紀錄
  • 列出報價、發票等客戶單據,含編號、日期、金額、營業稅、狀態、單據類型與檔案連結
  • 在 HERO API 上執行任意唯讀 GraphQL 查詢,包括 schema 內省;變更與訂閱會被拒絕
  • 查看用量、提出缺少的功能請求、升級或取消訂閱
適用情境
適合在使用 HERO Software 時,讓助理在對話中查詢客戶、專案、報價、發票或專案日誌,或透過唯讀 GraphQL 查詢回答臨時問題。
執行需求
遠端 MCP 端點,無需本機安裝;只填 URL,透過 OAuth 登入。首次連線需提供由 HERO 支援團隊核發的 HERO API key,伺服器會驗證並依使用者儲存。需要 HERO Software 帳號;免費方案每月 50 次工具呼叫。
安裝前請注意
伺服器會依使用者儲存你的 HERO API key,應視為敏感憑證。付費方案會產生費用:Pro 每月 9 美元或每年 90 美元,Pro+ 每月 39 美元或每年 390 美元,透過升級工具回傳的 Stripe 結帳連結付款;取消後服務持續到已付期間結束,當期不退款。讀取類工具不會更動資料,但中繼工具會管理訂閱並送出功能請求。

安裝

在 SourceWeft 中

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

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

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

README

HERO Software MCP by usefulapi

Use your HERO Software account from Claude, Cursor, or any MCP client. Read contacts, projects, offers, invoices and project log entries, and run read-only GraphQL queries. Hosted, no local install: connect with your own credentials.

Live endpoint: https://hero-software.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

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

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

On first connect you provide a HERO API key (HERO support issues the key on request, see the HERO API documentation). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
hero_list_contactsreadList contacts
hero_list_projectsreadList projects
hero_get_projectreadGet a project with documents and log
hero_list_documentsreadList documents
hero_run_queryreadRun a read-only GraphQL query
hero_usage_statusmetaUsage status (free-tier meter)
hero_request_featuremetaRequest a missing feature
hero_upgrademetaUpgrade to Pro or Pro+
hero_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 hero_upgrade (it returns a Stripe Checkout link). Cancel any time with hero_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running hero_upgrade before then undoes the cancel. Or write to [email protected].

License

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

來源:servers/hero-software/README.md,提交 4046075

工具

5

hero_list_contacts

List contacts

List contacts (customers and others) with number, name, company, email, phone and address. Filter by category (for example 'customer'). Page with offset. HERO GraphQL query: contacts.

輸入參數offsetcategory

hero_list_projects

List projects

List projects with project number, trade (measure), customer, contact person, project address and status. Pass ids to fetch only some projects. HERO GraphQL query: project_matches.

輸入參數ids

hero_get_project

Get a project with documents and log

Get one project by id with its customer documents (type, number, value, file link) and its history entries (log book). HERO GraphQL query: project_matches(ids).

輸入參數project_id必填

hero_list_documents

List documents

List customer documents (offers, invoices and so on) with number, date, value, VAT, status, document type and file link. HERO GraphQL query: customer_documents.

無需輸入參數。

hero_run_query

Run a read-only GraphQL query

Run any read-only GraphQL query on the HERO API, for example calendar_events or supply_product_versions, or a schema introspection ({ __schema { queryType { fields { name } } } }). Mutations and subscriptions are refused. The schema is only visible by introspection with your key.

輸入參數query必填variables

版本歷史

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