Armavita Meta Ads Mcp

ArmaVita Meta Ads MCP

Claude Code、Codex、またはその他の MCP 対応アシスタントから、Facebook、Instagram、Threads の広告を管理できます。

高速な起動、低いメモリ使用量、幅広い広告機能を備えたローカルサーバーとして構築しました。 キャンペーン、レポート、リードフォーム、カタログ、オーディエンスなどをカバーする125 個のツールを、コンパクトな応答と機密性の高い変更への保護機能とともに提供します。リストを管理しやすくするため、関連するアクションは同じツールにまとめています。

単一の実行ファイルとして動作するため、維持管理が必要な Python 環境は不要です。また、Meta Marketing API v26 を使用します。

**Rust 2.0 リリース候補版：**スモークテストを実施し、社内で十分に使用しています。 問題が発生した場合は、ご報告ください。

できること

領域	機能
広告	キャンペーン、広告セット、クリエイティブ、プレビュー、予算、スケジュール、配信状況の確認
レポート	インサイト、フィルター、アトリビューション設定、内訳、非同期レポート、変更履歴
リード	インスタントフォームの作成とアーカイブ、送信内容の取得、テスト用リード、Webhook サブスクリプションの管理
オーディエンス	カスタムオーディエンスと類似オーディエンス、保存済みオーディエンスの検索、ターゲティング、アップロード、共有
自動化	ルール、A/B テスト、価値ルール、推奨事項
カタログ	商品、セット、フィード、一括更新、診断、カタログ広告の設定
クリエイティブアセット	アカウントとページのメディア、プレイアブル、ラベル、インスタントエクスペリエンス
エンゲージメント	Facebook／Instagram 広告のコメント、およびサポート対象の Threads 広告への返信
測定とアクセス	ピクセル、データセット、CAPI、カスタムコンバージョン、ビジネスアセット、権限、パブリッシャーのブロックリスト

Meta の権限とアカウントの利用条件は引き続き適用されます。セットアップと制限。

Rust で再構築した理由

より高速な起動、低いメモリ使用量、維持管理が必要な Python 環境のない単一の実行ファイルを実現するため、Python サーバーを再構築しました。

指標	Python	Rust	改善
起動時間	512 ms	8.17 ms	約 63 倍高速
アイドル時のメモリ	77.84 MiB	16.30 MiB	約 79% 削減
実行時のディスク容量	45.7 MiB	7.97 MiB	約 83% 縮小

最初の再構築時のベースラインです。2026 年 8 月 20 日に macOS arm64 で測定しました。起動時間にはウォーム実行時の中央値を使用しています。このベンチマークでは、ツール定義の読み込みにより時間がかかりました。測定結果と方法の詳細。

再構築では、ツール呼び出しに認証情報を含めないようにし、適用前に確認できる書き込みプランも追加しました。Python 版からの変更点。

はじめに

1. インストール

ソースからビルドするには、Rust 1.98.0、C/C++ コンパイラー、CMake が必要です。rust ブランチのチェックアウト、または展開済みのソースリリースから、次を実行します。

cargo install --locked --path .

2. 認証

MCP クライアントの起動に使用する環境で、META_ACCESS_TOKEN を設定します。トークンには、適切な Meta 権限と、管理する広告アカウントへのアクセス権が必要です。

代わりにブラウザーログインを使用する場合は、META_APP_ID と META_APP_SECRET を設定してから、次を実行します。

armavita-meta-ads-mcp --login

ブラウザーログインでは、macOS/Linux 上に非公開のローカルトークンキャッシュが保存されます。Windows では META_ACCESS_TOKEN を使用してください。認証情報をプロンプトやコミット対象の設定ファイルに記載しないでください。

3. アシスタントを接続

JSON MCP 設定を使用するクライアントでは、次を追加します。

{
  "mcpServers": {
    "meta-ads-armavita": {
      "command": "armavita-meta-ads-mcp",
      "args": ["--transport=stdio"]
    }
  }
}

Claude Code では、付属の.mcp.jsonを使用できます。Codex では、TOML 設定例を使用してください。

セットアップガイドの全文：権限、認証、クライアント設定、メディアのアップロード。

ライブ広告を変更する前に

MCP クライアントで書き込みの承認を有効にしておいてください。適用する前に変更計画を確認してください。 削除には明示的な承認が必要です。サーバーが書き込みを自動的に再試行することはありません。

ローカルからのアップロードはデフォルトで無効になっています。有効にするには、管理下にあるフォルダーを META_MEDIA_ROOT に設定してください。 詳細については、セキュリティガイダンスをご覧ください。

Python 版から移行する場合、ツール名、入力、結果の一部が変更されています。 切り替える前に移行ガイドをお読みください。

ライセンス

Copyright (c) ArmaVita LLC. GNU AGPLv3 only (AGPL-3.0-only). 無保証で配布されています。