MCP 서버 연동
Claude Code에서 Edgelink MCP 서버를 연결하여 AI로 캠페인 링크 발행, 성과 조회, 관리를 자동화하세요.
Edgelink는 Model Context Protocol(MCP)을 지원합니다. Claude Code에서 MCP 서버를 연결하면 대화형으로 단축 링크를 발행하고, 캠페인 성과를 조회하고, 링크를 관리할 수 있습니다.
사전 준비
- API Key를 생성합니다. MCP에는 일반(general,
el_접두사) API 키만 사용할 수 있습니다. 전환 추적 SDK용 publishable(pk_) 키나 secret(sk_) 키로는 인증에 실패합니다(401). - Claude Code가 설치되어 있어야 합니다.
연결 설정
터미널에서 아래 명령어를 실행하세요:
claude mcp add --transport http edgelink https://api.edgelink.me/mcp --header "Authorization: Bearer YOUR_API_KEY"
YOUR_API_KEY를 실제 API Key로 교체하세요.
팁: 대시보드 설정 > API 키에서 API Key를 생성하면 바로 사용 가능한 명령어를 제공합니다.
사용 가능한 도구
MCP 서버를 연결하면 다음 20개 도구를 사용할 수 있습니다. 모든 도구는 웹 대시보드와 동일한 플랜 기능 활성화, 쿼터, 조회 기간 제한을 적용받습니다. 한도를 초과하면 get_usage_and_limits로 원인을 확인하세요.
클릭 성과 조회 기간은 플랜별로 제한됩니다. get_link_analytics, get_workspace_summary, get_campaign_performance, get_destination_ranking, get_destination_performance로 한 번에 조회할 수 있는 기간은 Free 7일, Hobby 60일, Pro 90일입니다(get_workspace_summary의 days는 최대 90). 이 범위를 넘는 기간을 요청하면 거부됩니다.
전환 성과 조회 기간은 플랜별 구분이 없습니다. get_conversion_performance는 Pro 플랜 전용이며, 시작일부터 종료일까지 최대 365일까지 조회할 수 있습니다. 이를 넘으면 거부됩니다.
링크 발행
create_short_link
URL을 단축된 링크로 만듭니다. custom_key를 비우면 단축 키를 자동 생성합니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
url | 필수 | 단축할 대상 URL |
custom_key | 선택 | 커스텀 단축 키 (미입력 시 자동 생성) |
bulk_create_links
여러 URL을 한 번에 최대 50개까지 단축합니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 단축할 URL 목록 (최대 50개) |
create_utm_link
UTM 파라미터가 포함된 캠페인 링크를 발행합니다. 저장된 UTM 템플릿을 불러오거나 값을 직접 지정할 수 있습니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
url | 필수 | 단축할 대상 URL |
template_id | 선택 | 불러올 UTM 템플릿 ID (list_utm_templates로 조회) |
utm_source | 선택 | UTM source (예: google, newsletter) |
utm_medium | 선택 | UTM medium (예: cpc, email) |
utm_campaign | 선택 | UTM campaign (예: spring_sale) |
utm_term | 선택 | UTM term (검색 키워드) |
utm_content | 선택 | UTM content (광고 소재 식별) |
custom_key | 선택 | 커스텀 단축 키 |
list_utm_templates
워크스페이스에 저장된 UTM 템플릿 목록을 조회합니다. create_utm_link의 template_id에 넣을 값을 찾을 때 사용합니다. 파라미터는 없습니다.
list_domains
워크스페이스에 연결된 도메인 목록을 조회합니다. 파라미터는 없습니다.
링크 관리
list_links
워크스페이스의 단축 링크 목록을 검색어, 폴더, 태그, 보관 여부로 필터링해 조회합니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
first | 선택 | 조회할 링크 수 (최대 50, 기본 10) |
after | 선택 | 페이지네이션 커서 |
search | 선택 | 검색어 (원본 URL, 단축 키) |
folder_id | 선택 | 조회할 폴더 ID |
tag_ids | 선택 | 조회할 태그 ID 목록 |
include_archived | 선택 | 보관된 링크 포함 여부 (기본 false) |
list_links_by_folder
폴더별 링크 목록을 조회합니다. 폴더 ID를 지정하지 않으면 전체 폴더 목록을 반환합니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
folder_id | 선택 | 조회할 폴더의 ID (미입력 시 폴더 목록 반환) |
first | 선택 | 조회할 링크 수 (최대 50) |
get_link_info
특정 단축 링크의 상세 정보를 조회합니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
link_id | 필수 | 조회할 링크의 ID |
update_link
이미 발행한 링크의 목적지 URL, UTM, 태그, 폴더, 메모를 수정합니다. 새 링크가 필요하면 create_utm_link를, 링크를 보관하려면 archive_link를 사용하세요.
| 파라미터 | 필수 | 설명 |
|---|---|---|
link_id | 필수 | 수정할 링크의 ID |
original_url | 선택 | 새 목적지 URL |
utm_source | 선택 | UTM source (기존 값을 이 값으로 교체) |
utm_medium | 선택 | UTM medium (기존 값을 이 값으로 교체) |
utm_campaign | 선택 | UTM campaign (기존 값을 이 값으로 교체) |
utm_term | 선택 | UTM term (기존 값을 이 값으로 교체) |
utm_content | 선택 | UTM content (기존 값을 이 값으로 교체) |
tag_ids | 선택 | 전체 교체할 태그 ID 목록 |
folder_id | 선택 | 이동할 폴더 ID (폴더 해제는 아직 지원하지 않습니다) |
note | 선택 | 메모 |
is_active | 선택 | 링크 활성화 여부 |
archive_link
링크를 보관합니다. 보관하면 단축 URL이 더 이상 목적지로 연결되지 않고 비활성 안내 페이지가 표시됩니다. archived를 false로 지정하면 언제든 원래대로 복구할 수 있습니다. 영구 삭제 기능은 제공하지 않습니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
link_ids | 필수 | 보관/복구할 링크 ID 목록 (최대 50개) |
archived | 선택 | 보관 여부 (기본 true, false면 보관 해제) |
confirm | 선택 | true로 명시해야 실제로 실행됩니다. 생략하면 대상 링크 목록만 미리 보여줍니다(dry-run) |
confirm없이 호출하면 아무것도 바뀌지 않고, 보관 대상이 될 링크 목록만 미리보기로 돌려줍니다. 실수로 대량 보관되는 것을 막기 위한 안전장치입니다.
manage_tags
링크의 태그를 관리합니다. 태그 목록 조회, 링크에 태그 추가/제거가 가능합니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
action | 필수 | list, add, remove 중 하나 |
link_id | 선택 | 태그를 추가/제거할 링크 ID (add, remove 시 필수) |
tag_ids | 선택 | 추가/제거할 태그 ID 목록 (add, remove 시 필수) |
list_folders
워크스페이스의 링크 폴더 목록을 조회합니다. 파라미터는 없습니다.
create_folder
새 링크 폴더를 생성합니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
name | 필수 | 폴더 이름 |
color | 선택 | 폴더 색상 |
성과 조회
get_link_analytics
특정 링크의 기간별 클릭 통계를 조회합니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
link_id | 필수 | 분석할 링크의 ID |
start_date | 필수 | 조회 시작일 (YYYY-MM-DD) |
end_date | 필수 | 조회 종료일 (YYYY-MM-DD) |
get_workspace_summary
워크스페이스 전체의 사용량 요약과 최근 클릭 통계를 조회합니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
days | 선택 | 분석 기간 (일 단위, 기본 7일) |
get_campaign_performance
UTM 캠페인, 소스, 매체 등 차원별로 클릭 수 상위 항목을 조회합니다. 전환이나 매출 기준 순위는 아니며, 광고비나 ROAS는 제공하지 않습니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
start_date | 필수 | 조회 시작일 (YYYY-MM-DD) |
end_date | 필수 | 조회 종료일 (YYYY-MM-DD) |
dimension | 선택 | 조회할 차원 (campaign, source, medium, content, term 중 하나, 기본 campaign) |
limit | 선택 | 상위 몇 개까지 반환할지 (기본 10, 최대 50) |
get_destination_ranking
같은 목적지로 가는 링크를 묶어 기간 클릭 순위를 조회합니다. 어느 목적지로 트래픽이 몰렸는지 한 번에 볼 수 있어, 링크마다 get_link_analytics를 부르지 않아도 됩니다. 보관한 링크의 클릭도 포함하며, 숫자는 웹의 "목적지별 분석" 목록과 같습니다. 각 행의 목적지 키(목적지 URL에서 스킴과 추적 파라미터를 뺀 정규화 주소, 예: shop.example.com/landing)를 get_destination_performance의 destination에 넣으면 그 목적지 안의 링크별 성과를 이어서 볼 수 있습니다. 플랜에 따라 빠지는 항목은 없으며, 조회 기간 한도만 플랜별로 다릅니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
start_date | 필수 | 조회 시작일 (YYYY-MM-DD) |
end_date | 필수 | 조회 종료일 (YYYY-MM-DD) |
search | 선택 | 목적지 URL에 포함된 문자열로 좁히기 (요약 숫자는 바뀌지 않습니다) |
sort_by | 선택 | 정렬 기준 (clicks 또는 link_count, 기본 clicks) |
limit | 선택 | 상위 몇 개 목적지까지 반환할지 (기본 10, 최대 50) |
상위 50개까지만 반환합니다. 그보다 많다면
search로 좁혀 조회하세요.myapp://open처럼 해석할 수 없는 목적지 URL은 목적지 키 없이 링크 ID와 함께 한 줄씩 표시되며, 상세는get_link_analytics로 확인합니다.
get_destination_performance
목적지 하나로 가는 링크들의 링크별 클릭과 점유율, 출처·기기·국가·UTM 분포를 조회합니다. 같은 목적지로 가는 소재 링크 중 어느 것이 이겼는지 비교할 때 사용합니다. destination에는 get_destination_ranking이 알려준 목적지 키를 넣으며, https://shop.example.com/landing?utm_source=meta 같은 목적지 URL을 넣어도 같은 목적지로 인식합니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
destination | 필수 | 목적지 키 또는 목적지 URL (https://...) |
start_date | 필수 | 조회 시작일 (YYYY-MM-DD) |
end_date | 필수 | 조회 종료일 (YYYY-MM-DD) |
기간 총 클릭, 링크 수(보관 포함), 일별 클릭은 모든 플랜에서 반환합니다. 링크별 성과 표(단축 URL, 사용처, 클릭, 점유율, 보관·활성 상태·브라우저 전환 여부)와 출처·기기·국가·UTM 분포는 Hobby 플랜부터 제공되며, Free 플랜에서는 안내 문구로 대체됩니다. 해당 목적지로 가는 링크가 없으면 에러 대신 안내 문구를 반환합니다.
get_conversion_performance
Pro 플랜 전용입니다. Free와 Hobby 플랜에서는 전환 추적 기능이 비활성화되어 호출할 수 없습니다. 전환 추적 데이터를 기반으로 퍼널, 상위 전환 링크, 어트리뷰션별 성과를 조회합니다. link_id를 지정하면 해당 링크만 분석합니다. 전환 추적이 아직 연결되지 않았다면 빈 데이터와 함께 연동 안내가 반환됩니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
start_date | 필수 | 조회 시작일 (YYYY-MM-DD) |
end_date | 필수 | 조회 종료일 (YYYY-MM-DD, 최대 365일) |
link_id | 선택 | 단일 링크로 좁혀 분석할 링크 ID |
계정 상태
get_usage_and_limits
플랜의 기능 활성 여부, 쿼터 사용량, 한도, 조회 기간을 확인합니다. 링크를 여러 개 만들기 전이나 한도 초과 에러를 받았을 때 사용하세요.
| 파라미터 | 필수 | 설명 |
|---|---|---|
feature | 선택 | 확인할 기능 키 (미입력 시 전체 기능 반환) |
사용 예시
Claude Code에서 다음과 같이 요청할 수 있습니다:
- "https://example.com 을 단축해줘"
- "내 링크 목록을 보여줘"
- "custom-key 라는 키로 https://example.com 을 단축해줘"
- "봄 세일 캠페인용 UTM 링크를 만들어줘"
- "최근 7일 캠페인 성과를 소스별로 보여줘" (Hobby 이상은 더 긴 기간도 가능합니다)
- "이번 주 클릭이 가장 많은 랜딩과 그 안에서 성과가 좋은 소재 링크를 알려줘"
- "클릭이 거의 없는 링크를 찾아서 보관해줘"
더 많은 실전 예시는 MCP 활용 레시피를 참고하세요.