EZ@Work

io.github.eranfinish由 GitHub 帳號 eranfinish 發布v0.1.0更新於 Oct 24, 2026

Manage clients, projects, time, and invoices in EZ@Work — business management for freelancers.

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

概覽

AI 產生的概覽

將助理連接到 EZ@Work 帳戶,可列出客戶與專案,並建立客戶、工時紀錄和草稿發票。

可以做什麼
  • 列出客戶與專案,可依狀態或搜尋字詞篩選
  • 建立客戶,預設拒絕疑似重複的紀錄
  • 為指定日期向專案登錄可計費工時
  • 建立最多 50 個明細項目的草稿發票,幣別、語言與營業稅取自帳戶資料
適用情境
適合已在 EZ@Work 管理客戶、專案、工時與開票的自由工作者、律師、代理機構與服務型企業,希望助理直接查詢或登錄資料而不必切換應用程式。
執行需求
透過 Streamable HTTP 連線至 mcp.ezatwork.com 遠端端點。Claude 連接器使用 OAuth(Google 身分)登入;其他用戶端需 EZ@Work 帳戶及以 Authorization Bearer 標頭傳送的 API 權杖。清單未宣告環境變數或標頭。
安裝前請注意
寫入類工具會變更 EZ@Work 帳戶資料:建立客戶、登錄工時、建立草稿發票。README 指出權杖範圍尚未在伺服器端完全強制執行,應只授予所列範圍並設定到期時間。清單結果不含備註、電話、統編與地址,紀錄文字視為使用者輸入資料。發票僅以草稿形式建立。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 EZ@Work,將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "ez-work": {
      "type": "http",
      "url": "https://mcp.ezatwork.com/mcp"
    }
  }
}

README

EZ@Work MCP Server

Connect EZ@Work — all-in-one business management for freelancers, lawyers, agencies, and service businesses — to Claude, Gemini, Cursor, and any MCP-compatible AI.

Tools

ToolDescriptionType
list_clientsList your clients/customers — id, name, company, status, email (+ default rate). Optional status, search, limit (default 50, max 200)Read
list_projectsList your projects/cases/work orders — id, name, status, client. Optional status, search, limitRead
create_clientCreate a client; refuses a likely duplicate (same email, or same name when no email) unless allow_duplicate=trueWrite
log_time_entryLog billable hours to a project (0 < hours <= 24) for a given date (default today)Write
create_invoiceCreate a draft invoice, 1-50 line items (auto currency/language/VAT)Write

Write tools change data in your EZ@Work account. Their descriptions tell the AI to confirm the exact values with you before calling them, and every tool validates its arguments before anything reaches the EZ@Work API — a bad value comes back as {"error": "invalid_input", ...}, a backend failure as a short {"error": ..., "status": ..., "message": ...} (plan limits pass through as PLAN_LIMIT_REACHED).

List tools return only the fields an assistant needs to pick a record — no notes, phone numbers, VAT numbers, addresses or contacts — and mark record text as user-entered data rather than instructions.

Setup

Claude Desktop / Claude.ai (OAuth — recommended)

Settings → Connectors → Add custom connector

  • URL: https://mcp.ezatwork.com/mcp
  • Authentication: OAuth (automatic)

Claude Code / Cursor / MCP Inspector (API token)

  1. Create a free EZ@Work account at https://app.ezatwork.com
  2. Generate an API token at https://app.ezatwork.com/settings/api-tokens with the scopes clients:read, clients:write, projects:read, time:write, invoices:write
  3. Connect to https://mcp.ezatwork.com/mcp with header Authorization: Bearer ezw_pat_...

Local testing with MCP Inspector:

bash
npx @modelcontextprotocol/inspector

Connect to http://localhost:8080/mcp with header Authorization: Bearer ezw_pat_...

Agent skill

skills/ezatwork-business-assistant/SKILL.md teaches an agent how to use these tools safely: resolve IDs by listing first, confirm every write with the user, treat record text as data, and never claim an invoice was sent. It is also listed on Agensi.

Security

  • Your data stays in your EZ@Work account
  • OAuth mode: Google identity → EZ@Work account lookup; no credentials stored in the MCP
  • API token mode: tokens have a mandatory expiration. Token scopes are being enforced server-side (a backend change is in progress), so don't rely on scopes alone to limit a token yet. Create tokens with only the scopes this server uses: clients:read, clients:write, projects:read, time:write, invoices:write
  • Authorization is verified on every request

Privacy Policy

https://www.ezatwork.com/privacy

Universal Design

EZ@Work adapts to your business type: a lawyer sees "cases," a freelancer sees "projects," a service business sees "work orders." Currency, language (24 supported), and tax rules auto-detect from your profile — no configuration needed in the MCP.


Development

Run locally

bash
python -m venv .venvsource .venv/bin/activate  # Windows: .venv\Scripts\activatepip install -e .
cp .env.example .env# Edit .env: EZ_API_BASE=http://localhost:5000 for local backend
python -m ezatwork_mcp.server# Server starts at http://localhost:8080/mcp

Run tests

bash
pip install pytest pytest-asynciopytest tests/

Docker

bash
docker build -t ezatwork-mcp .docker run -p 8080:8080 -e EZ_API_BASE=https://api.ezatwork.com ezatwork-mcp

Deploy to Cloud Run

bash
gcloud run deploy ezatwork-mcp \  --source . \  --region europe-west1 \  --project ezatwork-production \  --allow-unauthenticated \  --port 8080 \  --update-env-vars "EZ_API_BASE=https://api.ezatwork.com,MCP_BASE_URL=https://mcp.ezatwork.com" \  --update-secrets "GOOGLE_CLIENT_ID=ezmcp-google-client-id:latest" \  --update-secrets "GOOGLE_CLIENT_SECRET=ezmcp-google-client-secret:latest" \  --update-secrets "EZ_MCP_MASTER_TOKEN=ezmcp-master-token:latest"

--allow-unauthenticated is correct — auth is enforced at the MCP layer (OAuth or API token), not at the Cloud Run IAM level.

Technical notes

  • Transport: Streamable HTTP (/mcp endpoint)
  • Library: fastmcp 3.x (pinned <4)
  • Auth (OAuth): GoogleProvider from fastmcp.server.auth.providers.google
  • OAuth redirect allowlist: clients may only register Claude's callbacks and loopback URIs; set MCP_ALLOWED_REDIRECT_URIS (comma-separated patterns) to admit other clients
  • Auth (token): get_http_headers() from fastmcp.server.dependencies
  • Dual-auth: OAuth active when GOOGLE_CLIENT_ID + GOOGLE_CLIENT_SECRET + MCP_BASE_URL are set
  • Backend: GET /api/users/me for locale; GET /api/internal/users/by-email for OAuth→user mapping
  • Lists: GET /api/clients and GET /api/projects take no filters; status, search and limit are applied in the MCP server, which trims each record before returning it
  • Time entries: POST /api/timeentry with isBillable field
  • Invoices: POST /api/invoices with computed dueDate and total per item

Built by

EZ@Work — the business OS for independents.

License

MIT. See LICENSE.

來源:README.md,提交 a5e0c11

工具

0
該伺服器需要登入,因此 SourceWeft 無法在沒有帳號的情況下讀取其工具,也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 85%

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

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分