connect

/digital-marketing-pro:connect

スクリプトの場所。 ホストが ${CLAUDE_PLUGIN_ROOT} を設定しない場合、スクリプトはこのプラグインの scripts/ フォルダー内にあり、skills/ の隣に配置されています。Python 3.10 以降で実行してください。python を使用するか、python が見つからない場合（macOS、多くの Linux システム）は python3 を使用します。

目的

特定の MCP 統合を Digital Marketing Pro プラグインに接続する手順を案内します。プラットフォームごとのセットアップ手順、認証情報の要件、設定手順、検証方法を提供します。統合を追加するための使いやすい入口です。一般的なケース（確立されたセットアップ方法がある既知のコネクター）に対応し、カスタムまたは不明な MCP サーバーには /digital-marketing-pro:add-integration が対応します。

必要な入力

ユーザーは以下を指定する必要があります（または、指定を求められます）。

• コネクター名：接続するサービス。例：「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: 読み取り専用。ローカルで pipx 経由で実行するか（Claude Code のみ）、ユーザーが Streamable HTTP 経由でセルフホストするため、URL には <...> プレースホルダーが含まれます。
   • amazon-ads-mcp: 有効な Amazon Ads API 認証情報を持つパートナーのみ。エンドポイントは API のオンボーディングから取得します。
   • hubspot（https://mcp.hubspot.com、GA）: OAuth 2.1 + PKCE と、ユーザーのコネクターアプリの認証情報を使用します。

   読み取り＋書き込みが可能なすべてのサーバーについて、ユーザーに明確に伝えてください:

   • 書き込みは /digital-marketing-pro:launch-ad-campaign の型付き承認ゲートを通じてのみ行われます。
   • 新しい広告オブジェクトは PAUSED 状態で作成されます。
   • DMP がこれらのサーバーを通じて削除を行うことは決してありません。

   これらのいずれも、配布される .mcp.json に追加しないでください。ユーザーが自分自身の設定にエントリをコピーします。

   • ユーザーが Asana、Webflow、Make.com を求めた場合は、カタログにある現在の Streamable HTTP URL を使用してください。旧 /sse URL は、MCP 仕様 2026-07-28 で非推奨となった HTTP+SSE トランスポートを使用しています。Asana の V1 /sse サーバーは 2026 年 5 月 11 日にシャットダウンされました。Replicate のカタログエントリは、ベンダーページに依然として /sse のみが記載されているため、フラグが付けられています。

   npx コネクターの場合（Google Ads、Meta、Salesforce、Twilio など）:

   • 必要な特定の環境変数を、わかりやすい説明とともに列挙する
   • 認証情報を取得するためのプラットフォーム固有の手順を提供する:
     • プラットフォームのダッシュボードのどこで API キーを作成するか
     • どのような権限／スコープが必要か
     • 前提条件（開発者アカウント、アプリ作成など）
   • 追加すべき正確な .mcp.json エントリを示す（セットアップガイドより）
   • 2 つのセットアップ手順を提示する:
     1. クイック: 「環境変数を設定し、/digital-marketing-pro:add-integration <name> を実行すると自動で構成されます」
     2. 手動: .mcp.json に直接追加する JSON ブロックを示す
   • npx コネクターは Claude Code でのみ動作し、Cowork では動作しないことに注意する

4. 不明なコネクターの処理: コネクター名がレジストリにない場合:

   • 近い一致を検索して提案する
   • 一致が見つからない場合は、それがカスタム統合であることを説明し、npm パッケージの検出とカスタム MCP サーバーのセットアップを処理する /digital-marketing-pro:add-integration へ案内する
   • 利用可能なコネクターのカテゴリを列挙し、代替を検討できるようにする

5. セットアップ後の検証（npx コネクターの場合）: ユーザーが認証情報を設定したことを確認したら、接続の検証を提案する:

   • 必要な環境変数がすべて設定され、空でないことを確認する
   • コネクター経由で読み取り専用のテストを実行し、動作を確認することを提案する
   • 成功を報告するか、具体的なガイダンスとともに失敗を診断する

出力

以下を含むコネクターセットアップガイド:

• コネクター情報: 名前、カテゴリ、説明、トランスポート種別（HTTP／npx）、現在のステータス（接続済み／未接続）
• 利用可能になるスキル: このコネクターが有効にするすべてのスキルの一覧と、各スキルが何を行うかの簡単な説明
• セットアップ手順: トランスポート種別に適したステップバイステップのガイド — HTTP の場合は OAuth フロー、npx の場合は認証情報の設定
• 認証情報の要件（npx のみ）: 正確な環境変数名、取得場所、必要な権限
• 設定エントリ（npx のみ）: .mcp.json に追加する正確な JSON ブロック（コピー可能）
• 検証手順: セットアップ後にコネクターが動作していることを確認する方法
• 代替コネクター: ユーザーが検討できる、同じカテゴリの他のコネクター（例:「CRM に HubSpot ではなく Salesforce を希望する場合は、/digital-marketing-pro:connect salesforce を実行してください」）
• 次のステップ: 「/digital-marketing-pro:integrations を実行して、更新された統合ダッシュボードを確認してください」および試すべき関連スキル

使用するエージェント

• 特別なエージェントは必要ありません。このスキルでは connector-status.py スクリプトを直接使用し、コネクターのレジストリに基づいてプラットフォーム固有のガイダンスを提供します