connect

# /digital-marketing-pro:connect

## Purpose

Guide users through connecting a specific MCP integration to the Digital Marketing Pro plugin. Provides platform-specific setup instructions, credential requirements, configuration steps, and verification. This is the user-friendly entry point for adding integrations — it handles the common cases (known connectors with established setup paths) while `/digital-marketing-pro:add-integration` handles custom or unknown MCP servers.

## Input Required

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

- **Connector name**: The service to connect — e.g., "google-ads", "salesforce", "mailchimp", "twilio", "deepl". If the user provides a partial or informal name (e.g., "google analytics", "fb ads", "linkedin"), match it to the closest connector in the registry
- **Environment** (optional): Whether they're using Claude Code (supports HTTP + npx) or Cowork (HTTP only). Defaults to auto-detect based on available context. If the requested connector is npx-only and the user is on Cowork, explain the limitation and suggest HTTP alternatives in the same category

## Process

1. **Look up connector**: Execute `python "${CLAUDE_PLUGIN_ROOT}/scripts/connector-status.py" --action setup-guide --name <connector>` to get the detailed setup guide for the requested connector. If the name doesn't match exactly, search the registry for close matches and suggest the correct name.

2. **Check current status**: Execute `python "${CLAUDE_PLUGIN_ROOT}/scripts/connector-status.py" --action check --name <connector>` to determine if the connector is already configured. If already connected, report that and show which skills it powers — ask if the user wants to verify connectivity or reconfigure.

3. **Present setup instructions based on transport type**:

   **For HTTP connectors** (the 10 registry-backed ones: Slack, Canva, Figma, HubSpot, Ahrefs, Similarweb, Klaviyo, Amplitude, Google Calendar, Gmail):
   - **Nothing is pre-connected.** The shipped `.mcp.json` is empty (`{"mcpServers":{}}`) so a fresh install has zero auto-connecting MCP servers — this is deliberate (it keeps Cowork and multi-tenant installs safe). These HTTP connectors are an **opt-in catalog**, documented in `.mcp.json.connectors-reference`.
   - To enable one, the user copies its block from `.mcp.json.connectors-reference` into their own `.mcp.json` (or adds it via `/digital-marketing-pro:add-integration`), then restarts the client. HTTP connectors need no API key in the file — once the server is added, Claude prompts for OAuth on first use.
   - Example: "Slack isn't connected yet. Copy the Slack block from `.mcp.json.connectors-reference` into your `.mcp.json` (or run `/digital-marketing-pro:add-integration slack`), restart, then run `/digital-marketing-pro:send-notification` — you'll be prompted to authorize Slack via OAuth."
   - Notion, Stripe, Asana, and Webflow are **catalog-only** HTTP servers: configure them directly from `.mcp.json.connectors-reference` the same way, but they are not in the connector registry, so `/digital-marketing-pro:doctor` and `connector-status.py` will not report on them.
   - List the skills this connector would enable once added

   **For npx connectors** (Google Ads, Meta, Salesforce, Twilio, etc.):
   - List the specific environment variables needed with clear descriptions
   - Provide platform-specific instructions for obtaining credentials:
     - Where to go in the platform's dashboard to create API keys
     - What permissions/scopes are needed
     - Any prerequisites (developer accounts, app creation, etc.)
   - Show the exact `.mcp.json` entry to add (from the setup guide)
   - Offer two setup paths:
     1. **Quick**: "Set the environment variables and run `/digital-marketing-pro:add-integration <name>` to configure automatically"
     2. **Manual**: Show the JSON block to add to `.mcp.json` directly
   - Note that npx connectors work in Claude Code only, not Cowork

4. **Handle unknown connectors**: If the connector name isn't in the registry:
   - Search for close matches and suggest them
   - If no match found, explain that it's a custom integration and guide them to `/digital-marketing-pro:add-integration` which handles npm package discovery and custom MCP server setup
   - List the categories of connectors available so they can explore alternatives

5. **Verify after setup** (for npx connectors): After the user confirms they've set up credentials, offer to verify connectivity:
   - Check that all required environment variables are set and non-empty
   - Suggest running a read-only test via the connector to confirm it works
   - Report success or diagnose failure with specific guidance

## Output

A connector setup guide containing:

- **Connector info**: Name, category, description, transport type (HTTP/npx), and current status (connected/not connected)
- **Skills unlocked**: List of all skills this connector enables, with brief descriptions of what each skill does
- **Setup instructions**: Step-by-step guide appropriate to the transport type — OAuth flow for HTTP, credential setup for npx
- **Credential requirements** (npx only): Exact environment variable names, where to obtain them, and required permissions
- **Configuration entry** (npx only): The exact JSON block to add to `.mcp.json`, ready to copy
- **Verification steps**: How to confirm the connector is working after setup
- **Alternative connectors**: Other connectors in the same category that the user might consider (e.g., "If you prefer Salesforce over HubSpot for CRM, run `/digital-marketing-pro:connect salesforce`")
- **Next steps**: "Run `/digital-marketing-pro:integrations` to see your updated integration dashboard" and relevant skills to try

## Agents Used

- No specialized agent needed — this skill uses the `connector-status.py` script directly and provides platform-specific guidance based on the connector registry