跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 MOCO,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
摘要
让你的 AI 使用你的 MOCO 账户:查找项目和客户,按人员或项目查看已记录的工时,检查未付发票和团队利用率,并登记工时。需要你的 MOCO 子域名和从 MOCO 个人资料中获取的 API 密钥。
试试这样问
MOCO 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → MOCO、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
MOCO + ChatGPT
让你的 AI 使用你的 MOCO 账户:查找项目和客户,按人员或项目查看已记录的工时,检查未付发票和团队利用率,并登记工时。需要你的 MOCO 子域名和从 MOCO 个人资料中获取的 API 密钥。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
MOCO_SUBDOMAIN, MOCO_API_KEY
步骤 1 — 获取凭证
- 在 MOCO 中点击右上角的头像打开个人资料,进入 Integrations 标签页,复制你的个人 API 密钥。它能访问的内容与你自己的 MOCO 用户完全相同。
- 你也可以在 Settings → Extensions → API & Webhooks → API Keys 中创建一个账户 API 密钥,权限可选只读或完全访问。只读密钥无法登记工时。
- 把密钥粘贴到
MOCO_API_KEY。 MOCO_SUBDOMAIN只填 MOCO 地址的第一部分:如果地址是agency.mocoapp.com,就填agency,不要带https://和.mocoapp.com。连接器随后会调用https://agency.mocoapp.com/api/v1。- 安装连接器。不需要点击 Authorize with Provider:密钥会加密保存,并随每个请求发送。
- 先运行
moco_list_users:如果列出了你的同事及其 ID,说明密钥和子域名都正确。
保持登录状态:连接器直接使用密钥,因此没有需要续期的登录。如果在 MOCO 中更换或删除了密钥,请把新密钥粘贴到 MOCO_API_KEY。
AI 能看到什么:每个列表只返回密钥所属用户有权查看的记录。如果某个项目或发票看起来不见了,通常是 MOCO 中的权限问题,而不是连接器的故障。
登记工时:moco_create_activity 是唯一会写入 MOCO 的工具。它为密钥所属用户登记一条工时记录,需要日期、项目 ID、任务 ID、以整秒计的时长(2 小时为 7200)以及可选的说明。AI 用 moco_list_projects 找到项目,再用 moco_get_project 找到项目的任务。每次调用都会新建一条记录,重复调用会把工时记两次,所以 AI 会先给你看日期、项目、任务和时长,等你确认后再登记。
权限和只读设置:如果连接器只需要读取数据,请在连接器页面停用 moco_create_activity,或者使用只读的账户 API 密钥。不要把完全访问权限的密钥交给只需要读取数据的人。
报表和发票:moco_list_activities 和 moco_report_utilization 始终需要开始日期和结束日期(from 和 to,格式为 YYYY-MM-DD)。工时记录可以限定到某个人、某个项目或只看可计费工时;利用率报表会对比可用产能和已预订产能。moco_list_invoices 可按状态(draft、created、sent、partially_paid、paid、overdue、ignored,可用逗号分隔同时指定多个)、发票日期和公司筛选。
限制:列表每页最多返回 100 条,AI 会一直翻页直到最后一页。MOCO 标准套餐大约允许每两分钟 120 个请求;超出后会返回 429,请稍等片刻再试。
常见错误:401 表示密钥错误、已被删除,或者属于与 MOCO_SUBDOMAIN 不同的 MOCO 账户。如果所有调用都失败,请检查 MOCO_SUBDOMAIN 中是否只填了子域名,而不是完整地址。单个项目返回 404 表示 ID 错误,或者密钥所属用户无权查看该项目。登记被拒绝时,会指出 MOCO 不接受的字段,例如任务不属于该项目。
该连接器不会创建或发送发票,不会下载 PDF,不会设置 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 — 在 ChatGPT 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
ChatGPT 通过开发者模式(Developer mode)将 MCP 服务器作为自定义应用接入,仅付费套餐可用,免费套餐不可用。在 Business 和 Enterprise 工作区中,可能需要管理员先开启。
- 在 ChatGPT 中打开 Settings → Security and login,开启 Developer mode。
- 前往 chatgpt.com/plugins,点击 +。
- 填写名称和简短描述,例如 Name:
MOCO。 - 在 Connection 下填入 MCP 服务器 URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,然后创建连接。 - ChatGPT 提示时,登录 AnythingMCP(OAuth)并允许访问。
可用工具
| Tool | What it does |
|---|---|
moco_list_users | List MOCO users visible to this API key, including their IDs and names |
moco_list_projects | List MOCO projects with IDs, names, customer links and status |
moco_get_project | Get a single MOCO project by its numeric ID, including project details and assigned tasks needed when creating a time activity |
moco_list_activities | List tracked time activities within a date range, optionally filtered by user, project or billability |
moco_list_companies | List customers, suppliers and organizations in MOCO |
moco_list_invoices | List MOCO invoices visible to this API key |
moco_report_utilization | Get MOCO's utilization report for a date range, showing available and booked capacity so you can assess team workload |
moco_create_activity | Book a new MOCO time activity for the API key's user |
示例提示
- “团队 9 月在 Website Relaunch 项目上登记了多少小时?其中可计费的有多少?”
- “目前有哪些发票已逾期或只付了一部分?分别属于哪些客户?”
- “上个月团队的利用率怎么样?对比一下可用产能和已预订产能。”
- “今天在 Acme 网站项目上为首页布局评审登记 2.5 小时。登记前先给我看看这条记录。”
FAQ
ChatGPT 免费套餐能用自定义 MCP 连接器吗? 不能。自定义 MCP 连接需要开发者模式,只有付费套餐提供。
下一步
这份指南对你有帮助吗?