gravity-ads-mcp

Gravity 広告主ダッシュボード API 向けのローカル MCP サーバーです。キャンペーンの作成、編集、一時停止、アーカイブ、そしてすべてのレポート取得を、MCP 対応エージェントから行えます。API キーがあなたのマシンから出ることはありません。

Gravity はホスト型 MCP サーバーを https://platform.trygravity.ai/mcp で公開していますが、これは読み取り専用です。このパッケージは、Gravity ダッシュボード API（作成・編集を含む）を npx で実行されるローカル stdio MCP サーバーとしてラップするため、リクエストはあなたのコンピュータから直接 platform.trygravity.ai に送信され、第三者を経由することはありません。

前提条件

• Node.js ≥ 18（node --version で確認）

• npx（npm に同梱、Node に付属）

• Gravity 広告主 API キー — https://app.trygravity.ai の Settings → API Key から取得できます

Related MCP server: Google Ads MCP Worker

クイックスタート

MCP クライアントの設定ファイルに以下を追加してください。your-gravity-api-key を実際のキーに置き換えてください。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）:

{
  "mcpServers": {
    "gravity": {
      "command": "npx",
      "args": ["-y", "gravity-ads-mcp"],
      "env": {
        "GRAVITY_API_KEY": "your-gravity-api-key"
      }
    }
  }
}

Windows ユーザーへ: npx が見つからない場合は、"command": "cmd" と "args": ["/c", "npx", "-y", "gravity-ads-mcp"] を試してください。

Claude Code

プロジェクトのルートに .mcp.json ファイルを作成するか（またはグローバル設定として ~/.claude/mcp.json に追加）:

{
  "mcpServers": {
    "gravity": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "gravity-ads-mcp"],
      "env": {
        "GRAVITY_API_KEY": "your-gravity-api-key"
      }
    }
  }
}

または CLI で追加:

claude mcp add gravity --env GRAVITY_API_KEY=your-gravity-api-key -- npx -y gravity-ads-mcp

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "gravity": {
      "command": "npx",
      "args": ["-y", "gravity-ads-mcp"],
      "env": {
        "GRAVITY_API_KEY": "your-gravity-api-key"
      }
    }
  }
}

opencode

プロジェクトのルートにある opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "gravity": {
      "type": "local",
      "command": ["npx", "-y", "gravity-ads-mcp"],
      "environment": {
        "GRAVITY_API_KEY": "your-gravity-api-key"
      }
    }
  }
}

注: opencode は "environment"（"env" ではなく）を使用します。

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "gravity": {
      "command": "npx",
      "args": ["-y", "gravity-ads-mcp"],
      "env": {
        "GRAVITY_API_KEY": "your-gravity-api-key"
      }
    }
  }
}

その他のクライアント

mcpServers JSON 形式（Claude Desktop と同じ形）をサポートする MCP クライアントは、このサーバーを使用できます。クライアントの MCP 設定ファイルに以下を追加してください:

{
  "mcpServers": {
    "gravity": {
      "command": "npx",
      "args": ["-y", "gravity-ads-mcp"],
      "env": {
        "GRAVITY_API_KEY": "your-gravity-api-key"
      }
    }
  }
}

環境変数

ツール

アカウント

キャンペーン

広告グループと広告

レポート

プロンプト例

設定後、エージェントに次のように依頼してみてください:

• 「アクティブなキャンペーンを一覧表示して」

• 「過去 14 日間の ROAS は？」

• 「「サマーセール」というキャンペーンを、1 日 100 ドルの予算、米国とカナダをターゲットに、ランニングシューズ用の生成型広告グループで作成して」

• 「支出が 500 ドルを超えるキャンペーンをすべて一時停止して」

• 「キャンペーン camp-456 の過去 7 日間の広告グループパフォーマンスを America/New_York タイムゾーンで表示して」

• 「これらの広告で手動広告グループを作成: 見出し「ランニングシューズ 50% オフ」、コピー「全ランニングシューズのサマーセール。」、CTA「今すぐ購入」」

• 「昨日のコンバージョンは？」

• 「https://acme.com 用のピクセルを作成して」

セキュリティとプライバシー

• あなたの GRAVITY_API_KEY はプロセス環境変数として渡され、platform.trygravity.ai 以外のサーバーにログ記録または送信されることはありません。

• すべての API リクエストは、あなたのマシンから Gravity の API に直接送信されます — 仲介者はありません。

• npx で実行するため、グローバルインストールは不要です。サーバーはセッションごとに新しく起動します。

• キーはいつでも https://app.trygravity.ai の Settings → API Key から再生成できます。

トラブルシューティング

コントリビューター

ローカルセットアップ、ビルド、テスト、公開手順については、DEVELOPMENT.md を参照してください。

ライセンス

MIT