gconnect-mcp-all-v1

Claude.ai 사용자 연결 커넥터를 위한 True Model B SQL? No, revise. Actually careful: We said "튜 Model ..." Let's correct in final.

Let's final with the exact.

One last nuance: The title "## Deployment" should be "## 배포".

Let# gconnect-mcp-all-v1

True Model B Google Marketing MCP for Claude.ai Custom Connectors입니다.

이것은 GA4 전용 커넥터가 아니며, Google Ads 전용 커넥터도 아닙니다. 지금은 두 개의 제품 adapter를 갖춘 공유 플랫폼이며, 나중에 DV360를 위한 확장 지점이 예약되어 있습니다:

Operator
  +-- Google Connection A
  |     +-- GA4 properties
  |     +-- Google Ads customers / MCC hierarchy
  +-- Google Connection B

MCP JWT sub는 항상 내부 operatorId입니다. Google OpenID sub는 google_connections.googleSubjectId에만 존재합니다.

아키텍처

flowchart TB
  Claude["Claude.ai"]
  McpAuth["MCP OAuth 2.1"]
  Operator["operators operatorId"]
  Resolver["ConnectionResolver"]
  Ga4["GA4 adapter"]
  Ads["Google Ads adapter"]
  Dv360["DV360 future"]
  Ga4Api["GA4 APIs"]
  AdsApi["Ads REST v25"]

  Claude --> McpAuth
  McpAuth --> Operator
  Operator --> Resolver
  Resolver --> Ga4
  Resolver --> Ads
  Resolver -.-> Dv360
  Ga4 --> Ga4Api
  Ads --> AdsApi

참조: docs/architecture.md.

Related MCP server: GA4 MCP Server

신원

• MCP 인증은 '운영자가 누구인가?'라는 질문에 답합니다.

• Google OAuth는 '어떤 Google 계정이 연결되어 있는가?'라는 질문에 답합니다.

• 고유성은 (operatorId, googleSubjectId)이며, 이메일이나 전역 Google subject를 사용하지 않습니다.

참조: docs/identity-model.md.

영속성

Firestore named database는 gconnect-mcp-all-v1만 사용합니다.

(default)(V1) 또는 ga4-mcp-v3(V3)을 사용하지 마십시오. 서버 시작 시 해당 ID는 거부됩니다.

참조: docs/google-connections.md.

로컬 개발

1. .env.example을 .env로 복사하고 자리표시자를 채우세요. V3의 비밀값을 복사하지 마십시오.

2. npm install

3. npm test

4. npm run typecheck

5. npm run dev

Claude Custom Connector URL은 http://localhost:3000/mcp입니다. 헬스 체크는 GET /health입니다.

Google Ads

공식 Google Ads REST v25를 사용합니다. 읽기 전용입니다. 앱 개발자 토큰은 애플리케이션 시크릿(GOOGLE_ADS_DEVELOPER_TOKEN)이며, 사용자 OAuth 자격 증명이 아닙니다.

서버는 발견된 MCC 계층 구조에서 login-customer-id를 결정합니다. 하이픈이 포함된 쿠키 ID는 API 실행 전에 정규화됩니다.

참조: docs/google-ads.md 및 docs/ga4.md.

배포

Cloud Run, 인증되지 않은 인그레스(unauthenticated ingress)로 배포되며, 명명된 Firestore 데이터베이스 gconnect-mcp-all-v1만 사용합니다.

.\scripts\cloud-run-setup.ps1 -ProjectId YOUR_PROJECT
.\scripts\cloud-run-deploy.ps1 -ProjectId YOUR_PROJECT
.\scripts\cloud-run-set-env.ps1 -ProjectId YOUR_PROJECT -AppBaseUrl https://... -GoogleClientId ... -GoogleClientSecret ... -McpTokenSecret ... -OauthStateSecret ... -TokenEncryptionKey ... -GoogleAdsDeveloperToken ...

참조: docs/deployment.md 및 docs/security.md.