跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Everhour，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
直接在 AI 中用 Everhour 记录工时：查找任务，登记和修改工时，启动和停止计时器，并查看项目、客户、团队工时记录、发票、费用、排期以及项目和用户报表。
试试这样问
Everhour 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Everhour、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Everhour + Gemini
直接在 AI 中用 Everhour 记录工时：查找任务，登记和修改工时，启动和停止计时器，并查看项目、客户、团队工时记录、发票、费用、排期以及项目和用户报表。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
EVERHOUR_API_KEY
步骤 1 — 获取凭证
- 登录
https://app.everhour.com，打开 Settings → My Profile（https://app.everhour.com/#/account/profile）。 - 把页面底部的 API Token 复制到
EVERHOUR_API_KEY，然后安装连接器。它通过X-Api-Key请求头发送，只发给 Everhour。 - 用
everhour_get_me检查设置：它会显示该密钥所属的用户及其角色和状态。
密钥以你的身份操作：普通成员只能看到自己的工时和项目，管理员和主管能看到整个团队。AI 登记的工时记在你名下，除非管理员让它替其他人登记。
工时和计时器需经你同意：工时记录会进入发票和薪资计算。在调用 everhour_add_time、everhour_update_time_record、everhour_start_timer 或 everhour_stop_timer 之前，AI 会告诉你任务、日期、时长和备注，并等你确认。它绝不会猜测任务或时长。everhour_delete_time_record 在安装时处于关闭状态；管理员可以开启它，即便开启，AI 也会先问你。
可以读取的内容：用户、项目和任务（包括从 Asana、Trello、Jira、GitHub 等集成同步过来的），客户，整个团队、单个用户或单个项目的工时记录，正在运行的计时器，带明细的发票，费用，包含计划工作和休假的资源排期，以及含可计费工时、成本、利润和未开票金额的项目和用户报表。
单位：Everhour 以秒计时（3600 为 1 小时），以分为单位计钱（500 即 5.00）。AI 会替你换算。
ID：项目和任务带有平台前缀，Everhour 自身为 ev:，例如 Asana 为 as:、Jira 为 jr:。出现 404 往往是缺了前缀。
速率限制：每个密钥每 10 秒约 20 次请求。429 会告诉你需要等待多少秒。
常见错误：401 或 403 Access denied：密钥错误、已重新生成，或你的角色无权查看这些数据。422：缺少字段，或记录已锁定或已开票。
不包括：创建或修改项目、任务、客户、发票和费用，考勤打卡（上下班打卡），工时表审批，假期额度分配，自定义字段和 Webhook。
步骤 2 — 安装 adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
步骤 3 — 在 Gemini 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启
gemini。 - 在 Gemini CLI 中运行
/mcp（或在终端运行gemini mcp list），anythingmcp应显示为已连接。 - 开始输入提示，Gemini CLI 现在可以调用
Everhour的工具。
可用工具
| Tool | What it does |
|---|---|
everhour_get_me | Show the Everhour user the API key belongs to: id, name, headline, role (admin, supervisor or member) and status |
everhour_list_users | List or search the team's users: id, name, email, headline, role and status (active, invited, pending, removed) |
everhour_list_projects | List projects, optionally searched by name or limited to one integration (Asana, Trello, Jira...): id with platform prefix, name… |
everhour_get_project | Get one project: name, workspace, client, type, assigned users, billing type and fee, rates and budget with its progress (money in cents… |
everhour_list_project_tasks | List the tasks of one project: id, name, status, due date, labels, total tracked time and estimate (seconds) |
everhour_search_tasks | Search tasks by name across all projects, to find the task id needed to log time or start a timer: id, name, projects, status, due date… |
everhour_get_task | Get one task: name, projects, section, status, due date, labels, description, tracked time per user and estimate (seconds) |
everhour_list_clients | List clients, optionally searched by name: id, name, project ids, business details and budget |
everhour_list_time_records | List the whole team's time records in a date range: id, date, time (seconds), user id, comment, task id and name, project ids, locked and… |
everhour_list_user_time_records | List one user's time records in a date range, same fields as everhour_list_time_records |
everhour_list_project_time_records | List the time records of one project in a date range, same fields as everhour_list_time_records |
everhour_add_time | Log time on a task for a day (adds to what is already there). time is in seconds: 1 h 30 min is 5400 |
everhour_update_time_record | Change one time record: set its time (seconds), and optionally its date, task, user or comment |
everhour_delete_time_record | Delete one time record for good |
everhour_get_running_timer | Show the key owner's timer: status (active or stopped), task, comment, when it started and how long it has run (seconds) |
everhour_list_team_timers | List the timers running for the team right now: user, task, start time and duration (seconds) |
everhour_start_timer | Start the key owner's timer on a task; a timer already running is stopped and its time saved first |
everhour_stop_timer | Stop the key owner's running timer and save its time to the task; returns the saved time record |
everhour_list_invoices | List invoices: id, number, client, status (draft, sent, paid), issue and due date, period, total time (seconds) and amounts in cents (list… |
everhour_get_invoice | Get one invoice with its line items (name, billed time in seconds, amounts in cents), tax, discount and totals |
everhour_list_expenses | List expenses: id, date, user id, project, category id, amount (cents), quantity, billable flag and details |
everhour_list_schedule | List resource planner assignments (scheduled work and time off) by date, project, task or client: id, type (project or time-off), user id… |
everhour_projects_report | Projects report for a period: per project the tracked time, billable and non-billable time (seconds), billable amount, costs, profit… |
everhour_users_report | Users report for a period: per team member the tracked, billable and non-billable time, time off (seconds), billable amount, costs and… |
示例提示
- “在任务‘首页改版’上登记昨天 1 小时 30 分钟，备注‘客户反馈修改’。先给我看你要登记的内容。”
- “在 Acme 上线引导任务上启动计时器，我说停再停。”
- “团队上周记录了多少工时？按人和按项目分别列出。”
- “本月哪些项目的未开票金额最高？背后有多少可计费工时？”
- “现在有谁在计时？分别在做哪些任务？”
FAQ
Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。
下一步
这份指南对你有帮助吗?
