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 パッケージがないサービスでは、カスタム MCP サーバーが必要です。不明な場合は、まず既成の選択肢を検索します
• 利用可能な認証情報：サービスで必要となる API キー、アクセストークン、OAuth クライアント ID、その他の認証情報です。ユーザーは事前に用意しておく必要があります。システムは使用する環境変数名と保存場所を指定しますが、会話内にシークレットを貼り付けるようユーザーに求めることはありません

プロセス

1. ブランドのコンテキストを読み込む：~/.claude-marketing/brands/_active-brand.jsonを読み込み、有効なスラッグを確認してから、~/.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 サーバーが公開するツールの完全な一覧です。ツール名、説明、必須パラメーター、よく使われる操作の呼び出し例が含まれます
• 次のステップ：新しい連携の使用方法です。利用できる既存のコマンド、使用を促すプロンプトの例、新しい機能を取り入れるために更新すべきワークフローを説明します

使用したエージェント

• execution-coordinator — MCP パッケージの検出と評価、スキーマ検証を伴う設定の生成、診断エラー処理を伴う接続テスト、エージェンシー構成向けの認証情報プロファイルのマッピング、ツール一覧と利用方法の案内を含む連携ドキュメントの作成