add-integration

Dieser Auszug wurde bei der Prüfung gespeichert. Die externe Quelle enthält die vollständige und aktuelle Version.

---
name: add-integration
description: "Add MCP server integrations. Use when: connecting a custom tool, API, or service to the plugin via .mcp.json."
argument-hint: "[service-name]"
---

# /digital-marketing-pro:add-integration

## Purpose

Guide users through adding a custom MCP server integration to the Digital Marketing Pro plugin. Search for existing MCP packages that provide the desired service connection, configure the server entry in `.mcp.json` with proper command, arguments, and environment variables, test connectivity to verify the integration works, and document the available tools. Supports both pre-built MCP servers from npm and custom implementations for proprietary APIs or internal tools.

## Input Required

The user must provide (or will be prompted for):

- **Service to integrate**: The name and purpose of the service to connect — e.g., "Ahrefs for backlink analysis", "Stripe for payment data", "our internal analytics API for custom dashboards". This determines the MCP package search terms and configuration approach
- **Integration type**: Whether to use a pre-built npm MCP package (preferred — faster setup, community-maintained) or build a custom MCP server (necessary for proprietary APIs, internal tools, or services without existing MCP packages). If unsure, the system searches for pre-built options first
- **Credentials available**: API keys, access tokens, OAuth client IDs, or other authentication credentials required by the service. The user should have these ready — the system will specify which environment variable names to use and where to store them, but will never ask the user to paste secrets into the conversation

## Process

1. **Load brand context**: Read `~/.claude-marketing/brands/_active-brand.json` for the active slug, then load `~/.claude-marketing/brands/{slug}/profile.json`. Check for agency credential profiles at `~/.claude-marketing/credentials/` — if agency mode is active, the new integration may need to be mapped to specific client credential sets. Check for agency SOPs at `~/.claude-marketing/sops/`. If no brand exists, ask: "Set up a brand first (/digital-marketing-pro:brand-setup)?" — or proceed with defaults.
2. **Search for existing MCP package**: Query npm registry and known MCP server directories for packages matching the requested service — search by service name, API name, and common variations. Evaluate candidates by download count, last update date, GitHub stars, and compatibility with the plugin's MCP configuration format. Present the best match (or top 3 if multiple viable options) with package name, description, supported tools, and any known limitations.
3. **Generate configuration for pre-built package**: If a suitable package is found, generate the complete `.mcp.json` entry — server name (following the plugin's naming convention: lowercase with hyphens), command (`npx` for npm packages), args array with the package name and any required flags, env object mapping environment variable names to credential references, and a description field summarizing what the integration provides. Show the user the exact JSON block to add.
4. **Provide custom MCP guidance if needed**: If no suitable pre-built package exists, provide a custom MCP server development template based on `skills/context-engine/custom-mcp-guide.md` — project structure, required tool definitions, input/output schemas, authentication handling, and error response patterns. Include a starter implementation skeleton for the specific API the user wants to connect, with placeholder endpoints and authentication flow.
5. **Configure environment variables**: Guide the user on environment variable setup — specify the exact variable names to use (following the `SERVICE_API_KEY` convention), where to add them (`.env` file in the project root or system environment variables for CI/CD), and how to reference them in the `.mcp.json` configuration. For agency setups, explain how to add the credentials to the appropriate crede