Yandex Metrica MCP

Yandex Metrica MCP는 AI 애플리케이션을 웹사이트 웹 분석에 연결합니다. 방문자가 어디에서 오는지, 전환율이 어떻게 변하는지, 이탈률이 어디에서 증가하는지 자연어로 물어보세요 — 어시스턴트가 카운터에서 데이터를 가져와 결과를 설명합니다. 연결은 대화 중에 바로 시작됩니다: 토큰을 미리 만들거나 구성을 편집할 필요가 없습니다.

• 8가지 도구. Metrica의 카운터, 목표 및 보고서, 액세스 연결 및 해제, 그리고 API에 대한 범용 요청 하나.

• 보고서 및 전환. 선택한 기간의 방문, 사용자, 조회수, 이탈, 방문 시간, 소스, 기기 및 목표.

• 채팅에서 연결. Yandex가 로그인 페이지를 엽니다. 일회용 코드는 10분 동안 유효하며, 서버는 연결 직후 카운터에 대한 액세스를 확인합니다.

• 일반 요청은 읽기 전용. 전용 도구는 Metrica의 카운터, 목표 또는 데이터를 변경하지 않습니다.

• 조용한 잘림 없음. 보고서에 합계 값과 샘플링 표시가 표시됩니다. 결과가 많을 때 서버는 한도에 도달했는지 표시합니다.

첫 메시지로 시도해 보세요:

지난주 내 사이트의 방문, 사용자 및 이탈 수는 얼마였나요?

서버 연결 · 시나리오 보기 · 기술 문서 열기

1분 만에 작동 확인

사용자: Yandex Metrica를 연결하세요.

어시스턴트: Yandex 로그인 링크를 제공합니다. 필요한 카운터에 액세스 권한이 있는 계정으로 열고, 액세스를 확인한 후 표시된 코드를 보내주세요.

사용자: Yandex 페이지의 코드를 보냅니다.

어시스턴트: Metrica를 연결하고, 카운터가 보이는지 확인한 후 결과를 알려줍니다. 애플리케이션을 다시 시작할 필요가 없습니다.

사용자: 지난 30일 동안 트래픽 소스와 '주문 완료' 목표의 전환율을 보여주세요.

어시스턴트: 목표를 찾고, 소스별 보고서를 작성하여 방문, 목표 달성 및 전환율을 보여줍니다. Metrica가 샘플링을 적용한 경우 숫자가 근사치임을 표시합니다.

Related MCP server: ya-metrics-mcp

목차

• 빠른 시작

• 무엇을 맡길 수 있나요

• 작동 방식

• 데이터를 변경할 수 있는 것

• 연결 및 설정

• 데이터 및 텔레메트리

• 제한 사항

• 기술 문서

• 지원

빠른 시작

Node.js 20 이상이 필요합니다. 서버는 npx를 통해 실행되므로 패키지를 별도로 설치할 필요가 없습니다.

1. AI 애플리케이션에 서버를 추가하세요 — 아래에 Codex용 예시가 열려 있고, 나머지 애플리케이션은 접이식 지침에 모아져 있습니다.

2. "Yandex Metrica를 연결하세요"라고 작성하세요. 어시스턴트가 Yandex 로그인을 안내하고 카운터가 보이는지 즉시 확인합니다.

3. 첫 질문을 하세요. 예: "지난달 가장 많은 방문을 가져온 소스는 무엇인가요?"

애플리케이션 인터페이스를 통해:

1. Settings → Plugins → MCP servers를 엽니다.

2. Add server를 클릭합니다.

3. 실행 명령 npx -y mcp-yandex-metrica@latest를 추가합니다.

명령줄을 통해:

codex mcp add yandex-metrica -- npx -y mcp-yandex-metrica@latest

연결을 확인하세요:

codex mcp list

그런 다음 Codex 채팅에서 "Yandex Metrica를 연결하세요"라고 요청하세요.

Codex 공식 지침

claude mcp add --transport stdio --scope user yandex-metrica -- npx -y mcp-yandex-metrica@latest

다음 명령으로 서버를 확인하세요:

claude mcp list

그런 다음 Metrica 연결 요청으로 대화를 시작하세요.

Claude Code 문서

Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 서버를 추가하세요:

{
  "mcpServers": {
    "yandex-metrica": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica@latest"]
    }
  }
}

저장 후 새 대화를 열고 Metrica 연결을 요청하세요.

모든 프로젝트에 대해 ~/.cursor/mcp.json을 만들고, 현재 프로젝트에만 해당하는 경우 .cursor/mcp.json을 만드세요:

{
  "mcpServers": {
    "yandex-metrica": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica@latest"]
    }
  }
}

Cursor 채팅에서 서버가 사용 가능한 도구 중에 나타납니다. Metrica 연결을 요청하고 Yandex 로그인을 진행하세요.

Cursor 문서

명령 팔레트를 열고 MCP: Open User Configuration을 실행하세요. mcp.json에 추가하세요:

{
  "servers": {
    "yandex-metrica": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica@latest"]
    }
  }
}

MCP: List Servers 명령으로 실행을 확인한 다음, 채팅을 열고 Metrica 연결을 요청하세요.

VS Code 문서

무엇을 맡길 수 있나요

사이트 상황 이해하기

• "지난주 방문, 사용자 및 조회수는 얼마였나요?"

• "6월의 일별 방문 추이를 보여주세요."

• "어떤 기기에서 이탈률이 더 높나요?"

트래픽 소스 찾기 및 품질 평가

• "한 달간 트래픽 소스를 방문 수 기준으로 정렬하여 보여주세요."

• "유기 검색과 광고를 사용자 및 이탈 기준으로 비교하세요."

• "이번 주에 가장 많은 전환을 가져온 소스는 무엇인가요?"

전환 분석

• "카운터에 설정된 목표는 무엇인가요?"

• "30일 동안 '주문 완료' 목표의 전환율은 얼마인가요?"

• "목표 달성을 가장 많이 가져온 소스를 보여주세요."

액세스 및 데이터 정확성 확인

• "어떤 카운터에 액세스할 수 있나요?"

• "Metrica 연결 상태를 보여주세요."

• "이 보고서의 데이터는 정확한가요, 아니면 Metrica가 샘플링을 사용했나요?"

작동 방식

서버는 세 가지 익숙한 엔티티로 작동합니다:

일반적으로 어시스턴트는 먼저 액세스 가능한 카운터를 찾고, 필요한 경우 목표를 찾은 다음에만 보고서를 작성합니다. Metrica 응답에는 모든 행의 합계, 결과 크기 및 샘플링 표시가 있습니다.

데이터를 변경할 수 있는 것

서버는 임의 쓰기를 잠재적으로 파괴적인 작업으로 표시합니다. AI 애플리케이션이 확인을 요청하는 방식은 애플리케이션에 따라 다릅니다. 이러한 요청 전에 경로, 메서드 및 데이터를 확인하세요.

연결 및 설정

일반적인 사용에는 토큰이 미리 필요하지 않습니다:

1. 채팅에서 Yandex Metrica 연결을 요청하세요.

2. 필요한 카운터에 액세스 권한이 있는 계정으로 Yandex OAuth 링크를 여세요.

3. 액세스를 확인하고 코드를 어시스턴트에게 보내세요. 코드는 10분 동안 유효하며 실행 중인 서버 내에서만 토큰으로 교환됩니다.

서버는 PKCE를 사용합니다: 채팅의 코드 자체만으로는 토큰으로 교환할 수 없습니다. 얻은 토큰은 ~/.config/mcp-yandex-metrica/credentials.json에 소유자 전용 권한으로 로컬에 저장됩니다. refresh 토큰이 저장되어 있으면 액세스가 자동으로 갱신됩니다.

CI 및 비표준 설치의 경우 환경 변수를 통한 설정이 가능합니다:

자체 OAuth 애플리케이션을 사용하는 경우, 해당 애플리케이션에서 "통계 가져오기, 자신 및 신뢰할 수 있는 카운터의 매개변수 읽기" (metrika:read) 권한을 요청하세요.

데이터 및 텔레메트리

기본적으로 서버는 익명의 기술 텔레메트리를 전송합니다: 무작위 설치 식별자, 이벤트 또는 도구 이름, 서버 버전, Node.js 버전, OS 및 연결된 AI 클라이언트 정보. 토큰, 카운터 데이터, 도구 인수, 사용자 메시지 및 환경 변수 값은 포함되지 않습니다.

Ask Ads MCP 서버의 텔레메트리를 비활성화하려면 환경 변수를 설정하세요:

ASKADS_TELEMETRY=0

제한 사항

• Metrica 샘플링. 긴 기간이나 복잡한 보고서에서 API가 근사 데이터를 반환할 수 있습니다. sampled 및 sample_share 필드를 확인하세요. 더 정확한 계산을 위해 기간을 좁히거나 accuracy: "full"을 사용하세요.

• 보고서 크기. 단일 요청은 최대 10,000행을 반환합니다. 자동 페이지네이션은 최대 100페이지, 100,000행 또는 약 1MB 데이터에서 중지되며 불완전한 응답을 _truncated 필드로 표시합니다.

• 요청 재시도. 단일 요청 타임아웃은 60초입니다. 서버는 일시적 오류 시 최대 3회 재시도합니다: GET — 네트워크 오류, 429 및 5xx 시; POST 및 DELETE — 변경 작업을 반복하지 않도록 429에서만. 지연은 Retry-After를 고려하며 30초를 초과하지 않습니다.

• 실제 데이터. Metrica에는 샌드박스가 없습니다. 전용 도구는 데이터를 읽지만, 임의 요청을 통한 POST 및 DELETE는 실제 객체를 변경합니다.

• 백그라운드 모니터링 없음. 서버는 AI 애플리케이션이 호출할 때 작동하며 자체적으로 지표를 추적하지 않습니다. 애플리케이션이 예약 작업을 지원하는 경우 주기적인 보고서 요청을 설정할 수 있습니다.

기술 문서

• MCP 기능 카탈로그 — 각 도구의 사용자 작업별 페이지.

• 모든 도구 — 각 도구의 매개변수, 응답 및 경계.

• 개발 문서 — 프로젝트 구조 및 데모 작업.

• npm 패키지.

• Yandex Metrica API.

지원

오류를 발견했거나 시나리오가 부족한가요? 이슈를 생성하거나 Telegram으로 문의해 주세요.