Linkly MCP 서버

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

MCP란?

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

지원되는 AI 어시스턴트

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

• Claude Desktop
• ChatGPT Desktop
• 기타 MCP 호환 클라이언트 (Cursor, Windsurf 등)

MCP 서버 또는 Linkly CLI?

AI 어시스턴트가 Claude Code나 Cursor와 같이 셸 명령을 실행할 수 있는 코딩 에이전트인 경우, MCP 서버보다 Linkly CLI가 더 적합한 선택입니다. 코딩 에이전트는 이미 명령줄 도구 사용에 익숙하며, CLI는 모든 명령에 --json 출력과 에이전트가 할 수 있는 모든 것을 발견할 수 있도록 전체 명령 트리를 인쇄하는 linkly schema 명령을 제공합니다. MCP 서버는 Claude Desktop 및 ChatGPT Desktop과 같이 셸 명령을 실행할 수 없는 어시스턴트에게 더 나은 선택입니다.

할 수 있는 작업

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

• 짧은 링크 만들기 - "https://example.com에 대한 짧은 링크 만들기"
• 성능 추적 - "이 주에 내 링크가 몇 번 클릭되었나요?"
• 링크 관리 - "'promo' 링크를 새로운 대상으로 업데이트하기"
• 분석 보기 - "지난 30일 동안 국가별 클릭 수를 보여주세요"
• 링크 검색 - "제품 출시와 관련된 모든 링크 찾기"
• 도메인 관리 - "내 커스텀 도메인 나열"
• 웹훅 설정 - "클릭 이벤트를 받도록 https://my-site.com/webhook을 구독하기"

시작하기

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

https://mcp.linklyhq.com

설정

Claude Desktop

Claude Desktop에서 Settings → Connectors → Add custom connector로 이동합니다. 이름(Linkly)과 원격 MCP 서버 URL을 입력합니다:

https://mcp.linklyhq.com

Add를 클릭한 다음 Linkly 커넥터에서 Connect를 클릭합니다. 브라우저 탭이 열려 로그인하고 액세스를 승인합니다. 그러면 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"
    }
  }
}

사용 가능한 도구

링크 생성 옵션

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

• 기본: 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

문제 해결

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

• https://mcp.linklyhq.com이 컴퓨터에서 도달 가능한지 확인합니다
• Claude Code에서 /mcp를 실행하고 linkly를 선택하여 OAuth 흐름을 다시 트리거합니다

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

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

도구가 나타나지 않음

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

관련 리소스

• Claude Desktop 통합
• ChatGPT 통합
• Linkly API 문서
• Linkly CLI
• 웹훅
• Model Context Protocol