Woodpecker MCP Server

Name: Woodpecker MCP Server
Author: Woodpeckerco

ローカル

github.com/Woodpeckercoビジネス・マーケティング13 週間前に更新

リポジトリ

Woodpecker MCP Server について

Woodpecker MCP ServerはAIアシスタントをWoodpeckerに接続し、MCPツールでメールやLinkedInのキャンペーン、見込み客、実績データを管理します。

主な機能

01メールとLinkedInキャンペーンの作成・管理
02見込み客の追加・検索・更新・削除
03A/Bテスト対応のメールシーケンス作成
04キャンペーン指標とレポートの取得
05配信スケジュール、アカウント、代理店企業の設定

活用シーン

01アウトリーチキャンペーンの作成や調整
02キャンペーンへの見込み客の追加
03キャンペーン実績の確認

MCP 対応

MCPクライアントにWoodpeckerのキャンペーン、見込み客、アカウント、分析機能をツールとして公開します。Woodpecker APIキーを使用して接続します。

#coldemail #automation #ai

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "woodpecker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "WOODPECKER_API_KEY",
        "woodpeckerco/woodpecker-mcp-server"
      ],
      "env": {
        "WOODPECKER_API_KEY": "<WOODPECKER_API_KEY>"
      }
    }
  }
}

起動コマンドdocker run -i --rm -e WOODPECKER_API_KEY woodpeckerco/woodpecker-mcp-server

設定が必要な環境変数

WOODPECKER_API_KEYシークレット

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

ociwoodpeckerco/woodpecker-mcp-serverstdio

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Woodpecker MCP サーバー

Woodpecker MCP（Model Context Protocol）との連携により、コールドメールキャンペーンの管理を会話形式で行えます。

AI アシスタントを Woodpecker の強力な自動化プラットフォームに接続すると、自然言語でのやり取りを通じて、メールキャンペーンの作成、管理、最適化ができます。

キャンペーンの一覧表示や基本的なアウトリーチシーケンスの作成など、簡単なコマンドから始めましょう。その後、A/B テスト、複雑なフォローアップシーケンス、詳細な分析レポートなどの高度な機能を段階的に試してみてください。

機能

キャンペーン管理：メールキャンペーンと LinkedIn キャンペーンの作成、更新、実行、一時停止、削除
見込み客の操作：アカウントやキャンペーンへの見込み客の追加、見込み客データの更新と削除、見込み客の検索
メール作成：A/B テスト機能を備えた複数ステップのメールシーケンスを作成
分析とレポート：キャンペーンの統計情報とパフォーマンス指標を取得
アカウント連携：メールアカウントと LinkedIn アカウントをキャンペーンに割り当て
代理店の会社：アクセス可能な会社の一覧表示と、各ツール呼び出しで使用する会社の選択
高度な設定：配信スケジュール、タイムゾーン設定、GDPR への準拠をサポート

インストール

前提条件

連携をセットアップする前に、次のものが揃っていることを確認してください。

Woodpecker アカウント：API & Integration アドオンが有効になっているアカウント
API 認証情報：Woodpecker API キー（アカウント設定で確認できます）
Docker：システムにインストール済みであること（MCP サーバーの実行に必要）https://docs.docker.com/desktop/
AI エージェント：Claude Desktop、Continue.dev、またはその他の MCP 対応 AI プラットフォーム

Woodpecker API キーの取得

Woodpecker アカウントにログインします（https://login.woodpecker.co/）
右上の Marketplace → Integrations → 'API keys' に移動します
Create a key をクリックします

AI エージェントの設定

Claude Desktop

ステップ 1：設定ファイルを探す

Claude Desktop の設定ファイルを探します。

macOS：

~/Library/Application Support/Claude/claude_desktop_config.json

Windows：

%APPDATA%\Claude\claude_desktop_config.json

Linux：

~/.config/Claude/claude_desktop_config.json

ステップ 2：MCP サーバーの設定を追加する

設定ファイルを編集し、Woodpecker MCP サーバーの設定を追加します。

{
    "mcpServers": {
        "woodpecker": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "WOODPECKER_API_KEY",
                "woodpeckerco/woodpecker-mcp-server"
            ],
            "env": {
                "WOODPECKER_API_KEY": "<YOUR_API_KEY>"
            }
        }
    }
}

ステップ 3：Claude Desktop を再起動する

Claude Desktop を完全に終了します
アプリケーションを再起動します
インターフェースで Woodpecker のツールを探します

その他の MCP 対応エージェント

MCP をサポートするその他の AI プラットフォームの場合：

MCP のサポートを確認：AI エージェントが Model Context Protocol をサポートしていることを確認します
認証：環境変数を通じて Woodpecker の API 認証情報（WOODPECKER_API_KEY）を指定します
プロトコル：エージェントがサポートする stdio トランスポートを使用します

検証とテスト

AI エージェントで、次のように質問してみてください。

"What Woodpecker tools do you have access to?"
"List my Woodpecker campaigns"

トラブルシューティング

MCP サーバーに接続できない

症状： AI エージェントから Woodpecker のツールにアクセスできない

解決策：

MCP サーバーの設定で Docker の絶対パス（例：/usr/local/bin/docker）を試します
Docker コンテナが実行中か確認します：docker ps
API キーをテストします：Woodpecker に直接 API リクエストを送信します

API 認証情報が無効

症状： "Unauthorized" または "Invalid API key" エラーが発生する

解決策：

Woodpecker の設定で API キーを再生成します
環境変数を新しいキーで更新します
AI エージェントアプリケーションを再起動します

ツールを利用できない

症状： AI エージェントに Woodpecker の機能が表示されない

解決策：

AI エージェントの MCP サーバー設定を確認します
AI エージェントアプリケーションを再起動します
AI エージェントのログで MCP 接続エラーを確認します

キャンペーンの作成に失敗する

症状： キャンペーンの作成時にエラーが発生する

解決策：

Woodpecker で少なくとも 1 つのメールアカウントが設定されていることを確認します
listMailboxes 関数でメールアカウント ID を確認します
キャンペーンのパラメーターが必須の形式と一致していることを確認します
1 日あたりの登録上限が 0 より大きいことを確認します

使用例

最初のキャンペーンを作成する

"Create a new email campaign with these details:
- Name: Product Demo Outreach
- Subject: Quick demo of our new feature
- Message: Hi {{FIRST_NAME}}, I'd love to show {{COMPANY}} our new feature. Are you available for a 15-minute demo?
- Send Monday-Friday, 9 AM to 5 PM
- Daily limit: 25 prospects
- Use my main email account"

見込み客を一括追加する

"Add these prospects to campaign 12345:
1. John Doe, [email protected], Example Corp, Marketing Director
2. Jane Smith, [email protected], Tech Solutions, CEO
3. Bob Johnson, [email protected], Startup Inc, CTO

Use this personalization for each:
- John: 'I saw your recent blog post about email marketing'
- Jane: 'Congratulations on your recent funding round'
- Bob: 'Your product launch looked impressive'"

キャンペーンを管理する

"Pause campaign 12345 and show me its performance statistics"
"Update campaign 'Product Demo Outreach' to send only 15 prospects per day"
"Add a follow-up email to campaign 12345 that sends 3 days after the first email"

分析とレポート

"Show me statistics for all my running campaigns"
"Which campaign has the highest open rate?"
"Create a summary report of my campaign performance this month"

ベストプラクティス

キャンペーン管理

小規模から始める：規模を拡大する前に、5～10件の見込み客でテストします
パフォーマンスを監視する：統計を定期的に確認します
上限を守る：1日の登録上限を超えないようにします
A/B テスト：最適化のために、複数のメールバージョンを使用します

見込み客データ

データ品質：メールアドレスが有効であることを確認します
パーソナライズ：意味のあるスニペットとカスタムフィールドを使用します
セグメンテーション：タグや業界で見込み客を整理します
コンプライアンス：配信停止リンクを含め、配信停止の希望を尊重します

AI エージェントとのやり取り

具体的に指示する：キャンペーン作成について明確な指示を出します
結果を確認する：実行前にキャンペーンの詳細を確認します
例を使用する：サンプルコンテンツとパーソナライズの例を含めます
自動化を監視する：AI が生成したキャンペーンを展開前に確認します

サポート

Woodpecker サポートから Woodpecker サポートチームにお問い合わせください。

ライセンス

この Docker イメージは、個人および商用目的で使用することが許可されています。再配布、改変、リバースエンジニアリングは禁止されています。保証は提供されません。

利用可能なツール

代理店アカウントの場合は、listCompaniesを使用して会社 ID を取得します。その会社に対する各ツール呼び出しで、その companyIdを渡してください。API キーで表されるメインアカウントを使用する場合は、companyIdを省略します。会社の選択は呼び出し間で引き継がれません。

キャンペーンとステップの作成では、deliveryTimesにdeliveryDays （MONDAYからSUNDAYまでの曜日名の配列）、deliveryTimeStart、および deliveryTimeStop（09:30などの時刻）が含まれます。 followupAfterには、range（DAY、HOUR、またはMINUTE）とvalue （数値）が含まれます。メールのversionsには、任意のsubject文字列とbody文字列が含まれます。本文は、htmlタグやbodyタグで囲まれていない HTML です。

キャンペーン管理

`createEmailCampaign`

最小限の設定で、1つのメールステップを含む Woodpecker メールキャンペーンを作成します。

パラメーター：

companyId（数値、任意）：listCompaniesで取得した代理店の会社 ID。現在のアカウントを使用する場合は省略します
name（文字列、任意）：キャンペーン名
timezone（文字列、任意）：キャンペーンのタイムゾーン（省略した場合はユーザーのタイムゾーンがデフォルトになります）
dailyEnroll（数値、任意）：1日の見込み客登録上限（省略した場合は安全なデフォルト値が使用されます）
emailAccountIds（配列、任意）：SMTP アカウント ID
versions（配列、任意）：メールコンテンツのバージョン（最大5件。省略した場合は空のバージョンが1件使用されます）
deliveryTimes（オブジェクト）：配信時刻
followupAfter（オブジェクト、任意）：次のステップを処理するまでの遅延（省略した場合は1日）

`createLinkedinProfileVisitCampaign`

1つのプロフィール訪問ステップを含む Woodpecker LinkedIn キャンペーンを作成します。

パラメーター：

companyId（数値、任意）：listCompaniesで取得した代理店の会社 ID。現在のアカウントを使用する場合は省略します
name（文字列、任意）：キャンペーン名
timezone（文字列、任意）：キャンペーンのタイムゾーン（省略した場合はユーザーのタイムゾーンがデフォルトになります）
dailyEnroll（数値、任意）：1日の見込み客登録上限（省略した場合は安全なデフォルト値が使用されます）
linkedinAccountId（数値、任意）：LinkedIn アカウント ID
followupAfter（オブジェクト、任意）：次のステップを処理するまでの遅延（省略した場合は1日）

`createLinkedinConnectionRequestCampaign`

接続リクエストのステップが1つあるWoodpecker LinkedInキャンペーンを作成します。

パラメーター：

companyId（number、任意）：listCompaniesで取得した代理店の会社IDです。現在のアカウントを対象にする場合は省略します
name（string、任意）：キャンペーン名
timezone（string、任意）：キャンペーンのタイムゾーンです。省略すると、ユーザーのタイムゾーンがデフォルトで使用されます
dailyEnroll（number、任意）：1日あたりの見込み顧客登録上限です。省略すると、安全なデフォルト値が使用されます
linkedinAccountId（number、任意）：LinkedInアカウントID
followupAfter（object、任意）：次のステップを処理するまでの待機時間です。省略すると1日になります
bodyVersions（array、任意）：接続リクエストメッセージのバージョン（最大5件）。省略すると、空のバージョンが1件使用されます

`createLinkedinDirectMessageCampaign`

ダイレクトメッセージのステップが1つあるWoodpecker LinkedInキャンペーンを作成します。

パラメーター：

companyId（number、任意）：listCompaniesで取得した代理店の会社IDです。現在のアカウントを対象にする場合は省略します
name（string、任意）：キャンペーン名
timezone（string、任意）：キャンペーンのタイムゾーンです。省略すると、ユーザーのタイムゾーンがデフォルトで使用されます
dailyEnroll（number、任意）：1日あたりの見込み顧客登録上限です。省略すると、安全なデフォルト値が使用されます
linkedinAccountId（number、任意）：LinkedInアカウントID
followupAfter（object、任意）：次のステップを処理するまでの待機時間です。省略すると1日になります
bodyVersions（array、任意）：ダイレクトメッセージ本文のバージョン（最大5件）。省略すると、空のバージョンが1件使用されます

`createLinkedinInMailMessageCampaign`

InMailメッセージのステップが1つあるWoodpecker LinkedInキャンペーンを作成します。

パラメーター：

companyId（number、任意）：listCompaniesで取得した代理店の会社IDです。現在のアカウントを対象にする場合は省略します
name（string、任意）：キャンペーン名
timezone（string、任意）：キャンペーンのタイムゾーンです。省略すると、ユーザーのタイムゾーンがデフォルトで使用されます
dailyEnroll（number、任意）：1日あたりの見込み顧客登録上限です。省略すると、安全なデフォルト値が使用されます
linkedinAccountId（number、任意）：LinkedInアカウントID
followupAfter（object、任意）：次のステップを処理するまでの待機時間です。省略すると1日になります
bodyVersions（objectのarray、任意）：任意のsubjectとbody文字列を含むInMailのバージョン（最大5件）。省略すると、件名なし・本文が空のバージョンが1件使用されます

`listCampaigns`

任意のステータスフィルターを指定してキャンペーンを取得します。

パラメーター：

companyId（number、任意）：listCompaniesで取得した代理店の会社IDです。現在のアカウントを対象にする場合は省略します
pageNumber（number）：ページ番号（1から始まります）
statuses（array、任意）：ステータスで絞り込みます（RUNNING、DRAFT、EDITED、PAUSED、STOPPED、COMPLETED）

`retrieveCampaignDetails`

すべてのステップと設定を含む、キャンペーンの詳細な構成を取得します。

パラメーター：

companyId（number、任意）：listCompaniesで取得した代理店の会社IDです。現在のアカウントを対象にする場合は省略します
campaignId（number）：キャンペーンID

`retrieveCampaignStatistics`

キャンペーンのパフォーマンス指標と分析データを取得します。

パラメーター：

companyId（number、任意）：listCompaniesで取得した代理店の会社IDです。現在のアカウントを対象にする場合は省略します
campaignId（number）：キャンペーンID

`updateCampaignSettings`

名前、メールアカウント、1日の上限、タイムゾーンなど、キャンペーン全体の設定を変更します。

パラメーター：

companyId（number、任意）：listCompaniesで取得した代理店の会社IDです。現在のアカウントを対象にする場合は省略します
campaignId（number）：キャンペーンID
name（string、任意）：キャンペーン名
emailAccountIds（array、任意）：メールアカウントIDの一覧
timezone（string、任意）：キャンペーンのタイムゾーン
dailyEnroll（number）：1日あたりの登録上限

`buildCampaignUrl`

キャンペーンにアクセスするためのWoodpeckerアプリのURLを生成します。

パラメーター：

companyId（number、任意）：listCompaniesで取得した代理店の会社IDです。現在のアカウントのURLを生成する場合は省略します
campaignId（number）：キャンペーンID

キャンペーンの操作

各キャンペーン操作ツールでは、代理店の会社を指定するためのオプションの companyId も受け付けます。

runCampaign(campaignId): キャンペーンの実行を開始します
pauseCampaign(campaignId): キャンペーンを一時停止します
stopCampaign(campaignId): キャンペーンを停止します
deleteCampaign(campaignId): キャンペーンを完全に削除します
makeCampaignEditable(campaignId): キャンペーンの変更を可能にします

ステップ管理

`addEmailStep`

キャンペーンにメールのフォローアップステップを追加します。

パラメーター：

companyId (number, optional): listCompanies で取得した代理店の会社 ID。現在のアカウントの場合は省略します
campaignId (number): キャンペーン ID
parentId (string): 親ステップ ID
versions (array, optional): メールコンテンツのバージョン（最大 5 件。省略した場合は空のバージョンを 1 件作成）
deliveryTimes (object): 配信時刻
followupAfter (object, optional): 次のステップを処理するまでの遅延時間（省略した場合は 1 日）

`addLinkedinProfileVisitStep`

キャンペーンに LinkedIn プロフィール訪問のフォローアップステップを追加します。

パラメーター：

companyId (number, optional): listCompanies で取得した代理店の会社 ID。現在のアカウントの場合は省略します
campaignId (number): キャンペーン ID
parentId (string): 親ステップ ID
linkedinAccountId (number, optional): LinkedIn アカウント ID
followupAfter (object, optional): 次のステップを処理するまでの遅延時間（省略した場合は 1 日）

`addLinkedinConnectionRequestStep`

キャンペーンに LinkedIn のコネクションリクエストのフォローアップステップを追加します。

パラメーター：

companyId (number, optional): listCompanies で取得した代理店の会社 ID。現在のアカウントの場合は省略します
campaignId (number): キャンペーン ID
parentId (string): 親ステップ ID
linkedinAccountId (number, optional): LinkedIn アカウント ID
followupAfter (object, optional): 次のステップを処理するまでの遅延時間（省略した場合は 1 日）
bodyVersions (array, optional): コネクションリクエストメッセージのバージョン（最大 5 件。省略した場合は空のバージョンを 1 件作成）

`addLinkedinDirectMessageStep`

キャンペーンに LinkedIn のダイレクトメッセージのフォローアップステップを追加します。

パラメーター：

companyId (number, optional): listCompanies で取得した代理店の会社 ID。現在のアカウントの場合は省略します
campaignId (number): キャンペーン ID
parentId (string): 親ステップ ID
linkedinAccountId (number, optional): LinkedIn アカウント ID
followupAfter (object, optional): 次のステップを処理するまでの遅延時間（省略した場合は 1 日）
bodyVersions (array, optional): ダイレクトメッセージのコンテンツバージョン（最大 5 件。省略した場合は空のバージョンを 1 件作成）

`addLinkedinInMailMessageStep`

キャンペーンに、ステータスが DRAFT または EDITED の場合に LinkedIn InMail メッセージのフォローアップステップを追加します。

パラメーター：

companyId (number, optional): listCompanies で取得した代理店の会社 ID。現在のアカウントの場合は省略します
campaignId (number): キャンペーン ID
parentId (string): 親ステップ ID
linkedinAccountId (number, optional): LinkedIn アカウント ID
followupAfter (object, optional): 次のステップを処理するまでの遅延時間（省略した場合は 1 日）
bodyVersions (array of objects, optional): subject と body の文字列を任意で指定できる InMail のバージョン（最大 5 件。省略した場合は、件名なし、本文が空のバージョンを 1 件作成）

`updateCampaignStep`

ステップの配信時刻とスケジュールを変更します。

パラメーター：

companyId (number, optional): listCompanies で取得した代理店の会社 ID。現在のアカウントの場合は省略します
campaignId (number): キャンペーン ID
stepId (string): ステップ ID
payload (string): 更新された配信設定

`updateEmailStepVersion`

メールのコンテンツ、件名、署名、トラッキング設定を更新します。

パラメーター：

companyId (number, optional): listCompanies で取得した代理店の会社 ID。現在のアカウントの場合は省略します
campaignId (number): キャンペーン ID
stepId (string): ステップ ID
versionId (string): バージョン ID
subject (string): メールの件名
message (string): メール本文（HTML に対応）
signature (string): SENDER または NO_SIGNATURE
trackOpens (boolean): 開封トラッキングを有効にします

`updateLinkedinStepVersion`

LinkedIn の接続リクエスト、ダイレクトメッセージ、または InMail の内容を更新します。

パラメーター：

companyId（number、任意）：listCompanies から取得した代理店の会社 ID。現在のアカウントを使用する場合は省略します
campaignId（number）：キャンペーン ID
stepId（string）：ステップ ID
versionId（string）：バージョン ID
subject（string、任意）：InMail の件名。最大 200 文字で、スニペットは使用できません。他の LinkedIn ステップタイプでは省略します
message（string）：メッセージ本文の内容

`deleteCampaignStep`

キャンペーンからステップを削除します。

パラメーター：

companyId（number、任意）：listCompanies から取得した代理店の会社 ID。現在のアカウントを使用する場合は省略します
campaignId（number）：キャンペーン ID
stepId（string）：ステップ ID

見込み顧客の操作

`addProspectsToDatabase`

キャンペーンに登録せず、新しい見込み顧客をグローバルな見込み顧客リストに追加します。

パラメーター：

companyId（number、任意）：listCompanies から取得した代理店の会社 ID。現在のアカウントを使用する場合は省略します
prospectsPayload（string）：見込み顧客データの JSON 配列

注意事項：

見込み顧客はアカウントに追加されますが、キャンペーンには追加されません
今後のキャンペーン登録に利用できます
キャンペーン作成前に見込み顧客データベースを構築するのに便利です

`addProspectsToCampaign`

連絡先情報とカスタムスニペットを含む見込み顧客を一括で追加します。

パラメーター：

companyId（number、任意）：listCompanies から取得した代理店の会社 ID。現在のアカウントを使用する場合は省略します
campaignId（number）：キャンペーン ID
prospectsPayload（string）：見込み顧客オブジェクトの配列

注意：レスポンス内のDUPLICATE見込み顧客を必ず確認してください。重複データの更新が必要な場合は、updateProspectsInCampaignを使用してください。

`updateProspectsInDatabase`

グローバルデータベース内の既存の見込み顧客を更新するか、存在しない場合は新しい見込み顧客を追加します。

パラメーター：

companyId（number、任意）：listCompanies から取得した代理店の会社 ID。現在のアカウントを使用する場合は省略します
prospectsPayload（string）：更新内容を含む見込み顧客データの JSON 配列

注意事項：

既存の見込み顧客はメールアドレスに基づいて更新されます
メールアドレスが存在しない場合、新しい見込み顧客が追加されます
更新するフィールドのみを含めてください
更新はグローバルに適用されます（これらの見込み顧客を使用するすべてのキャンペーンに影響します）

`updateProspectsInCampaign`

既存の見込み顧客データを更新します（ユーザーからの明示的なリクエストが必要です）。

パラメーター：

companyId（number、任意）：listCompanies から取得した代理店の会社 ID。現在のアカウントを使用する場合は省略します
campaignId（number）：キャンペーン ID
prospectsPayload（string）：更新内容を含む見込み顧客オブジェクトの配列

`listProspectsInDatabase`

特定のキャンペーンに紐づいていない、グローバルな見込み顧客データベースの見込み顧客を一覧表示します。

パラメーター：

companyId（number、任意）：listCompanies から取得した代理店の会社 ID。現在のアカウントを使用する場合は省略します
pageNumber（integer）：ページ番号（1 始まり）

注意事項：

アカウント内のすべての見込み顧客をページ分割して返します
これらの見込み顧客は、任意のキャンペーンに追加できます
見込み顧客データベース全体の管理に便利です

`listProspectsInCampaign`

キャンペーンの見込み顧客をページ分割して取得します。

パラメーター：

companyId（number、任意）：listCompanies から取得した代理店の会社 ID。現在のアカウントを使用する場合は省略します
campaignId（number）：キャンペーン ID
pageNumber（number）：ページ番号（1 始まり）

`searchProspects`

データベース全体から、特定の条件に一致する見込み顧客を検索します。

パラメーター：

companyId（number、任意）：listCompaniesで取得した代理店の会社 ID。現在のアカウントを対象にする場合は省略します
pageNumber（integer）：ページ番号（1 始まり）
searchCriteria（object、任意）：検索フィールド名と文字列値の配列のマッピング
filterCriteria（object、任意）：フィルターフィールド名と文字列値のマッピング

利用可能な検索フィールド：

email - メールアドレス
first_name - 名
last_name - 姓
company - 会社名
organization_id - 組織 ID
industry - 業種
website - ウェブサイト URL
tags - タグ（大文字と小文字を区別し、先頭の # は付けない）
title - 役職
phone - 電話番号
address - 住所
city - 市区町村
state - 州／都道府県
country - 国
snippet1 through snippet15 - カスタムフィールド

利用可能なフィルターフィールド：

id - 見込み顧客 ID のカンマ区切りリスト
status - 見込み顧客のグローバルステータス：ACTIVE、BOUNCED、REPLIED、BLACKLIST、INVALID
campaigns_id - 見込み顧客が登録されているキャンペーン ID のカンマ区切りリスト
contacted - 見込み顧客に連絡したことがあるかどうか
interested - 興味の度合い：INTERESTED、MAYBE-LATER、NOT-INTERESTED、NOT-MARKED

注意：

タグ検索では大文字と小文字が区別されます。タグで検索する際は、先頭に # を付けないでください
検索条件では、同じフィールドの条件は OR、異なるフィールドの条件は AND として扱われます
OPT-OUT の見込み顧客を絞り込むには、「BLACKLIST」ステータスを使用します
複数のフィルター値はカンマで区切ります

`deleteProspects`

データベース全体または特定のキャンペーンから、見込み顧客を完全に削除します。

パラメーター：

companyId（number、任意）：listCompaniesで取得した代理店の会社 ID。現在のアカウントを対象にする場合は省略します
prospectIds（string）：削除する見込み顧客 ID のカンマ区切りリスト
campaignIds（string、任意）：見込み顧客を削除するキャンペーン ID のカンマ区切りリスト

注意：

campaignIdsを指定しない場合：データベース全体から見込み顧客を削除します
campaignIdsを指定する場合：指定したキャンペーンからのみ見込み顧客を削除します
この操作は取り消せません
実行前にユーザーから明示的な確認を得る必要があります
list/search 操作で取得した見込み顧客 ID を使用してください（メールアドレスではありません）

警告： グローバル削除を行うと、すべてのキャンペーンとデータベースから見込み顧客が削除されます。ローカル削除（campaignIdsを指定）は、見込み顧客をグローバルデータベースに残したまま、指定したキャンペーンからのみ削除します。

アカウント管理

`listCompanies`

代理店アカウントで利用できる会社を、最大 50 件まで 1 ページ分一覧表示します。

パラメーター：

pageNumber（integer）：ページ番号（1 始まり）
active（boolean、任意）：アクティブ状態で絞り込みます

`listMailboxes`

キャンペーンに割り当て可能なメールアカウントを取得します。

パラメーター：

companyId（number、任意）：listCompaniesで取得した代理店の会社 ID。現在のアカウントを対象にする場合は省略します
filter（string）：メールボックス一覧の取得に使用するフィルター（SMTP、SMTP_AVAILABLE_FOR_CAMPAIGN、IMAP、ALL）

`listLinkedinAccounts`

キャンペーンに割り当て可能な LinkedIn アカウントを取得します。

パラメーター：

companyId（number、任意）：listCompaniesで取得した代理店の会社 ID。現在のアカウントを対象にする場合は省略します
filter（string）：アカウント一覧の取得に使用するフィルター（ALL、AVAILABLE_FOR_CAMPAIGN）

変更履歴

v0.1.0 (2026-09-16)

Woodpecker のツール全体で代理店の会社選択をサポートし、listCompanies ツールを追加
キャンペーンで利用できるメールボックスの選択を改善
キャンペーンの実行前に追加の検証を必須化
LinkedIn InMail のステップをサポート
さまざまなキャンペーン作成ツールとステップ追加ツールの検証を緩和し、デフォルト値を追加
キャンペーン管理を改善
LinkedIn キャンペーンをサポート
キャンペーン、メールボックス、見込み客の一覧表示で、より詳細な情報を返すようリクエスト
動作の互換性に関する注意： このバージョンでは、代理店の本社とクライアント企業アカウントの構造が導入されました。古い LLM や性能の低い LLM では、これらのアカウント範囲を正しく区別したり、companyId を一貫して渡したりできない場合があり、意図したクライアント企業ではなく現在のアカウントに対してツールが動作する可能性があります。

v0.0.9 (2025-07-28)

内部の改善とバグ修正

v0.0.8 (2025-06-24)

全体の見込み客一覧ツールを追加

v0.0.7 (2025-06-11)

キャンペーン関連ツールを含む初回リリース

ドキュメント

Woodpecker MCP サーバー：https://developers.woodpecker.co/docs/mcp/
Woodpecker API：https://developers.woodpecker.co/docs/
MCP プロトコル：https://modelcontextprotocol.io
Claude Desktop：https://claude.ai/download

Markdown 対応

ログインしてコメント

基本情報

作者: Woodpeckerco
トランスポート: stdio
掲載日: 2025年6月12日
最終更新: 3 週間前

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。