Linkly MCP 서버

Linkly MCP 서버를 사용하면 Model Context Protocol을 통해 AI 어시스턴트를 Linkly 계정에 연결할 수 있습니다. 연결되면 자연스러운 대화를 통해 짧은 링크를 생성하고 관리할 수 있습니다.

MCP란?

Model Context Protocol(MCP)은 AI 어시스턴트가 외부 도구 및 데이터 소스에 안전하게 연결할 수 있도록 하는 개방형 표준입니다. 앱 간에 복사하여 붙여넣는 대신 AI 어시스턴트에게 작업을 직접 수행하도록 요청할 수 있습니다.

지원되는 AI 어시스턴트

Linkly MCP 서버는 다음과 함께 작동합니다:

찾을 수 있는 위치

Linkly MCP 서버는 주요 MCP 디렉토리에 나열되어 있으므로 커넥터를 찾는 곳이면 어디서나 설치할 수 있습니다:

MCP 서버 또는 Linkly CLI?

AI 어시스턴트가 셸 명령을 실행할 수 있는 코딩 에이전트인 경우 — Claude Code 또는 Cursor와 같은 — MCP 서버보다 Linkly CLI가 더 적합한 경우가 많습니다. 코딩 에이전트는 이미 명령줄 도구를 사용하는 데 익숙하며, CLI는 모든 명령에서 --json 출력과 에이전트가 수행할 수 있는 모든 작업을 검색할 수 있는 linkly schema 명령을 제공합니다. MCP 서버는 Claude Desktop 및 ChatGPT Desktop과 같이 셸 명령을 실행할 수 없는 어시스턴트에 더 나은 선택으로 남아 있습니다.

수행할 수 있는 작업

연결되면 AI 어시스턴트에게 다음을 요청할 수 있습니다:

  • 짧은 링크 생성 - "https://example.com용 짧은 링크 생성"
  • 성능 추적 - "이번 주에 내 링크가 얼마나 많은 클릭을 받았나요?"
  • 링크 관리 - "'프로모'라는 링크를 새로운 목적지로 업데이트"
  • 분석 보기 - "지난 30일 동안 국가별 클릭 표시"
  • 링크 검색 - "제품 출시와 관련된 모든 링크 찾기"
  • 도메인 관리 - "내 커스텀 도메인 나열"
  • 웹훅 설정 - "https://my-site.com/webhook 구독하여 클릭 이벤트 수신"

시작하기

호스팅된 Linkly MCP 서버는 https://mcp.linklyhq.com에 위치합니다. 설치할 항목이 없고 복사할 API 키도 없습니다 — 서버는 OAuth를 사용하므로 AI 어시스턴트가 처음 연결될 때 브라우저 창이 열려 Linkly에 로그인하고 액세스를 승인하도록 요청합니다. 그 후 어시스턴트는 연결된 상태로 유지됩니다.

https://mcp.linklyhq.com

구성

Claude Desktop

Claude Desktop에서 설정 → 커넥터 → 커스텀 커넥터 추가로 이동합니다. 이름(Linkly)과 원격 MCP 서버 URL을 입력합니다:

https://mcp.linklyhq.com

추가를 클릭한 후 Linkly 커넥터에서 연결을 클릭합니다. 로그인하고 액세스를 승인할 수 있도록 브라우저 탭이 열립니다. 그러면 Claude Desktop은 연결된 상태로 유지됩니다 — 구성 파일이나 추가 도구가 필요하지 않습니다.

Claude Code(CLI)

Claude Code는 원격 MCP 서버를 기본적으로 지원합니다. 한 명령으로 Linkly를 추가하세요:

claude mcp add --transport http linkly https://mcp.linklyhq.com

그런 다음 Claude Code 내에서 /mcp를 실행하고 linkly를 선택한 후 메시지가 표시되면 브라우저에서 권한을 부여합니다.

ChatGPT Desktop

ChatGPT 구성 파일을 엽니다:

  • macOS: ~/Library/Application Support/ChatGPT/mcp_servers.json
  • Windows: %APPDATA%\ChatGPT\mcp_servers.json

Linkly MCP 서버를 추가합니다:

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com"
    }
  }
}

사용 가능한 도구

도구설명
create_link선택 사항 UTM 매개변수, 픽셀 등을 사용하여 새로운 짧은 링크 생성
update_link기존 링크의 설정 업데이트
delete_link링크 삭제
get_link특정 링크의 세부 정보 가져오기
list_links작업 공간의 모든 링크 나열
search_links이름, URL 또는 메모로 링크 검색
get_clicks최근 클릭 데이터 가져오기
get_analytics차트를 위한 시계열 클릭 데이터 가져오기
get_analytics_by국가, 브라우저, 플랫폼 등으로 그룹화된 클릭 가져오기
list_domains커스텀 도메인 나열
list_webhooks작업 공간 웹훅 구독 나열
subscribe_webhook클릭 이벤트를 수신하기 위해 URL 구독

링크 생성 옵션

링크를 생성할 때 다음을 지정할 수 있습니다:

  • 기본: url, name, note, domain, slug, enabled
  • UTM 매개변수: utm_source, utm_medium, utm_campaign, utm_term, utm_content
  • Open Graph: og_title, og_description, og_image
  • 추적: fb_pixel_id, ga4_tag_id, gtm_id
  • 고급: cloaking, forward_params, block_bots, hide_referrer
  • 만료: expiry_datetime, expiry_destination
  • 고유 데이터: metadata, 시스템의 ID와 같은 키-값 쌍. 링크와 함께 반환되고 웹훅 페이로드에 포함됩니다. 링크 메타데이터 참조

문제 해결

"MCP 서버에 연결할 수 없음"

  • https://mcp.linklyhq.com에 머신에서 접근 가능한지 확인합니다
  • Claude Code에서 /mcp를 실행하고 linkly를 선택하여 OAuth 흐름을 다시 트리거합니다

"인증 실패", "invalid_client" 또는 브라우저가 계속 로그인을 요청함

이는 클라이언트가 오래된 연결 등록을 보유하고 있음을 의미합니다. 캐시된 자격 증명을 지우고 다시 권한을 부여합니다. Claude Code에서 /mcp → linkly → 다시 연결을 실행합니다. Claude Desktop에서 설정 → 커넥터 아래의 Linkly 커넥터를 제거하고 다시 추가한 후 다시 로그인합니다.

도구가 나타나지 않음

  • 구성을 저장한 후 AI 어시스턴트를 다시 시작합니다
  • 구성 파일의 JSON 구문이 유효한지 확인합니다
  • MCP 서버가 실행 중인지 확인합니다(어시스턴트에서 도구 아이콘 확인)

관련 리소스

MCP 서버 FAQ

MCP 서버를 사용하기 위해 아무것도 설치해야 하나요?

아니요. https://mcp.linklyhq.com의 호스팅된 서버는 OAuth를 사용합니다 — 브라우저에서 한 번 로그인하면 AI 어시스턴트는 연결된 상태로 유지됩니다. AI 어시스턴트 자체 외에는 머신에 설치할 소프트웨어가 없습니다.

API 키가 필요한가요?

아니요. MCP 서버는 OAuth를 사용합니다 — AI 어시스턴트가 처음 연결될 때 브라우저를 통해 Linkly에 로그인하며, 복사하거나 붙여넣을 API 키가 없습니다.

어떤 AI 어시스턴트가 MCP를 지원하나요?

Claude Desktop, Claude Code(CLI) 및 ChatGPT Desktop은 모두 MCP를 지원합니다. Cursor 및 Windsurf와 같은 다른 도구도 MCP 지원을 제공합니다.

내 계정이 안전한가요?

네. 호스팅된 서버는 PKCE를 사용하는 OAuth 2.1을 사용합니다 — Linkly 암호는 app.linklyhq.com에서만 입력되며, AI 어시스턴트는 작업 공간으로 범위가 지정된 액세스 토큰만 봅니다. AI 모델 자체는 자격 증명을 절대 보지 않습니다.

MCP 서버가 워크스페이스에서 내 역할을 존중하나요?

네. AI 어시스턴트는 역할이 허용하는 것만 수행할 수 있으며 그 이상은 불가능합니다. 읽기 역할이 있으면 링크와 분석을 조회할 수 있지만 만들거나, 편집하거나, 삭제할 수 없습니다.

Claude 또는 ChatGPT의 웹 버전과 함께 MCP를 사용할 수 있나요?

아니요, MCP는 데스크탑 애플리케이션 또는 Claude Code CLI가 필요합니다. 웹 버전은 MCP 연결을 지원하지 않습니다.

MCP 서버를 어떻게 업데이트하나요?

업데이트할 항목이 없습니다 — 호스팅된 서버에 지속적으로 개선 사항을 배포하며 모든 연결된 클라이언트가 자동으로 이를 받습니다.

이용 가능 요금제

Pro 이상 요금제에서 이용 가능

요금제 비교 →

월 500회 클릭 추적 무료.