Coolify를 위한 Google Analytics MCP

이 패키지는 Google의 공식 실험용 analytics-mcp 패키지 앞에 보안 FastMCP HTTP/OAuth 게이트웨이를 배치합니다. 이는 별도의 Coolify 애플리케이션으로 배포되도록 설계되었으며, 기존 Google Ads MCP 배포를 수정하지 않습니다.

제공하는 기능

• /mcp에서 스트리밍 가능한 HTTP MCP 엔드포인트

• 원격 MCP 엔드포인트에 대한 Google OAuth 보호

• MCP OAuth 등록 및 토큰을 위한 암호화된 영구 저장소

• 공식 analytics-mcp 패키지의 Google Analytics Admin API 및 Data API 도구

• 승인된 사용자 ADC JSON 또는 서비스 계정 JSON 키 지원

Related MCP server: Google MCP Server

필요한 Coolify 구성

/data에 영구 스토리지 마운트를 생성하고 포트 8080을 노출합니다.

새 Analytics 애플리케이션에서 다음 환경 변수를 설정하세요:

PORT는 선택 사항이며 기본값은 8080입니다.

Google Cloud 구성

동일한 Google Cloud 프로젝트에서 두 API를 모두 활성화하세요:

• Google Analytics Admin API

• Google Analytics Data API

OAuth 클라이언트는 웹 애플리케이션이어야 합니다. 최종 도메인이 할당된 후 다음 승인된 리디렉션 URI를 추가하세요:

https://YOUR-ANALYTICS-MCP-DOMAIN/auth/callback

ChatGPT에 추가할 MCP URL은 다음과 같습니다:

https://YOUR-ANALYTICS-MCP-DOMAIN/mcp

중요한 자격 증명 분리

기존 Ads 애플리케이션을 변경하거나 해당 자격 증명을 교체하지 마세요. GOOGLE_ANALYTICS_CREDENTIALS_JSON 값은 이 별도의 Analytics 애플리케이션에만 속하며, https://www.googleapis.com/auth/analytics.readonly 범위를 포함해야 합니다.

Google OAuth 동의 화면이 테스트 모드에 있을 때, Google은 7일 후에 승인된 사용자 갱신 토큰을 만료시킬 수 있습니다. 이는 Google OAuth 테스트 제한 사항이며, Coolify의 오류가 아닙니다.

버전

• analytics-mcp==0.7.0

• fastmcp==3.4.7

• Python 3.11

버전 고정은 배포를 반복 가능하게 만듭니다. 업데이트하기 전에 상위 릴리스를 검토하세요.