Google Business Profile MCP

English | Русский

A1 Google Business Profile MCP는 AI 앱이 자연어로 Google Business Profile 위치와 작업할 수 있게 해줍니다. 위치와 실적을 확인하고, 리뷰에 응답하고, 로컬 게시물을 준비하고, 프로필 정보를 신중하게 업데이트할 수 있습니다.

현재 Business Profile API와 리뷰 및 게시물이 여전히 존재하는 레거시 API에 연결합니다. Google 계정과 OAuth 자격 증명만으로는 충분하지 않습니다. Google이 Cloud 프로젝트에 대한 Basic API Access를 승인해야 합니다.

• 도구 20개. 위치 및 계정 데이터, 실적, 리뷰, 로컬 게시물, 카테고리 및 속성.

• 실제 승인 게이트. 프로젝트는 0 QPM으로 시작하며, Google이 Basic API Access 신청을 승인하기 전까지 모든 API 호출이 실패합니다.

• 별도의 공개 경계. 준비된 답변, 게시물 또는 위치 업데이트는 클라이언트가 쓰기 작업을 확인한 후에만 공개 비즈니스 정보를 변경합니다.

• 4가지 API 표면. 계정 관리(Account Management), 비즈니스 정보(Business Information), 실적(Performance) 및 레거시 v4는 하나의 business.manage OAuth 범위를 통해 작동합니다.

읽기 전용 질문으로 시작해 보세요:

내 위치를 나열하고 답글이 없는 최신 리뷰를 보여줘.

서버 연결 · 사용 사례 살펴보기 · 기술 문서 열기

1분 만에 작동 확인하기

You: 내 위치를 나열하고 답글이 없는 최신 리뷰를 보여줘.

Assistant: 위치와 최근 리뷰를 표시합니다. 변경되는 것은 없습니다.

You: 시내 지점의 최신 3성 리뷰에 답글 초안을 작성해 줘. 사과하고 도움을 제안해.

Assistant: 위치, 리뷰, 제안된 답글을 표시한 후 게시 전에 확인을 요청합니다.

You: 확인.

Assistant: 답글을 게시합니다. 리뷰나 다른 위치, 게시물은 변경하지 않습니다.

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 문의 양식을 Basic API Access 신청으로 제출하세요. 승인 전에는 할당량이 0 QPM이며, 승인된 프로젝트는 API당 300 QPM을 받습니다.

4. OAuth 클라이언트를 만들고 https://www.googleapis.com/auth/business.manage에 대한 갱신 토큰을 획득한 다음 세 개의 GOOGLE_BUSINESS_* 변수를 설정하세요.

클라이언트 시크릿과 갱신 토큰을 비밀번호처럼 취급하세요. 액세스 토큰은 일회용으로 사용할 수 있는 단기 대안입니다.

구성

* OAuth 3종 세트 또는 액세스 토큰 중 하나를 제공하세요. API 호스트 재정의는 도구 참조에 문서화되어 있습니다.

데이터, 한도 및 백그라운드 작업

• Google이 프로필 요청을 수신합니다. 익명 텔레메트리에는 설치 및 버전 데이터와 도구 이름이 포함되며, OAuth 시크릿, 프로필 데이터, 인수 또는 프롬프트는 절대 포함되지 않습니다. 옵트아웃하려면 ASKADS_TELEMETRY=0을 설정하세요.

• 실제 편집 상한. 승인된 프로젝트는 API당 300 QPM을 받으며, Google은 각 Business Profile을 분당 10회 편집으로 제한합니다. 실적 지표는 며칠 지연될 수 있으며, 리뷰 답글에는 인증된 위치가 필요합니다.

• 백그라운드 모니터링 없음. 서버는 호출되는 동안에만 실행됩니다. AI 앱이 예약 작업을 지원하면 주기적으로 새 피드백이나 지표를 검토할 수 있습니다.

기술 문서

• MCP 기능 카탈로그 — 모든 도구에 대한 작업 중심 페이지.

• 모든 도구 및 입력

• 개발 문서

• 게시 문서

• Google Business Profile API 문서

지원

버그를 발견했거나 시나리오가 필요하신가요? 이슈 만들기 또는 Telegram으로 문의하세요.