connect

/digital-marketing-pro:connect

脚本位置。 如果宿主未设置 ${CLAUDE_PLUGIN_ROOT}，脚本位于此插件的 scripts/ 文件夹中，与 skills/ 同级。请使用 Python 3.10 或更高版本运行：python，或者在找不到 python 时使用 python3（macOS 和许多 Linux 系统）。

用途

指导用户将特定的 MCP 集成连接到 Digital Marketing Pro 插件。提供针对平台的设置说明、凭据要求、配置步骤和验证方法。这是添加集成时面向用户的入口——它处理常见情况（已有成熟设置路径的已知连接器），而 /digital-marketing-pro:add-integration 用于处理自定义或未知的 MCP 服务。

所需输入

用户必须提供（或系统会提示用户提供）：

• 连接器名称：要连接的服务，例如 “google-ads”、“salesforce”、“mailchimp”、“twilio”、“deepl”。如果用户提供的是不完整或非正式名称（例如 “google analytics”、“fb ads”、“linkedin”），请将其匹配到注册表中最接近的连接器
• 环境（可选）：用户使用的是 Claude Code（支持 HTTP + npx）还是 Cowork（仅支持 HTTP）。默认根据可用上下文自动检测。如果请求的连接器仅支持 npx，而用户使用的是 Cowork，请说明此限制，并建议同类别的 HTTP 替代方案

流程

1. 查找连接器：执行 python "${CLAUDE_PLUGIN_ROOT}/scripts/connector-status.py" --action setup-guide --name <connector>，获取所请求连接器的详细设置指南。如果名称不完全匹配，请在注册表中搜索相近项，并建议正确的名称。

2. 检查当前状态：执行 python "${CLAUDE_PLUGIN_ROOT}/scripts/connector-status.py" --action check --name <connector>，确定连接器是否已配置。如果已连接，请告知用户，并说明它支持哪些技能；询问用户是要验证连接状态还是重新配置。

3. 根据传输类型提供设置说明：

   对于 HTTP 连接器（由注册表支持的连接器：Slack、Canva、Figma、HubSpot、Ahrefs、Similarweb、Klaviyo、Amplitude、Google Calendar、Gmail，以及官方广告平台服务 meta-ads、google-ads-mcp、amazon-ads-mcp）：

   • 没有任何连接器会预先连接。 不会随附 .mcp.json（该文件已加入 gitignore），因此全新安装时不会有自动连接的 MCP 服务——这是有意为之（可确保 Cowork 和多租户安装安全）。这些 HTTP 连接器属于选择启用的目录，文档位于 .mcp.json.connectors-reference。
   • 如需启用，用户需将对应配置块从 .mcp.json.connectors-reference 复制到自己的 .mcp.json（或通过 /digital-marketing-pro:add-integration 添加），然后重启客户端。HTTP 连接器无需在文件中填写 API 密钥——添加服务后，Claude 会在首次使用时提示用户进行 OAuth 授权。
   • 示例：“Slack 尚未连接。请将 .mcp.json.connectors-reference 中的 Slack 配置块复制到你的 .mcp.json（或运行 /digital-marketing-pro:add-integration slack），然后重启，再运行 /digital-marketing-pro:send-notification——系统会提示你通过 OAuth 授权 Slack。”
   • Notion、Stripe、Asana 和 Webflow 是仅收录于目录的 HTTP 服务：同样直接从 .mcp.json.connectors-reference 配置，但它们不在连接器注册表中，因此 /digital-marketing-pro:doctor 和 connector-status.py 不会报告它们。
   • 列出添加此连接器后可启用的技能 官方广告平台和 CRM 服务（已于 2026-10-04 核查；请参阅 CONNECTORS.md 中的“官方广告平台和 CRM MCP 服务”部分）：设置指南会返回一个 access 字段和一个 setup_note。请将两者都告知用户：
   • meta-ads（https://mcp.facebook.com/ads，公开测试版）：支持读写，需使用经过企业身份验证的 Meta 登录。
   • google-ads-mcp：只读。仅限 Claude Code，通过 pipx 在本地运行；或者用户通过 Streamable HTTP 自行托管，因此 URL 中包含 <...> 占位符。
   • amazon-ads-mcp：仅适用于拥有有效 Amazon Ads API 凭据的合作伙伴。端点由其 API 入门流程提供。
   • hubspot（https://mcp.hubspot.com，正式发布）：使用 OAuth 2.1 + PKCE 和用户的连接器应用凭据。

   对于每个支持读写的服务，请明确告知用户：

   • 只会通过 /digital-marketing-pro:launch-ad-campaign 的类型化审批关卡执行写入操作；
   • 新广告对象会以 PAUSED 状态创建；
   • DMP 绝不会通过这些服务删除内容。

   绝不要将它们添加到随附的 .mcp.json 中；用户应将相应条目复制到自己的配置文件中。

   • 如果用户询问 Asana、Webflow 或 Make.com，请使用目录中当前的 Streamable HTTP URL。旧的 /sse URL 使用 HTTP+SSE 传输方式，MCP 规范已于 2026-07-28 弃用该方式；Asana 的 V1 /sse 服务已于 2026 年 5 月 11 日关闭。Replicate 的目录条目已标记，因为其供应商页面仍只列出 /sse。

   对于 npx 连接器（Google Ads、Meta、Salesforce、Twilio 等）：

   • 列出所需的具体环境变量，并清楚说明其用途
   • 提供获取凭据的平台专属说明：
     • 在平台控制面板中的何处创建 API 密钥
     • 所需的权限／作用域
     • 任何前置条件（开发者账户、创建应用等）
   • 展示要添加的准确 .mcp.json 条目（来自设置指南）
   • 提供两种设置方式：
     1. 快速方式：“设置环境变量，然后运行 /digital-marketing-pro:add-integration <name> 自动配置”
     2. 手动方式：展示要直接添加到 .mcp.json 的 JSON 代码块
   • 说明 npx 连接器仅适用于 Claude Code，不适用于 Cowork

4. 处理未知连接器：如果连接器名称不在注册表中：

   • 搜索相近的匹配项并给出建议
   • 如果没有找到匹配项，说明这是一个自定义集成，并引导用户使用 /digital-marketing-pro:add-integration；该命令会处理 npm 包发现和自定义 MCP 服务设置
   • 列出可用的连接器类别，供用户探索其他选项

5. 设置后验证（仅适用于 npx 连接器）：用户确认已设置凭据后，主动提出验证连接：

   • 检查是否已设置所有必需的环境变量，且其值非空
   • 建议通过连接器运行只读测试，以确认其正常工作
   • 报告成功结果，或针对失败情况提供具体的诊断指导

输出

连接器设置指南，包含：

• 连接器信息：名称、类别、说明、传输类型（HTTP/npx）以及当前状态（已连接／未连接）
• 已解锁的技能：列出该连接器启用的所有技能，并简要说明每项技能的用途
• 设置说明：根据传输类型提供分步指南——HTTP 连接器说明 OAuth 流程，npx 连接器说明凭据设置
• 凭据要求（仅适用于 npx）：准确的环境变量名称、获取方式和所需权限
• 配置条目（仅适用于 npx）：可直接复制并添加到 .mcp.json 的准确 JSON 代码块
• 验证步骤：说明如何确认连接器在设置后正常工作
• 替代连接器：同一类别中用户可能会考虑的其他连接器（例如：“如果您更倾向于使用 Salesforce 而非 HubSpot 管理 CRM，请运行 /digital-marketing-pro:connect salesforce”）
• 后续步骤：“运行 /digital-marketing-pro:integrations 查看更新后的集成仪表板”，并尝试相关技能

使用的 Agent

• 无需专用 Agent — 此技能直接使用 connector-status.py 脚本，并根据连接器注册表提供平台专属指导