OpenParable
Skip to content
← Back to skills

Connect

Apps & Automation
connect

Connect is an Agent Skill for apps & automation published in the hashgraph-online/awesome-codex-plugins repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Set up an MCP connector. Use when: connecting Google Ads, Salesforce, Mailchimp, or any service to the plugin.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/hashgraph-online/awesome-codex-plugins/blob/HEAD/plugins/indranilbanerjee/digital-marketing-pro/skills/connect/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/connect, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

/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 (Slack, Canva, Figma, HubSpot, Notion, Ahrefs, Similarweb, Klaviyo, Google Calendar, Gmail, Stripe, Asana, Webflow):

    • 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."
    • 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