개발자

MCP 연결

AI 도구에 대시보드 지표, 목표와 퍼널, 주간 브리핑, 고객 가치 집계, 광고 손익을 연결해요. 체험을 포함한 모든 플랜에서 쓸 수 있어요.

Claude, ChatGPT에서 연결

주소 하나만 넣으면 돼요. 토큰을 복사하지 않아도 FinallyData 로그인과 허용 화면이 열려요.

https://app.finallydata.com/mcp

Claude (웹, 데스크톱, 모바일)

1
설정 → 커넥터에서 커스텀 커넥터 추가를 눌러요
2
이름은 FinallyData, 주소는 위 주소를 넣어요
3
FinallyData에 구글로 로그인하고 허용을 눌러요
한 번 연결하면 웹, 데스크톱, 모바일이 같은 연결을 써요. Claude 무료 플랜은 커스텀 커넥터를 1개까지 쓸 수 있어요.

ChatGPT

1
설정 → 앱에서 고급 설정의 개발자 모드를 켜요
2
새 앱을 만들고 위 주소를 넣어요
인증 방식은 OAuth를 골라요.
3
FinallyData에 로그인하고 허용을 눌러요

ChatGPT의 메뉴 이름과 쓸 수 있는 플랜은 자주 바뀌어요. 메뉴가 다르면 ChatGPT 도움말에서 개발자 모드를 찾아 주세요.

Claude Code

아래 명령을 실행한 뒤 Claude Code 안에서 /mcp를 열고 finallydata를 골라 Authenticate를 눌러요. 브라우저에서 허용하면 끝나요.

claude mcp add --transport http finallydata https://app.finallydata.com/mcp

허용 화면에서 고르는 것

어느 앱이 어디로 돌아가는지 먼저 보여요. Claude, ChatGPT, Claude Code는 FinallyData가 확인한 앱이에요. 그 밖의 앱은 앱이 스스로 밝힌 이름이라 확인하지 않은 앱으로 표시해요.
볼 사이트: 모든 사이트(나중에 만드는 사이트 포함) 또는 고른 사이트
읽을 범위: 아래 도구 표의 범위 중 하나 이상. 쓰기 권한은 없어요.
이 컴퓨터(localhost)로 돌아가는 연결은 경고를 보여요. 직접 시작한 연결이 아니면 거절해 주세요.

연결 끊기

설정 → API / MCP의 연결된 앱에서 끊어요. 끊으면 그 앱은 바로 읽지 못해요. 연결은 계정당 50개까지예요. 30일 동안 쓰지 않은 연결은 다시 로그인해야 해요. 계정을 지우면 연결도 모두 지워요.

토큰으로 연결 (Cursor, 스크립트)

로그인 화면을 열 수 없는 도구나 스크립트는 계정 토큰을 써요.

토큰 만들기

1
설정 → API / MCP를 열어요
2
사이트와 읽을 범위를 골라요
모든 사이트를 고르면 나중에 만드는 사이트도 포함해요. 고른 사이트만 허용할 수도 있어요. 범위는 하나 이상 필요해요.
3
이름을 적고 토큰 만들기를 눌러요
이름은 선택이에요. 켜진 토큰은 계정당 20개까지예요.
4
전체 토큰을 복사해 도구에 넣어요
전체 값은 만든 직후 10분 동안만 보여요. 숨기기를 누르면 바로 지워요. 이후에는 다시 볼 수 없으니 잃어버렸다면 끄고 새로 만들어요.

토큰은 계정에 속해요. 사이트를 지우면 그 사이트는 바로 빠지고, 토큰을 끄거나 계정을 지우면 더 이상 읽을 수 없어요. 토큰은 연결할 도구에만 넣고 공개 코드나 공유 문서에는 남기지 마세요.

Claude Code (토큰)

아래의 <토큰>을 방금 복사한 값으로 바꾸어 터미널에서 실행해요.

claude mcp add --transport http finallydata https://app.finallydata.com/mcp --header "Authorization: Bearer <토큰>"

Cursor 등 (mcp.json)

도구의 MCP 설정 파일에 아래 내용을 넣어요. 이미 mcpServers가 있으면 finallydata 항목을 그 안에 더해요.

{
  "mcpServers": {
    "finallydata": {
      "url": "https://app.finallydata.com/mcp",
      "headers": {
        "Authorization": "Bearer <토큰>"
      }
    }
  }
}

서버 주소는 https://app.finallydata.com/mcp예요. Streamable HTTP로 연결하고 매 요청에 Bearer 토큰을 보내요. 토큰 없이 부르면 401과 함께 로그인 안내(OAuth 보호 자원 메타데이터 주소)를 돌려줘요.

읽을 수 있는 도구

이름	필요한 범위	하는 일
`list_sites`	범위와 상관없이 돼요	볼 수 있는 사이트의 주소, 종류, 통화, 시간대와 설치 여부를 읽어요.
`get_overview`	analytics:read	대시보드 지표, 앞 기간, 시계열, 메모와 급증을 읽어요.
`get_breakdown`	analytics:read	선택한 분류의 방문자, 매출, 주문을 읽어요. 화면과 같은 최대 30줄 중에서 골라요.
`get_realtime`	analytics:read	현재 방문과 최근 활동을 읽어요. 손님 번호는 보내지 않아요.
`get_goals`	goals:read	전환 이벤트, 페이지 목표와 핵심 목표의 집계를 읽어요.
`get_funnels`	goals:read	기본 퍼널과 맞춤 퍼널을 이 기간과 4주 비교로, 기본 퍼널은 진입 페이지별로도 읽어요.
`get_weekly_briefing`	insights:read	최근 13주 안의 주간 브리핑과 요약을 읽어요.
`get_customers`	customers:read	고객 가치의 구매, 재구매와 LTV 집계를 읽어요. 개인 목록과 구독 MRR은 보내지 않아요.
`get_ad_profit`	profit:read	최근 13개 완료 주와 이번 주의 광고 손익, 고른 주의 요일별 숫자를 읽어요.

범위가 없는 도구도 목록에는 보여요. 부르면 필요한 범위를 안내해요. 사이트가 하나면 site를 생략해도 되고, 여럿이면 list_sites로 확인한 id나 도메인을 넣어요.

기간과 필터

get_overview, get_breakdown, get_goals, get_funnels에 period와 filters를 넣어요. 기본 기간은 30d이고 날짜는 사이트 시간대를 따라요. 금액은 사이트 통화의 기본 단위 숫자예요. KRW는 원, USD는 달러예요.

항목	값
period	today, yesterday, 7d, 30d, month, lastmonth, 90d, 12m, custom
from, to	custom일 때만 YYYY-MM-DD로 둘 다 넣어요. 보관 기간 밖이거나 끝이 시작보다 앞이면 오류예요.
filters	channel, referrer, campaign, country, region, city, device, browser, os, host, visitor, entry, page, goal
dimension	get_breakdown에서 channel, referrer, campaign, page, entry, exit, host, region, country, city, device, browser, os, visitor 중 하나를 골라요.
limit	get_breakdown의 기본은 10, 입력 상한은 50이에요. 현재 화면이 계산한 최대 30줄 안에서 반환해요.
week	YYYY-MM-DD 월요일을 넣어요. 브리핑은 이번 주를 포함한 최근 13주, 광고 손익은 최근 13개 완료 주와 이번 주예요. 기본은 지난주예요.

필터 값은 200자 안의 문자열이에요. 화면에서 쓰는 값과 같아요. 예를 들어 channel은 meta, device는 mobile, country는 KR, visitor는 신규 방문이면 "1", 재방문이면 "0"이에요. entry와 page는 /로 시작하는 경로, goal은 전환 이벤트 이름을 넣어요.

{
  "name": "get_overview",
  "arguments": {
    "site": "example.com",
    "period": "7d",
    "filters": {
      "channel": "meta"
    }
  }
}

언제부터 세고 얼마나 쓰나요

새로 수집하는 기능이 아니라 이미 모은 숫자를 읽어요. 방문과 전환은 설치 뒤, 매출은 구매 연결 뒤의 기록을 따르고, 고객 가치는 연결한 과거 주문도 포함할 수 있어요. MCP 호출은 플랜의 이벤트 사용량에 더하지 않아요.

화면과 같은 계산을 써요. 큰 사이트의 분석, 목표, 퍼널 도구는 화면과 결과를 최대 10분 공유하고 새 주문이나 취소가 생기면 다시 계산해요. 실시간은 호출할 때 읽어요. 고객 가치는 최근 90일 주문 요약과 각 지표의 고정 기간을 쓰며 최대 1시간 저장한 집계를 받아요.

연결과 토큰마다 1분에 120번까지 불러요. 맞지 않는 토큰은 IP별로 따로 세요. 429가 오면 잠시 뒤 다시 불러 주세요. 체험이 끝나거나 이번 달 이벤트 한도를 넘겨 화면이 잠기면 도구도 잠금 안내를 보내요. 연결 확인, 도구 목록과 list_sites는 계속 돼요. 요청 본문은 64KB까지예요.

아직 안 되는 것

목표, 퍼널, 메모 만들기 같은 쓰기는 아직 없어요.
브라우저 안의 MCP 도구는 아직 연결할 수 없어요.
손님 번호, 개인 프로필, 여정, 고객별 주문 목록은 보내지 않아요. 실시간도 손님 번호 없이 보내요.
브랜드 탭과 구독 서비스의 MRR 집계는 아직 없어요. get_customers는 구매와 재구매 집계를 읽어요.
REST 읽기 API는 아직 사이트 키(adp_)로만 돼요. 계정 토큰(fdt_)과는 달라요. 읽기 API 안내