add-integration

/digital-marketing-pro:add-integration

用途

指导用户向 Digital Marketing Pro 插件添加自定义 MCP 服务集成。搜索提供所需服务连接的现有 MCP 软件包，在 .mcp.json 中使用正确的命令、参数和环境变量配置服务条目，测试连接以验证集成是否正常工作，并记录可用工具。支持使用 npm 上的预构建 MCP 服务，也支持针对专有 API 或内部工具的自定义实现。

所需输入

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

• 要集成的服务：要连接的服务名称及用途 — 例如，“用于反向链接分析的 Ahrefs”“用于支付数据的 Stripe”“用于自定义仪表板的内部分析 API”。这将决定 MCP 软件包的搜索词和配置方式
• 集成类型：使用预构建的 npm MCP 软件包（首选——设置更快，由社区维护），还是构建自定义 MCP 服务（适用于专有 API、内部工具或没有现成 MCP 软件包的服务）。如果不确定，系统会先搜索预构建选项
• 可用凭据：服务所需的 API 密钥、访问令牌、OAuth 客户端 ID 或其他身份验证凭据。用户应提前准备好这些凭据 — 系统会说明应使用哪些环境变量名称以及凭据的存储位置，但绝不会要求用户在对话中粘贴机密信息

流程

1. 加载品牌上下文：读取 ~/.claude-marketing/brands/_active-brand.json，获取当前品牌 slug，然后加载 ~/.claude-marketing/brands/{slug}/profile.json。检查 ~/.claude-marketing/credentials/ 中是否有代理机构凭据配置文件——如果处于代理机构模式，新集成可能需要映射到特定的客户凭据集。检查 ~/.claude-marketing/sops/ 中是否有代理机构 SOP。如果没有品牌，请询问：“先设置品牌吗（/digital-marketing-pro:brand-setup）？”——或者使用默认设置继续。
2. 搜索现有的 MCP 包：查询 npm 注册表和已知的 MCP 服务目录，查找与所需服务匹配的包——按服务名称、API 名称和常见变体进行搜索。根据下载量、最后更新时间、GitHub 星标数以及与该插件 MCP 配置格式的兼容性评估候选项。展示最佳匹配项（如果有多个可行选项，则展示前 3 项），并提供包名称、描述、支持的工具以及已知限制。
3. 为预构建包生成配置：如果找到合适的包，生成完整的 .mcp.json 条目——服务名称（遵循插件的命名规范：使用小写字母和连字符）、命令（npm 包使用 npx）、包含包名称及任何必需标志的 args 数组、将环境变量名称映射到凭据引用的 env 对象，以及概述该集成所提供功能的 description 字段。向用户展示要添加的确切 JSON 代码块。
4. 必要时提供自定义 MCP 指南：如果没有合适的预构建包，请根据 skills/context-engine/custom-mcp-guide.md 提供自定义 MCP 服务开发模板——项目结构、必需的工具定义、输入/输出架构、身份验证处理和错误响应模式。针对用户要连接的特定 API，附上入门实现框架，其中包含占位端点和身份验证流程。
5. 配置环境变量：指导用户设置环境变量——指定要使用的确切变量名称（遵循 SERVICE_API_KEY 规范）、添加位置（项目根目录下的 .env 文件，或用于 CI/CD 的系统环境变量），以及如何在 .mcp.json 配置中引用这些变量。对于代理机构设置，说明如何将凭据添加到 ~/.claude-marketing/credentials/ 中相应的凭据配置文件。
6. 测试 MCP 连通性：用户确认配置就绪后，验证集成是否正常工作——检查 MCP 服务能否无错误启动，列出它提供的可用工具，并执行一项基本的只读操作（例如获取账户信息、列出资源或调用健康检查端点），以确认身份验证和连通性。报告成功结果；如果失败，则提供具体错误详情和补救步骤。
7. 映射到代理机构凭据配置文件（如适用）：对于有多个客户品牌的代理机构设置，将新集成的凭据映射添加到相应配置文件中——说明哪些环境变量因客户而异、哪些是共享的，如何在切换品牌时切换凭据，以及如何确认当前使用的是正确凭据。
8. 记录集成信息：在品牌配置中记录新集成——服务名称、MCP 服务名称、可用工具、凭据要求、测试中发现的任何速率限制或使用约束，以及供团队参考的示例用法。

输出

完整的集成设置报告，包含：

• MCP 配置项：可直接添加到 .mcp.json 的准确 JSON 代码块——服务器名称、命令、参数、环境变量和描述，并已根据插件的配置架构进行格式化和验证
• 环境变量设置说明：配置所需凭据的分步指南——变量名称、设置位置、格式要求，以及用于确认变量已加载的验证命令
• 连接测试结果：服务器启动状态、可用工具列表及其说明，以及基本只读测试操作的结果——确认集成正常运行，或提供具体的错误诊断信息
• 凭据配置文件映射（仅限代理模式）：新集成的凭据如何映射到客户端配置文件、切换说明，以及多品牌设置的验证步骤
• 可用工具文档：新 MCP 服务公开的完整工具列表——工具名称、说明、必填参数，以及最常见操作的调用示例
• 后续步骤：如何使用新集成——哪些现有命令可以使用它、会触发其调用的提示词示例，以及应更新哪些工作流以纳入新功能

使用的 Agent

• execution-coordinator — MCP 包的发现与评估、通过架构验证生成配置、进行连接测试并处理诊断错误、为代理模式设置映射凭据配置文件，以及编写包含工具清单和使用指南的集成文档