
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.
概覽
將助理連接到 EZ@Work 帳戶,可列出客戶與專案,並建立客戶、工時紀錄和草稿發票。
- 可以做什麼
- 列出客戶與專案,可依狀態或搜尋字詞篩選
- 建立客戶,預設拒絕疑似重複的紀錄
- 為指定日期向專案登錄可計費工時
- 建立最多 50 個明細項目的草稿發票,幣別、語言與營業稅取自帳戶資料
- 適用情境
- 適合已在 EZ@Work 管理客戶、專案、工時與開票的自由工作者、律師、代理機構與服務型企業,希望助理直接查詢或登錄資料而不必切換應用程式。
- 執行需求
- 透過 Streamable HTTP 連線至 mcp.ezatwork.com 遠端端點。Claude 連接器使用 OAuth(Google 身分)登入;其他用戶端需 EZ@Work 帳戶及以 Authorization Bearer 標頭傳送的 API 權杖。清單未宣告環境變數或標頭。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 EZ@Work,將其新增到工作區。
- 連接 所需的 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
- 為需要使用其工具的對話啟用該服務。
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
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)
- Create a free EZ@Work account at https://app.ezatwork.com
- 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 - Connect to
https://mcp.ezatwork.com/mcpwith headerAuthorization: Bearer ezw_pat_...
Local testing with MCP 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
Run tests
Docker
Deploy to Cloud Run
--allow-unauthenticatedis correct — auth is enforced at the MCP layer (OAuth or API token), not at the Cloud Run IAM level.
Technical notes
- Transport: Streamable HTTP (
/mcpendpoint) - Library:
fastmcp 3.x(pinned<4) - Auth (OAuth):
GoogleProviderfromfastmcp.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()fromfastmcp.server.dependencies - Dual-auth: OAuth active when
GOOGLE_CLIENT_ID+GOOGLE_CLIENT_SECRET+MCP_BASE_URLare set - Backend:
GET /api/users/mefor locale;GET /api/internal/users/by-emailfor OAuth→user mapping - Lists:
GET /api/clientsandGET /api/projectstake no filters; status, search and limit are applied in the MCP server, which trims each record before returning it - Time entries:
POST /api/timeentrywithisBillablefield - Invoices:
POST /api/invoiceswith computeddueDateandtotalper item
Built by
EZ@Work — the business OS for independents.
License
MIT. See LICENSE.
來源:README.md,提交 a5e0c11
工具
0版本歷史
1- v0.1.0最新Sep 16, 2026
評分
已滿足適用檢查項的 85%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通必需25 分
- 已宣告認證方式必需10 分
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分