Google Business Profile MCP

日本語 | Русский

A1 Google Business Profile MCP を使うと、AIアプリが自然言語でGoogle Business Profileのロケーションを操作できます。ロケーションとパフォーマンスの確認、レビューへの返信、ローカル投稿の作成、プロフィール情報の意図的な更新が可能です。

これは、Googleの現在のBusiness Profile APIと、レビューや投稿がまだ存在するレガシーAPIに接続します。GoogleアカウントとOAuth認証情報だけでは不十分で、Cloudプロジェクトに対するBasic API Accessの承認がGoogleから必要です。

• 20種類のツール。 ロケーションとアカウントデータ、パフォーマンス、レビュー、ローカル投稿、カテゴリと属性。

• 本物の承認ゲート。 プロジェクトは0 QPMから始まり、GoogleがBasic API Access申請を承認するまで、すべてのAPI呼び出しは失敗します。

• 明確な公開境界。 下書きした返信・投稿・ロケーション更新は、クライアントが書き込み操作を確認した後にのみ公開情報を変更します。

• 4つのAPIサーフェス。 Account Management、Business Information、Performance、レガシーv4は、1つの business.manage OAuthスコープで動作します。

読み取り専用の質問から始めましょう:

私のロケーションを一覧表示して、返信がない最新のレビューを見せてください。

サーバーに接続する · ユースケースを見る · 技術ドキュメントを開く

1分で動作を確認する

あなた: 私のロケーションを一覧表示して、返信がない最新のレビューを見せてください。

アシスタント: ロケーションと最近のレビューを表示します。何も変更されません。

あなた: ダウンタウンのロケーションにある最新の3つ星レビューへの返信を下書きしてください。謝罪して、支援を申し出てください。

アシスタント: ロケーション、レビュー、提案された返信を表示し、公開前に確認を求めます。

あなた: 確認します。

アシスタント: 返信を公開します。レビュー、他のロケーション、投稿は変更されません。

Related MCP server: Local Business Data MCP Server

目次

• クイックスタート

• 何を依頼できるか

• 変更できるもの

• アクセスを取得する

• 設定

• データ、制限、バックグラウンド処理

• 技術ドキュメント

• サポート

クイックスタート

Node.js 20以上、検証済みのGoogle Business Profile、Google Cloud OAuthクライアント、承認済みのBasic API Access申請が必要です。

1. 承認済みアクセスを取得する。

2. サーバーをAIアプリに追加します。

3. 上記の読み取り専用の質問から始めます。

Settings → Plugins → MCP servers で Add server を選択し、GOOGLE_BUSINESS_CLIENT_ID、GOOGLE_BUSINESS_CLIENT_SECRET、GOOGLE_BUSINESS_REFRESH_TOKEN を指定して npx -y mcp-google-business@latest を追加します。

codex mcp add google-business \
  --env GOOGLE_BUSINESS_CLIENT_ID=your_client_id \
  --env GOOGLE_BUSINESS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_BUSINESS_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-business@latest
codex mcp list

Codex MCPドキュメント

claude mcp add \
  --env GOOGLE_BUSINESS_CLIENT_ID=your_client_id \
  --env GOOGLE_BUSINESS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_BUSINESS_REFRESH_TOKEN=your_refresh_token \
  --transport stdio --scope user google-business \
  -- npx -y mcp-google-business@latest
claude mcp list

Claude Code MCPドキュメント

Settings → Developer → Edit Config を開いて追加します:

{"mcpServers":{"google-business":{"command":"npx","args":["-y","mcp-google-business@latest"],"env":{"GOOGLE_BUSINESS_CLIENT_ID":"your_client_id","GOOGLE_BUSINESS_CLIENT_SECRET":"your_client_secret","GOOGLE_BUSINESS_REFRESH_TOKEN":"your_refresh_token"}}}}

Edit Config が利用できない場合は、macOSでは ~/Library/Application Support/Claude/claude_desktop_config.json、Windowsでは %APPDATA%\Claude\claude_desktop_config.json を編集します。Claude Desktop MCPドキュメント

macOS/Linuxでは ~/.cursor/mcp.json、Windowsでは %USERPROFILE%\.cursor\mcp.json に {"mcpServers":{"google-business":{"type":"stdio","command":"npx","args":["-y","mcp-google-business@latest"],"env":{"GOOGLE_BUSINESS_CLIENT_ID":"your_client_id","GOOGLE_BUSINESS_CLIENT_SECRET":"your_client_secret","GOOGLE_BUSINESS_REFRESH_TOKEN":"your_refresh_token"}}}} を追加します。Cursor MCPドキュメント

MCP: Open User Configuration を実行して追加します:

{"servers":{"google-business":{"type":"stdio","command":"npx","args":["-y","mcp-google-business@latest"],"env":{"GOOGLE_BUSINESS_CLIENT_ID":"${input:gbp_client_id}","GOOGLE_BUSINESS_CLIENT_SECRET":"${input:gbp_client_secret}","GOOGLE_BUSINESS_REFRESH_TOKEN":"${input:gbp_refresh_token}"}}},"inputs":[{"type":"promptString","id":"gbp_client_id","description":"Google OAuth client ID"},{"type":"promptString","id":"gbp_client_secret","description":"Google OAuth client secret","password":true},{"type":"promptString","id":"gbp_refresh_token","description":"Google OAuth refresh token","password":true}]}

MCP: List Servers で確認します。VS Code MCPドキュメント

何を依頼できるか

• ロケーション、カテゴリ、属性、現在のプロフィール情報を一覧表示します。

• 選択した期間の通話数、道順リクエスト、検索キーワードのインプレッションを表示します。

• 新しいレビューを見つけ、返信を下書きし、確認後に公開します。

• ローカル投稿の作成、更新、削除を行います。

• 選択したロケーションのフィールドや属性を、正確な変更内容を表示した上で更新します。

変更できるもの

確認はAIクライアントが制御します。サーバーはツールにマークを付けるため、クライアントは参照とライブ変更を区別できます。

アクセスを取得する

GoogleではOAuthとBasic API Accessの承認の両方が必要です。

1. 少なくとも60日以上存在する検証済みかつアクティブなBusiness Profileを使用します。オーナーまたはマネージャーアカウントから申請し、申請内容と一致するビジネスウェブサイトを持っている必要があります。

2. Google Cloudプロジェクトを作成し、My Business Account Management API、Business Information API、Business Profile Performance API、Google My Business API（レガシーv4）を有効にします。

3. GBP API問い合わせフォーム を Application for Basic API Access として送信します。承認前はクォータが0 QPMで、承認されたプロジェクトはAPIごとに300 QPMを受け取ります。

4. OAuthクライアントを作成し、https://www.googleapis.com/auth/business.manage のリフレッシュトークンを取得し、3つの GOOGLE_BUSINESS_* 変数を設定します。

クライアントシークレットとリフレッシュトークンはパスワードとして扱ってください。アクセストークンは1回限りの使用に適した短命の代替手段です。

設定

* OAuth3点セットまたはアクセストークンのいずれかを指定します。APIホストのオーバーライドはツールリファレンスに記載されています。

データ、制限、バックグラウンド処理

• Googleがプロフィールリクエストを受け取ります。 匿名テレメトリには、インストール情報とバージョン情報、ツール名が含まれますが、OAuthシークレット、プロフィールデータ、引数、プロンプトは含まれません。オプトアウトするには ASKADS_TELEMETRY=0 を設定します。

• 実際の編集上限。 承認されたプロジェクトはAPIごとに300 QPMを受け取ります。Googleは各Business Profileを1分あたり10回の編集にも制限しています。パフォーマンス指標は数日遅れることがあり、レビュー返信には検証済みのロケーションが必要です。

• バックグラウンド監視はありません。 サーバーは呼び出されたときのみ実行されます。AIアプリがスケジュールタスクをサポートしている場合は、新しいフィードバックや指標を定期的に確認できます。

技術ドキュメント

• MCP機能カタログ — すべてのツールのタスク指向ページ。

• すべてのツールと入力

• 開発ドキュメント

• 公開ドキュメント

• Google Business Profile APIドキュメント

サポート

バグを見つけたり、シナリオが必要ですか？イシューを作成 するか、Telegram でお問い合わせください。