如何通过 MCP 将 MOCO 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → MOCO、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

MOCO + Gemini

让你的 AI 使用你的 MOCO 账户：查找项目和客户，按人员或项目查看已记录的工时，检查未付发票和团队利用率，并登记工时。需要你的 MOCO 子域名和从 MOCO 个人资料中获取的 API 密钥。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

MOCO_SUBDOMAIN, MOCO_API_KEY

步骤 1 — 获取凭证

1. 在 MOCO 中点击右上角的头像打开个人资料，进入 Integrations 标签页，复制你的个人 API 密钥。它能访问的内容与你自己的 MOCO 用户完全相同。
2. 你也可以在 Settings → Extensions → API & Webhooks → API Keys 中创建一个账户 API 密钥，权限可选只读或完全访问。只读密钥无法登记工时。
3. 把密钥粘贴到 MOCO_API_KEY。
4. MOCO_SUBDOMAIN 只填 MOCO 地址的第一部分：如果地址是 agency.mocoapp.com，就填 agency，不要带 https:// 和 .mocoapp.com。连接器随后会调用 https://agency.mocoapp.com/api/v1。
5. 安装连接器。不需要点击 Authorize with Provider：密钥会加密保存，并随每个请求发送。
6. 先运行 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 — 在 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" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 MOCO 的工具。

可用工具

示例提示

• “团队 9 月在 Website Relaunch 项目上登记了多少小时？其中可计费的有多少？”
• “目前有哪些发票已逾期或只付了一部分？分别属于哪些客户？”
• “上个月团队的利用率怎么样？对比一下可用产能和已预订产能。”
• “今天在 Acme 网站项目上为首页布局评审登记 2.5 小时。登记前先给我看看这条记录。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Meta Muse