ActiveCampaign MCP Server について
ActiveCampaign APIを通じてレコードやアクティビティを扱うMCPサーバーです。CRMデータ、キャンペーン、自動化、Webhook向けのツールを備え、レート制御と再試行を行います。
主な機能
- 01コンタクトと取引の管理
- 02タグとメーリングリストの操作
- 03自動化の確認とコンタクト登録
- 04キャンペーンとパフォーマンス指標の確認
- 05B2BアカウントとWebhookの管理
- 06自動スロットリングと429応答の再試行
活用シーン
- 01ActiveCampaignのコンタクト検索や更新
- 02パイプラインとステージごとの取引追跡
- 03既存の自動化へのコンタクト登録
- 04キャンペーン指標やWebhook登録の確認
MCP 対応
ActiveCampaign APIの操作をMCPツールとして提供し、API URLとキーで認証します。MCPクライアントから、対応するレコードの読み取りや管理を実行できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
mcp-activecampaign
ActiveCampaign API 向けの本番環境対応 MCP サーバー — コンタクト、案件、自動化、タグ、パイプライン、キャンペーン、カスタムフィールド、アカウント、Webhook 用の33 個のツールを提供します。
185,000 社を超える ActiveCampaign の顧客向けに提供される、初の ActiveCampaign MCP サーバーです。
機能
- コンタクト — コンタクトの一覧表示、取得、作成、更新、削除、検索
- 案件 — パイプラインとステージに対応した、CRM 案件の完全な管理
- タグ — タグの作成と、コンタクトへのタグ付けの管理
- リスト — メーリングリストと登録者数の表示
- 自動化 — 自動化の一覧表示と、ワークフローへのコンタクトの追加
- パイプラインとステージ — 案件パイプラインとそのステージの表示
- カスタムフィールド — フィールドの一覧表示、コンタクトごとの値の取得・設定
- キャンペーン — メールキャンペーンの詳細とパフォーマンス指標の表示
- アカウント — B2B 企業レコードの管理
- Webhook — Webhook サブスクリプションの作成、一覧表示、削除
- レート制限 — 組み込みの 5 req/s スロットル(ActiveCampaign の制限)
- 自動再試行 — 429 応答時に自動で再試行
クイックスタート
インストール
pip install mcp-activecampaign
設定
ActiveCampaign アカウントの Settings > Developer から API URL とキーを取得します。
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json に追加します。
{
"mcpServers": {
"activecampaign": {
"command": "mcp-activecampaign",
"env": {
"ACTIVECAMPAIGN_URL": "https://youraccountname.api-us1.com",
"ACTIVECAMPAIGN_API_KEY": "your-api-key"
}
}
}
}
環境変数
export ACTIVECAMPAIGN_URL="https://youraccountname.api-us1.com"
export ACTIVECAMPAIGN_API_KEY="your-api-key"
mcp-activecampaign
ツール(33)
| カテゴリ | ツール | 備考 |
|---|---|---|
| アカウント | ping | 接続テスト |
| コンタクト | list_contacts, get_contact, create_contact, update_contact, delete_contact, search_contacts | 完全な CRUD と検索 |
| 案件 | list_deals, get_deal, create_deal, update_deal, delete_deal | パイプライン/ステージのフィルターに対応した完全な CRUD |
| タグ | list_tags, create_tag, add_tag_to_contact, remove_tag_from_contact | コンタクトへのタグ付け |
| リスト | list_lists, get_list | メーリングリスト |
| 自動化 | list_automations, get_automation, add_contact_to_automation | 読み取りと登録(API の制限により、自動化は作成できません) |
| パイプライン | list_pipelines, list_stages | 案件パイプラインの構造 |
| カスタムフィールド | list_custom_fields, get_field_values, set_field_value | コンタクトのカスタムデータ |
| キャンペーン | list_campaigns, get_campaign | 読み取り専用(API の制限) |
| アカウント | list_accounts, get_account | B2B 企業レコード |
| Webhook | list_webhooks, create_webhook, delete_webhook | イベントサブスクリプション |
API に関する注意事項
- 認証:
Api-Tokenヘッダーを使用した API キー認証(OAuth は不要) - レート制限:アカウントごとに 5 リクエスト/秒(自動で処理されます)
- ページネーション:オフセット方式 — すべての一覧表示ツールで
limitとoffsetパラメーターを使用できます - 自動化:API 経由では読み取り専用です — 自動化の一覧表示とコンタクトの登録はできますが、ワークフローの作成や編集はできません
- キャンペーン:API 経由ではほぼ読み取り専用です — 詳細と指標を表示できます
開発
git clone https://github.com/AlexlaGuardia/mcp-activecampaign.git
cd mcp-activecampaign
pip install -e ".[dev]"
pytest
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。