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 分