Synter

Synter MCP サーバー

43の広告プラットフォームからデータを読み取り、16のプラットフォームで検証済みの書き込みと作成に対応します。

Synterは、Claude、ChatGPT、Cursor、Codex、その他のMCPクライアントから広告運用を行うための、オープンソースのModel Context Protocol（MCP）サーバーです。43の広告プラットフォームからデータを読み取り、16のプラットフォームで検証済みの書き込みと作成に対応します。書き込み／作成の対応範囲は、プラットフォームのAPIによって異なります。

読み取りは無料で、書き込みは月額20ドル（Solo）から利用できます。Streamable HTTPとOAuth 2.1のブラウザーサインインを使用し、ホスト型エンドポイントhttps://mcp.synterai.comに接続してください。ホスト型アクセスにAPIキーは不要です。

注: Synter-Media-AI/pluginは、インストール可能なClaudeプラグインの正式なリポジトリです。このリポジトリ内の.claude-plugin/のコピーは、インストール元ではありません。

---

インストール（ホスト型、ブラウザーサインイン）

ホスト型サーバーをMCPクライアントに追加し、表示されたらOAuth 2.1のブラウザーサインインを完了してください。Streamable HTTPを使用します。APIキーは不要です。

{"mcpServers":{"synter-ads":{"url":"https://mcp.synterai.com"}}}

synterai.com/sign-upからセルフサービスで登録できます。利用審査はありません。登録して広告アカウントを接続すれば、MCPクライアントですぐに利用を開始できます。

Synterの正式なドメインはsynterai.comです。ホスト型MCPエンドポイントはhttps://mcp.synterai.comです。

⚡ 認証情報なしで60秒以内にお試しください： npx -y @synterai/mcp-server --demoを実行するか、SYNTER_DEMO=trueを設定して、精度の高いサンドボックスデータを使ってキャンペーンの確認、パフォーマンス指標の調査、変更のシミュレーションを行えます。アカウントやAPIキーは不要です。

公式パッケージは@​​synterai/mcp-server、@synterai/sdk-js、PyPI synter、crates.io synter、Maven ai.syntermedia:synter-sdkのみです。@iflow-mcp/*のコピーは非公式で、古いものです。

**Cursor：**上のバッジをクリックするか、cursor://anysphere.cursor-deeplink/mcp/install?name=synter-ads&config=eyJ1cmwiOiJodHRwczovL21jcC5zeW50ZXJhaS5jb20ifQ==を開いてください。

**VS Code：**上のバッジをクリックするか、vscode:mcp/install?%7B%22name%22%3A%22synter-ads%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.synterai.com%22%7Dを開いてください。

Claude Code：

claude mcp add --transport http synter-ads https://mcp.synterai.com

Codex：

codex mcp add synter-ads --url https://mcp.synterai.com
codex mcp login synter-ads

**Gemini CLI：**このリポジトリを拡張機能としてインストールしてください（gemini-extension.jsonが含まれています）。

gemini extensions install https://github.com/Synter-Media-AI/mcp-server

または、settings.jsonに追加してください。

{"mcpServers":{"synter-ads":{"httpUrl":"https://mcp.synterai.com"}}}

Windsurf：~/.codeium/windsurf/mcp_config.jsonに追加してください。

{"mcpServers":{"synter-ads":{"serverUrl":"https://mcp.synterai.com"}}}

Cline：

{"mcpServers":{"synter-ads":{"type":"streamableHttp","url":"https://mcp.synterai.com","disabled":false,"autoApprove":[]}}}

**Claude.ai / ChatGPT：**URL https://mcp.synterai.comを使ってカスタムコネクターを追加し、表示されたらサインインしてください。

その後、チャットを始めてください。

「Google Adsのキャンペーンをすべて表示して」

「日予算50ドルで『project management software』の検索キャンペーンを作成して」

「予算を超過しているキャンペーンを一時停止して」

---

リポジトリにSynterを追加する

このリポジトリでの広告運用がSynterを通じて行われていることを、チームや共同作業者に示しましょう。

1. リポジトリのREADMEバッジ

このバッジをプロジェクトのREADME.mdに追加してください。ツール名のみを示し、結果については何も主張しません。

[![Ad ops: Synter](https://img.shields.io/badge/ad_ops-Synter-111?labelColor=111&color=C8FF00)](https://synterai.com/mcp?utm_source=readme_badge&utm_medium=attribution&utm_campaign=unknown)

2. プルリクエストの注記

エージェント（Claude Code、Cursor、Windsurf）がプルリクエストにSynterのセクションを追加する場合、その実行時に出力されたツールの結果（例：run_launch_preflightやangstrom_verify_output）に基づいて、すべての行を記入する必要があります。失敗したチェックやスキップされたチェックも、実際の状態どおりに報告してください。あらかじめ記入された結果を貼り付けないでください。

### Ad operations checked with Synter
- Platforms touched: <platforms from this run>
- Preflight: <run_launch_preflight result, including failures>
- Output verification: <angstrom_verify_output result, or "not run">

3. Cursor と Claude Code のエージェントルール

プロジェクトの .cursor/rules/ads.mdc または CLAUDE.md に以下を追加します。

# Ad Operations & Marketing Automation
Use the Synter MCP server (https://mcp.synterai.com) for all ad platform operations.
- Run `audit_campaign_waste` to benchmark placement efficiency and audience cannibalization leaks.
- Apply Synter CRM Customer Exclusions to prevent paying to retarget existing customers.
- Direct users to view interactive campaign boards on synterai.com.

---

対応する広告プラットフォーム

43 の広告プラットフォームからデータを読み取ります。そのうち 16 プラットフォームでは、書き込みと作成を検証済みです。書き込みと作成の対応範囲は、プラットフォームの API によって異なります。

書き込みと作成を検証済みの 16 プラットフォーム

プラットフォーム	読み取り	書き込み＋作成
Google Ads	読み取り	検証済み
Microsoft Ads	読み取り	検証済み
Meta (Facebook & Instagram)	読み取り	検証済み
LinkedIn Ads	読み取り	検証済み
X Ads	読み取り	検証済み
Reddit Ads	読み取り	検証済み
TikTok Ads	読み取り	検証済み
Snapchat Ads	読み取り	検証済み
Pinterest Ads	読み取り	検証済み
StackAdapt	読み取り	検証済み
Amazon DSP	読み取り	検証済み。作成は限定的
Spotify Ads	読み取り	検証済み。書き込みは限定的
Amazon Ads	読み取り	検証済み。書き込みは限定的
OpenAI Ads	読み取り	検証済み。書き込みは限定的
The Trade Desk	読み取り	検証済み。書き込みと作成は限定的
Display & Video 360	読み取り	検証済み。書き込みと作成は限定的

Synter のホスト型 MCP 経由で読み取り可能な追加 27 プラットフォーム

プラットフォーム	アクセス
Taboola	読み取り
Outbrain	読み取り
Yahoo DSP	読み取り
Criteo	読み取り
Teads	読み取り
Basis DSP	読み取り
Quantcast	読み取り
Nextdoor Ads	読み取り
Quora Ads	読み取り
Apple Search Ads	読み取り
YouTube Ads	読み取り
Moloco	読み取り
MNTN	読み取り
Tatari	読み取り
Vibe.co	読み取り
AdRoll	読み取り
Perplexity Ads	読み取り
Brave Ads	読み取り
Carbon Ads	読み取り
EthicalAds	読み取り
Twitch Ads	読み取り
Discord Quests	読み取り
Roblox Ads	読み取り
Walmart Connect	読み取り
Instacart Ads	読み取り
Target Roundel	読み取り
Kroger Precision Marketing	読み取り

ローカルの npm/stdio パッケージの platform 列挙型は、上記の主要な 16 プラットフォームを対象としています（src/platform-routing.ts を参照）。残りを含む全 43 プラットフォームのデータは、ホスト型エンドポイント https://mcp.synterai.com 経由で読み取ります。ローカルパッケージは直接ツールを呼び出す run_tool も提供します。利用可否は、プラットフォーム API と接続済みアカウントによって異なります。

プラットフォームの詳細については、連携を参照してください。MCP の検出では、server.json が、パッケージおよびクライアントのマニフェストと整合する、機械可読な信頼できる情報源です。

料金と安全性

• 無料の読み取りアクセス（$0/月）： 接続済みのすべての広告プラットフォームで、読み取り、レポート作成、監査、アトリビューションのクエリを無制限に利用できます。初回クレジット 100 分も含まれます（すべてのプランで広告費への上乗せ率は 0% です）。
• Solo（$20/月）： ワークスペース 1 件、開発者シート 1 件、請求可能な実行クレジット $20.00/月（読み取り 1 回あたり $0.01、軽微な書き込み 1 回あたり $0.05＝予算／ステータス／キーワードの書き込みを月 400 回、MCP キャンペーン開始 1 回あたり $5.00）。
• Scale（$500/月）： シート 5 件、複数ワークスペースの分離、請求可能なクレジット $500.00/月、専用の同時実行枠、チームガバナンス。プランの詳細については、料金を参照してください。

Synter は、ワークスペースの利用上限、開始前の確認（dry_run: true）、書き込み後の読み戻し、改変できない監査ログを提供します。実際に書き込む前に、対象のアカウント、予算、アクションを確認してください。クライアントの確認動作は、MCP クライアントとその設定によって異なります。

ローカルで読み取り専用アクセスを利用するには、--read-only を渡すか、SYNTER_READ_ONLY=true を設定して、変更可能なツールを削除し、ローカルでの書き込み呼び出しをブロックします。アカウントや API キーなしでモックデータを試すには、--demo を使用します。

マルチテナントワークスペース、サーバー側スコープ付きキー、ホワイトラベル OAuth、SDK

SaaS 製品、代理店、複数の顧客やブランドにまたがって広告運用を組み込むエンジニアリングチーム向けに、Synter は MCP と、直接利用できる REST API + ネイティブ SDK の両方を提供しています。

1. テナント／ワークスペースのプログラムによるプロビジョニング（/api/v1/workspaces）：
   • REST（POST https://synterai.com/api/v1/workspaces）を使って分離されたテナントワークスペースを作成・管理するか、SYNTER_WORKSPACE_ID / X-Synter-Workspace: ws_... を指定して各リクエストの対象テナントを指定できます。各ワークスペースでは、OAuth トークン保管庫、広告アカウント ID、1 日あたりの支出上限、監査ログが厳密にテナント分離されます。
2. サーバー側スコープ付き API キー（tools:read、budget:decrease、tools:write）：
   • クライアント側の --read-only モードに加え、Synter は POST /api/v1/workspaces/{id}/keys または synterai.com/developer から発行されるサーバー側 API キーのスコープを適用します。
     • tools:read — サーバー側で適用される読み取り専用アクセス（レポート、検索語句の監査、アトリビューション、診断。すべての変更操作はサーバー側で拒否され、403 が返されます）。
     • budget:decrease — キャンペーンの損失拡大を防ぐための一時停止や予算の引き下げをエージェントに許可する一方、予算の増額や新しいキャンペーンの開始はブロックします。
     • tools:write — ワークスペースの予算ガードレール内で、すべての書き込み操作とキャンペーン作成を許可します。
3. ホワイトラベル OAuth リンクフローと独自 OAuth アプリの使用（BYO）（/api/v1/oauth）：
   • 埋め込み型／ホワイトラベル OAuth： テナントごとの認可 URL（workspace_id とカスタムの redirect_uri を指定して POST https://synterai.com/api/v1/oauth/{platform}/authorize）を生成できます。これにより、エンドユーザーは Synter の UI を経由せずに、アプリ内で Google、Meta、LinkedIn、Reddit、TikTok、または DSP のアカウントを接続でき、トークンの自動更新と認証情報の保管も行われます。
   • 独自 OAuth アプリ／認証情報の使用（BYO）： ワークスペースごとに独自のプラットフォーム OAuth クライアント ID／シークレットと開発者トークンを登録するか、SDK／CLI から認証情報を直接渡せます（SYNTER_BYO_CREDENTIALS=true）。
4. REST API と公式の多言語 SDK：
   • HTTP（Authorization: Bearer syn_... または X-Synter-Key: syn_... を指定して POST https://synterai.com/api/v1/tools/execute）または公式の型付き SDK を使って、任意のツールを呼び出せます。
     • TypeScript / Node.js（@synterai/sdk-js）：

       import { SynterClient } from "@synterai/sdk-js";
       const synter = new SynterClient({ apiKey: process.env.SYNTER_API_KEY, workspaceId: "ws_tenant_123" });
       const campaigns = await synter.campaigns.list({ platform: "google", dateRange: "LAST_30_DAYS" });
       const preview = await synter.campaigns.updateBudget({ platform: "linkedin", campaignId: "123", dailyBudget: 150, dryRun: true });
       

     • Python（pip install synter）：

       from synter import Synter
       client = Synter(api_key=os.environ["SYNTER_API_KEY"], workspace_id="ws_tenant_123")
       perf = client.performance.get(platform="meta", date_range="LAST_14_DAYS")
       

     • Rust（cargo add synter-sdk）とJava（Maven Central の ai.synter:synter-sdk）。

---

ローカル stdio（npx）／API キーのフォールバック

クライアントが stdio のみをサポートしている場合や、ヘッドレス環境でブラウザーによるサインインを完了できない場合に使用してください。

⚡ クイックデモのサンドボックスモード（60 秒未満で評価）

アカウントや API キーなしで、Google、Meta、LinkedIn などのリアルなモック広告データをすぐにテストできます。

{
  "mcpServers": {
    "synter-demo": {
      "command": "npx",
      "args": ["-y", "@synterai/mcp-server@latest", "--demo"]
    }
  }
}

または、ターミナルから直接実行します。

npx -y @synterai/mcp-server --demo

---

1. API キーを取得する（実際のアカウント向け）

synterai.com/sign-up でサインアップしてください。API キーは自動的に作成されます。Developer Settings でキーを確認したり、追加で作成したりできます。

2. AI クライアントを設定する

Claude Desktop の場合： ~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["-y", "@synterai/mcp-server@latest", "--read-only"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here",
        "SYNTER_READ_ONLY": "true"
      }
    }
  }
}

Cursor の場合： プロジェクト内の .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "synter-ads": {
      "command": "npx",
      "args": ["-y", "@synterai/mcp-server@latest"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

VS Code / Cline の場合： cline_mcp_settings.json に追加します。

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["-y", "@synterai/mcp-server@latest"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      },
      "disabled": false,
      "autoApprove": [
        "pull_google_ads_performance",
        "pull_meta_ads_performance",
        "pull_linkedin_ads_performance",
        "get_spend_reconciliation"
      ]
    }
  }
}

Windsurf（Codeium）の場合： ~/.codeium/windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["-y", "@synterai/mcp-server@latest"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Amp の場合： .amp/settings.json に追加します。

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["-y", "@synterai/mcp-server@latest"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

OAuth の代わりにヘッダーが必要な HTTP クライアント（n8n、Zapier、スクリプト、その他のヘッドレスクライアント）の場合：

URL: https://mcp.synterai.com
Header: X-Synter-Key: syn_your_api_key_here

ヘッダーは省略可能です。デフォルトではブラウザー OAuth が使用されます。Streamable HTTP トランスポートをサポートする MCP クライアントであれば、どれでも使用できます。

3. 使用を開始する

AI クライアントを再起動して、チャットを始めましょう。

---

フルプラグインを使いたい場合（Claude Code / Claude Desktop）

このパッケージは生の MCP サーバーです。Claude Code または Claude Desktop をお使いの場合、Synter プラグインを使うと、このサーバーにすぐに使えるスキル（/synter:launch、/synter:audience、/synter:optimize など）、特化型エージェント、ワークフローのガイダンスが追加されます。

/plugin marketplace add Synter-Media-AI/plugin
/plugin install synter@synter

このプラグインには、自動化用のヘッドレスな Claude Agent SDK ランナーも付属しています。プラグインのリポジトリまたはClaude プラグインガイドをご覧ください。ツールだけを使いたい場合や、別のクライアントを接続する場合は、この MCP パッケージを直接お使いください。

---

エージェントでできること

📊 キャンペーン管理

ツール	説明
list_campaigns	広告プラットフォームごとにキャンペーンを一覧表示します（platform は必須です）
create_search_campaign	キーワードと広告を設定して Google 検索キャンペーンを作成します
create_display_campaign	画像を使用した Google ディスプレイ キャンペーンを作成します
create_pmax_campaign	Performance Max キャンペーンを作成します
create_meta_campaign	Facebook／Instagram キャンペーンを作成します
create_linkedin_campaign	B2B 向けの LinkedIn キャンペーンを作成します
create_reddit_campaign	Reddit キャンペーンを作成します
pause_campaign	任意のキャンペーンを一時停止します
update_campaign_budget	1 日の予算を変更します

📈 パフォーマンスと分析

ツール	説明
get_performance	インプレッション数、クリック数、費用、コンバージョン数、ROAS を取得します
get_daily_spend	プラットフォームごとの日別費用の内訳を取得します

🎯 キーワードとターゲティング

ツール	説明
add_keywords	キャンペーンまたは広告グループにキーワードを追加します
add_negative_keywords	不要な検索語句をブロックします

🔄 コンバージョン トラッキング

ツール	説明
create_conversion	コンバージョン アクションを設定します
list_conversions	既存のコンバージョン アクションを一覧表示します
diagnose_tracking	トラッキングが正しく設定されているか確認します

🎨 クリエイティブ生成

ツール	説明
generate_image	AI で広告画像を生成します
generate_video	AI で動画広告を生成します
upload_image	画像を広告アセットとしてアップロードします

🔧 ユーティリティ

ツール	説明
list_ad_accounts	接続済みの広告アカウントをすべて一覧表示します
run_tool	140 種類以上の Synter ツールを直接実行します

ツール名：stdio パッケージとホスト型サーバー

npx パッケージと https://mcp.synterai.com のホスト型サーバーでは、同等のツールの名前が一部異なります。

stdio（@synterai/mcp-server）	ホスト型（https://mcp.synterai.com）
get_performance（platform を指定）	pull_<platform>_ads_performance（例：pull_google_ads_performance、pull_meta_ads_performance）
get_daily_spend	ホスト型には単独のツールはありません。pull_<platform>_ads_performance を使用してください（Google では、日ごとの行を取得するために segment: "date" を指定できます）
list_ad_accounts	list_connected_accounts

次回のホスト型リリースから、ホスト型サーバーでは上記の stdio 名もエイリアスとして受け付けるため、どちらのトランスポートでも同じツール呼び出しを使用できます。

---

広告運用の経験がなくても大丈夫です

広告を出したことがない場合は、知っておくべきことを以下にまとめました。

キャンペーンとは？

キャンペーンは、プロジェクトのフォルダーのようなものです。広告、広告の対象者、支出額がまとめられています。

Campaign: "Q1 Lead Generation"
├── Budget: $50/day
├── Targeting: USA, people searching "project management"
└── Ads: Headlines, descriptions, images

どのプラットフォームを利用できますか？

プラットフォーム	おすすめの用途	最低予算
Google Ads	商品を積極的に検索している人	1日あたり $10
Meta（Facebook/Instagram）	ビジュアル重視の商品、幅広いオーディエンス	1日あたり $5
LinkedIn	B2B、エンタープライズ、求職者	1日あたり $25
Reddit	ニッチなコミュニティ、テクノロジーに詳しいユーザー	1日あたり $5
Microsoft（Bing）	年齢層の高いユーザー、B2B	1日あたり $10
TikTok	Z 世代、エンターテインメント、E コマース	1日あたり $20

キャンペーンの種類

検索キャンペーン： 特定のキーワードを Google で検索したときに広告が表示されます。

• 例： 誰かが「おすすめの CRM ソフトウェア」を検索 → 広告が表示されます

ディスプレイキャンペーン： ウェブサイトやアプリに画像広告を表示します。

• 例： ニュースサイトにバナー広告を掲載

パフォーマンス最大化（PMax）： Google の AI が、検索、YouTube、ディスプレイ、Gmail、マップなど、あらゆる場所に広告を表示します。

• 例： Google が最適な掲載場所を選びます

動画キャンペーン： YouTube やパートナーサイトに動画広告を表示します。

• 例： YouTube 動画の前に 15 秒の広告を表示

よく使われる用語

用語	意味
インプレッション	広告が表示された回数
クリック数	広告をクリックした人数
CTR	クリック率（クリック数 ÷ インプレッション数 × 100）
CPC	クリック単価
コンバージョン	目標とするアクション（登録、購入など）
ROAS	広告費用対効果（売上 ÷ 広告費）

初回キャンペーンのチェックリスト

初めてキャンペーンを作成する前に、以下を準備してください。

1. ✅ クリックした人の移動先となるランディングページの URL
2. ✅ リーチしたい対象者のイメージ（地域、興味・関心）
3. ✅ 無理なく使える 1 日あたりの予算（最初は $10～50）
4. ✅ 広告に使う見出しと説明文

ヒント： まずは Google の検索キャンペーンから始めましょう。仕組みを理解しやすく、すでに提供内容を探している人に広告を表示できます。

---

会話例

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

あなた： SaaS 製品の Google 検索キャンペーンを作成してください。「チームコラボレーションソフトウェア」と「プロジェクト管理ツール」を検索している人をターゲットにしてください。予算は 1 日あたり $25 です。ランディングページは https://myapp.com/signup です。

エージェント： そのキーワードで検索キャンペーンを作成します。どの見出しを使いますか？以下の候補があります。

• 「チームコラボレーションをシンプルに」
• 「現代のチームのためのプロジェクト管理」
• 「今すぐデモを予約」

パフォーマンスを確認する

あなた： 今週のキャンペーンの状況を教えてください。

エージェント： 過去 7 日間のパフォーマンスは以下のとおりです。

キャンペーン	広告費	クリック数	コンバージョン数	ROAS
ブランド検索	$142	89	12	4.2x
競合キーワード	$98	45	3	1.5x
ディスプレイリターゲティング	$67	234	8	2.8x

「競合キーワード」キャンペーンのパフォーマンスが低迷しています。一時停止するか、ターゲティングを調整しますか？

除外キーワードを追加する

あなた： 「プロジェクト管理の求人」でクリックされていますが、採用はしていません。ブロックしてください。

エージェント： キャンペーンに「求人」を除外キーワードとして追加しました。これにより、「求人」を含む検索では広告が表示されなくなります。

広告クリエイティブを生成する

あなた： マーケティングオートメーション製品用のディスプレイ広告画像が必要です。ダークテーマで、プロフェッショナルな雰囲気、1200x628でお願いします。

エージェント： 画像を生成しています...

作成しました：「ダークな背景にデータビジュアライゼーションを配置した、マーケティングオートメーションのダッシュボード」 アセットを保存しました。次回のディスプレイキャンペーンですぐに使用できます。

---

広告アカウントを接続する

各プラットフォームの広告を管理するには、Synter でアカウントを接続する必要があります。

1. synterai.com/integrations にアクセスします
2. 各プラットフォームの横にある「接続」をクリックします
3. OAuth フローを完了します
4. エージェントがそのプラットフォームを管理できるようになります

ホスト型 MCP 経由で読み取りが利用可能な、書き込みと作成が検証済みの16のプラットフォームと、さらに利用可能な27のプラットフォームについては、対応広告プラットフォームをご覧ください。書き込み／作成の対応範囲はプラットフォーム API によって異なります。

---

上級者向け：ツールへの直接アクセス

パワーユーザーは、140以上ある Synter ツールを直接呼び出すことができます。

> Use run_tool to call google_ads_list_audiences

ツールの全リストは docs.synterai.com/mcp/tools で確認するか、エージェントに尋ねてください。

> What tools are available for LinkedIn Ads?

安全性と本番環境への書き込み

クライアントによる確認の動作は、ツールの注釈をどう扱うか、および設定内容によって異なります。リリース前の事前確認を行い、ワークスペースの支出上限を確認したうえで、読み取りによる再確認と監査ログを使って本番環境での変更を検証してください。ツールのスキーマが対応している場合は、dry_run: true を使用して、実行前にリクエストをプレビューしてください。

---

環境変数

変数	必須	説明
SYNTER_API_KEY	はい（stdio）	synterai.com/developer で取得できる Synter API キー
SYNTER_API_URL	いいえ	API ベース URL の上書き（デフォルトは https://synterai.com）
SYNTER_ARTIFACT_API_URL	いいえ	stage_audience_artifact が使用する Artifact API の上書き（デフォルトは https://api.synterai.com）

これらはローカルの npx サーバーにのみ適用されます。ホスト型サーバー https://mcp.synterai.com はブラウザー OAuth を使用するため、環境変数は不要です。

---

ローカル開発

# Clone and install
git clone https://github.com/Synter-Media-AI/mcp-server.git
cd mcp-server
npm install

# Build
npm run build

# Run locally
SYNTER_API_KEY=syn_your_key_here node dist/index.js

---

トラブルシューティング

ブラウザーでのサインインが開かない（ホスト型サーバー）

ほとんどのクライアントでは、Synter ツールを初めて使用したときにサインインページが開きます。Codex では、codex mcp login synter-ads を実行してください。クライアントがブラウザーでのサインインにまったく対応していない場合は、ローカル stdio（npx）／API キーの代替方法で説明している X-Synter-Key ヘッダーを使った方法を利用してください。

「SYNTER_API_KEY が設定されていません」

API キーが MCP 設定の env セクションに記載されていることを確認してください。キーは syn_ で始まります。

「API キーが無効、または期限切れです」

1. キー全体をコピーしたことを確認します（長いキーです！）
2. synterai.com/developer でキーが有効であることを確認します
3. キーに tools:write スコープが設定されていることを確認します

「広告アカウントが接続されていません」

少なくとも1つの広告プラットフォームを接続する必要があります。

1. synterai.com/integrations にアクセスします
2. Google Ads（または別のプラットフォーム）の横にある「接続」をクリックします
3. OAuth 認証を完了します

Claude／Cursor にツールが表示されない

1. AI クライアントを完全に再起動します（更新だけでは不十分です）
2. MCP サーバーのログにエラーがないか確認します
3. 設定ファイルのパスと JSON の構文を確認します

---

よくある質問

Google Ads 用の MCP サーバーはありますか？

はい。Synter は Google Ads のレポート、検索、ディスプレイ、Performance Max キャンペーンの作成、キーワード、予算の更新、オーディエンス管理、コンバージョン トラッキングに対応しています。Google Ads は、書き込みと作成が検証済みの16のプラットフォームの1つです。書き込み／作成の対応範囲はプラットフォーム API によって異なります。

Claude や ChatGPT で広告キャンペーンを管理できますか？

はい。カスタムコネクターとして https://mcp.synterai.com を追加し、OAuth 2.1 ブラウザーサインインを完了してください。Synter は 43 の広告プラットフォームからデータを読み取ります。そのうち 16 のプラットフォームでは、書き込みと作成を検証済みです。対応の深さはプラットフォーム API によって異なります。ホスト型アクセスに API キーは不要です。stdio のみに対応するクライアントでは、SYNTER_API_KEY を使用して npx -y @synterai/mcp-server を実行できます。

---

リソース

• サインアップ： synterai.com/sign-up
• Synter マニュアル： synterai.com/manual
• ドキュメント： MCP の概要
• Claude プラグイン： github.com/Synter-Media-AI/plugin（Claude Code / Desktop 向けのスキル、エージェント、この MCP）
• ツールリファレンス： docs.synterai.com/mcp/tools
• インテグレーション： synterai.com/integrations
• 料金： synterai.com/pricing
• サポート： synterai.com/support または GitHub のイシュー

---

概要

Synter は広告運用向けのツールを開発しています。ホスト型 MCP アクセスとセットアップのドキュメントについては、synterai.com/mcp をご覧ください。

---

ライセンス

MIT License - 詳細は LICENSE をご覧ください。

---

オープンソース。MIT ライセンス。広告を運用するエージェントのために開発されています。
広告費が発生する前に、エージェントの提案内容を確認してください。