Skip to main content
Glama
ccsDevs

Google Analytics MCP for Coolify

by ccsDevs

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 Analytics MCP server on Cloudflare Workers

필요한 Coolify 구성

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

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

Variable

Purpose

GOOGLE_PROJECT_ID

기존 Google Cloud 프로젝트 ID

GOOGLE_ANALYTICS_MCP_BASE_URL

최종 HTTPS 출처, /mcp 제외

GOOGLE_ANALYTICS_MCP_OAUTH_CLIENT_ID

Google OAuth 웹 클라이언트 ID

GOOGLE_ANALYTICS_MCP_OAUTH_CLIENT_SECRET

Google OAuth 웹 클라이언트 시크릿

GOOGLE_ANALYTICS_MCP_JWT_SIGNING_KEY

MCP 토큰 서명에 사용되는 긴 임의의 시크릿

GOOGLE_ANALYTICS_MCP_STORAGE_ENCRYPTION_KEY

저장된 OAuth 데이터 암호화에 사용되는 Fernet 키

GOOGLE_ANALYTICS_CREDENTIALS_JSON

Analytics에 승인된 ADC JSON, 하나의 시크릿 값으로 입력

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

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    A FastMCP-powered server that connects Google Analytics 4 data to Claude Desktop with automatic OAuth 2.0 authentication, enabling users to access GA4 metrics, properties, and reports through natural language queries.
    18
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Self-hosted MCP server for Google Analytics over HTTP, providing URL-addressable access with API key auth. It enables clients to run reports, list accounts/properties, and use compact paginated reports for token efficiency.
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    A read-only MCP server exposing Google Analytics 4 and AdSense APIs (reports, metadata, admin reads) via Cloudflare Workers with OAuth authentication.
    MIT