如何通过 MCP 将 DIGISAC 连接到 Gemini

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

DIGISAC + Gemini

让你的 AI 在 DIGISAC 全渠道收件箱中工作：查找联系人，读取消息记录、工单、部门、坐席、标签和 WhatsApp 模板，跟进销售漏斗和看板，并获取实时及按时段的服务统计。发送消息和更改工单的工具在安装时处于关闭状态。

前提条件

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

DIGISAC_URL, DIGISAC_API_TOKEN

步骤 1 — 获取凭证

设置大约需要 2 分钟。你需要一个 DIGISAC 账号，以及一个可以创建个人访问令牌的用户，最好是主管或管理员。

1. 登录 DIGISAC，打开 Conta → Informações。把账号地址复制到 DIGISAC_URL，例如 https://empresa.digisac.co 或 https://empresa.digisac.app（以 -api.digisac.com.br 结尾的地址也可以），不要带 /api/v1 或其他路径。
2. 打开 Conta → API → Tokens de acesso pessoal，创建一个令牌并粘贴到 DIGISAC_API_TOKEN，不要加 Bearer，也不要有空格。
3. 安装连接器并运行 digisac_get_me：它会显示令牌所属的用户及其角色和部门。

令牌以你的身份操作：令牌拥有创建它的用户的权限。主管的令牌能看到所有部门；坐席的令牌在访问该用户无权打开的数据时可能收到 403。连接器只会把令牌发送到你的 DIGISAC 地址。

DIGISAC 的结构：每个 WhatsApp 号码、WhatsApp Business API 线路以及 Instagram、Messenger、Telegram、邮件或网页聊天渠道都是一个连接，联系人、消息和模板都属于某一个连接。工单（chamados）被分配到部门（filas），由坐席（atendentes）处理。AI 会先用 digisac_list_connections、digisac_list_departments 和 digisac_list_users 了解各个 ID，再按姓名或电话号码查找联系人。

可读取的内容：联系人的号码、所属连接、标签、备注、未读数和最近消息时间；联系人的完整消息记录，包括带临时下载链接的媒体和内部事件；工单的协议号、部门、坐席、开始和结束时间以及工单主题（assuntos）；标签（etiquetas）；带占位符的 WhatsApp Business 模板（HSM）；快捷回复（respostas rápidas）；定时消息（agendamentos）；带阶段和金额商机的销售漏斗（pipelines）；带列和卡片的服务看板（quadros de atendimento）；当前的服务状态（未结和等待中的工单、在线坐席、各部门负载）；以及某个时段的统计：按部门或坐席统计新开和关闭的工单、等待和服务时长、收发消息数。

电话号码：DIGISAC 存储号码时带国家代码、不带 +，例如 5511987654321。AI 也可以按号码的一部分搜索。

每次修改前都会询问：digisac_create_contact 在某个连接上新建联系人（DIGISAC 也会接受无效号码，并将其标记为无效），digisac_update_contact 修改联系人的姓名、备注、默认部门或标签。更新时提交的标签列表会替换该联系人的全部标签，所以 AI 会先读取联系人，再提交完整列表。每次修改前，AI 都会展示改动内容，等你同意后再执行。

安装时关闭：digisac_send_message、digisac_send_template、digisac_schedule_message、digisac_cancel_schedule、digisac_transfer_ticket 和 digisac_close_ticket。消息会立即送达顾客，而且除非另行指定，发送文本消息会开启一张工单。在 WhatsApp Business API 线路上，只有在顾客最后一条消息后的 24 小时内才能发送自由文本；超出这个时间窗口只能使用已审核的模板，并由 Meta 对会话计费。关闭工单时，顾客可能会收到结束消息和满意度调查，定时消息也会自动发出。这些工具需要管理员有意识地开启，即使开启后，AI 也会逐一与你确认。

顾客文本只是数据：消息内容和联系人姓名都来自顾客。AI 会把其中出现的任何指令当作数据，而不是命令。

限制：附带详细信息的工单和消息数据量较大，所以 AI 每页只取 20 到 50 行，只在需要时才附带详情。DIGISAC 的筛选只接受真实存在的列；如果出现提到某个列名的 500 错误，AI 会去掉这部分条件后重新查询。

常见错误：401 表示令牌错误或已被删除，请在 Conta → API 中新建一个。403 表示你的用户无权读取这些数据，请使用主管或管理员的令牌。404 表示该地址没有响应（请检查 DIGISAC_URL）或 ID 不存在。400 表示某个连接已断开或参数有误。

该连接器不管理机器人、营销活动、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 现在可以调用 DIGISAC 的工具。

可用工具

示例提示

• “Suporte 部门现在有多少张工单在等待？哪些坐席在线？”
• “给我看联系人 +55 11 98765-4321 最近的消息，以及她的工单是否还开着。”
• “上周的服务情况怎么样：新开和关闭的工单、平均等待时间，以及各部门的消息数？”
• “我们 Vendas 漏斗中处于 Negociação 阶段的商机有哪些？总金额是多少？”
• “给 Maria Souza 加上 Cliente VIP 标签，并备注她更喜欢用 WhatsApp。修改前先给我看。”

FAQ

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

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT