Model Context Protocol

LinkTwin MCP 서버: AI 에이전트가 링크를 만들고 관리하게 하세요.

링크 단축과 딥링크를 위한 공식 MCP 서버. Claude, Cursor 등 AI 어시스턴트를 LinkTwin 계정에 연결하고 요청만 하세요: 단축 링크와 딥링크 만들기, 컬렉션 정리, 픽셀 연결, QR 코드 생성, 분석 조회.

설정 방법 보기

$ npx -y @linktwin/mcp

MIT 라이선스, npm에서 제공
내 컴퓨터에서 실행
모든 MCP 클라이언트와 호환

AI 어시스턴트 LinkTwin 도구 34개

내 데스크 투어 영상 https://www.youtube.com/watch?v=x7K2pQ9mW4s 의 단축 링크를 별칭 desk-tour로 만들고, YouTube 컬렉션에 추가해 주세요.

linktwin create_link실행 중 완료

{
  "url": "https://www.youtube.com/watch?v=x7K2pQ9mW4s",
  "custom": "desk-tour",
  "collections": ["YouTube"]
}

완료했습니다. 새 링크가 YouTube 컬렉션에 추가되었습니다:

linktw.in/desk-tourYouTube 앱에서 열림

지난 30일 동안 클릭이 가장 많았던 내 링크는 무엇이고, 클릭은 어디서 왔나요?

linktwin get_detailed_stats실행 중 완료

{
  "date_range": "30d"
}

데스크 투어 링크가 504회 클릭으로 1위입니다. 트래픽은 Instagram에서 가장 많이 왔고, 클릭 대부분은 미국에서 발생했습니다.

linktw.in/desk-tour상위 유입 경로: Instagram

내 Amazon 링크에 Meta 픽셀을 연결한 다음, linktw.in/desk-tour용 QR 코드를 만들어 주세요.

linktwin list_links실행 중 완료

{
  "search": "amazon"
}

linktwin assign_pixel_to_links실행 중 완료

{
  "id": 4,
  "add": [1224,1225]
}

linktwin create_qr_code실행 중 완료

{
  "type": "link",
  "data": "https://linktw.in/desk-tour"
}

이제 두 Amazon 링크 모두에서 Meta 픽셀이 실행되며, 데스크 투어용 QR 코드를 다운로드할 수 있습니다.

예시 대화입니다. 도구 이름과 인수는 실제와 같습니다.

MCP 서버가 필요한 이유

"이거 단축해 줘"부터 완료까지, 채팅을 떠나지 않고.

대시보드로 전환하거나 REST API를 직접 연동하면 흐름이 끊깁니다. LinkTwin MCP 서버는 AI 어시스턴트에게 일급 링크 관리 도구를 제공하므로, 사용자가 대화를 이어가는 동안 캠페인 링크, 딥링크, QR 코드를 대신 만들어줍니다.

완료까지의 단계

대시보드와 복사·붙여넣기
LinkTwin MCP 서버

별칭으로 링크 만들기

이번 달 상위 링크 찾기

이미 로그인한 사람 기준입니다. 블록 하나가 동작 하나입니다. 일부 클라이언트에서는 도구를 항상 허용할 수 있어 승인 단계도 사라집니다.

작업 MCP 없이 LinkTwin MCP 사용 시

링크 만들기 채팅과 대시보드를 오가며 복사·붙여넣기 요청만으로 링크 만들기

타겟팅 및 UTM API 호출과 인증 헤더를 일일이 작성 프롬프트 하나로 딥링크, 타겟팅, UTM까지

내 수치 AI가 링크나 통계를 볼 수 없음 AI가 필요할 때 분석을 읽어옴

반복 작업 느리고, 오류가 잦고, 반복적임 몇 초 만에 끝나는 대량 작업

설정

세 단계로 연결하기

설치할 것이 없습니다: npx가 필요할 때 서버를 실행합니다. Node.js 18 이상과 API 키만 있으면 됩니다.

API 키 받기

LinkTwin 대시보드의 설정 또는 MCP 서버 페이지에서 API 키를 복사하세요. API 액세스는 모든 플랜에서 제공됩니다.
설정 스니펫 추가하기

아래 JSON을 AI 클라이언트 설정에 붙여넣고 API 키를 넣으세요.
그냥 요청하세요

클라이언트를 재시작하고 링크를 만들고, 편집하고, 분석해달라고 요청하세요. LinkTwin 도구가 자동으로 나타납니다.

스니펫 하나로 연결

Claude Desktop, Cursor 또는 모든 MCP 클라이언트에 추가한 다음 재시작하세요.

Claude Desktop

Claude Desktop에서 설정(Settings), 개발자(Developer), 구성 편집(Edit Config) 순서로 여세요. claude_desktop_config.json에 블록을 붙여넣으세요.

{
  "mcpServers": {
    "linktwin": {
      "command": "npx",
      "args": ["-y", "@linktwin/mcp"],
      "env": { "LINKTWIN_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Cursor

Cursor에서는 프로젝트에 .cursor/mcp.json을 만들고 블록을 붙여넣으세요.

{
  "mcpServers": {
    "linktwin": {
      "command": "npx",
      "args": ["-y", "@linktwin/mcp"],
      "env": { "LINKTWIN_API_KEY": "YOUR_API_KEY" }
    }
  }
}

기타 MCP 클라이언트

Claude Code, Windsurf, Cline 등 다른 MCP 클라이언트도 MCP 설정에 같은 JSON을 사용합니다.

{
  "mcpServers": {
    "linktwin": {
      "command": "npx",
      "args": ["-y", "@linktwin/mcp"],
      "env": { "LINKTWIN_API_KEY": "YOUR_API_KEY" }
    }
  }
}

환경 변수 두 개

서버는 stdio로 JSON-RPC 통신을 하며, 설정 파일의 env 블록에서 설정을 읽습니다.

변수	역할
`LINKTWIN_API_KEY`	필수. LinkTwin 설정 페이지에서 받은 API 키입니다.
`LINKTWIN_BASE_URL`	선택 사항. 서버가 호출하는 사이트 루트입니다. 기본값은 https://linktw.in입니다.

함께 쓰는 도구

Claude Desktop
Claude Code
Cursor
Windsurf
Cline
모든 MCP 클라이언트

Node.js 18 이상, 그 외에는 설치할 것이 없습니다.
도구 이름이 하는 일을 그대로 나타내므로, 평소 쓰는 말로 요청하면 됩니다.
터미널이 더 편하신가요? LinkTwin CLI를 사용하세요. 직접 연동을 만드시나요? API 문서를 읽어 보세요.

기능

에이전트가 관리할 수 있는 모든 것

LinkTwin 링크 관리의 모든 영역을 아우르는 34개의 도구. 모든 링크 도구는 지역, 기기, 언어 타겟팅, A/B 테스트 변형, UTM 매개변수를 지원하며, 프롬프트 하나로 설정할 수 있습니다.

개의 도구, 7개 그룹. 각 도구는 LinkTwin REST API 엔드포인트 하나를 감싸며, 실행 전에 입력을 검사합니다.

링크6

커스텀 별칭, 만료, 비밀번호, 클릭 제한과 함께 링크를 만들고, 편집하고, 나열하고, 삭제하세요.

create_link단축 링크 만들기
list_links링크 목록
get_link링크 조회
update_link링크 수정
delete_link링크 삭제
bulk_delete_links링크 일괄 삭제

분석4

링크별 및 계정 전체 클릭 통계: 상위 국가, 추천 소스, 브라우저, 기기, 일별 트렌드.

get_link_stats링크 분석 조회
get_dashboard_stats계정 대시보드 통계
get_detailed_stats계정 상세 통계
get_day_trend계정 일별 추이

컬렉션6

링크를 컬렉션으로 묶고 브랜드 커스텀 도메인을 관리하세요.

list_collections컬렉션 목록
get_collection컬렉션 항목 조회
create_collection컬렉션 생성
update_collection컬렉션 수정
add_links_to_collection컬렉션에 링크 추가/제거
delete_collection컬렉션 삭제

도메인4

브랜드 도메인을 추가하고, 루트 도메인과 존재하지 않는 링크로 들어온 방문자를 어디로 보낼지 정하세요.

list_domains도메인 목록
add_domain브랜드 도메인 추가
update_domain도메인 수정
delete_domain도메인 삭제

픽셀6

Facebook, GTM 등 픽셀을 만들고 링크에 대량으로 추가하세요.

list_pixels픽셀 목록
get_pixel픽셀 조회
create_pixel픽셀 생성
update_pixel픽셀 수정
delete_pixel픽셀 삭제
assign_pixel_to_links링크에 픽셀 할당

QR 코드5

색상과 로고를 적용해 모든 링크의 QR 코드를 생성하고 업데이트하세요.

list_qr_codesQR 코드 목록 조회
get_qr_codeQR 코드 조회
create_qr_codeQR 코드 생성
update_qr_codeQR 코드 수정
delete_qr_codeQR 코드 삭제

계정3

플랜과 사용량을 확인하고, 기본 도메인과 시간대를 설정하고, 워크스페이스를 전환하세요.

get_account계정 정보 조회
update_account_settings계정 설정 수정
switch_workspace워크스페이스 전환

어시스턴트에게 요청해보세요

평소 말하듯이 요청을 쓰세요. 어시스턴트가 도구를 고르고, 인수를 채우고, 무엇을 했는지 알려 줍니다.

캠페인 링크 만들기

https://example.com/spring-sale에 대해 별칭 spring-sale로 단축 링크를 만들고 내 Marketing 컬렉션에 추가해줘.

호출
create_link

국가별로 방문자 보내기

캐나다 방문자는 example.ca에서, 나머지 모두는 example.com에서 열리는 딥링크를 만들어줘.

호출
create_link

가장 성과 좋은 링크 찾기

이번 달에 내 링크 중 어느 것이 가장 많은 클릭을 받았고, 트래픽은 어디에서 왔어?

호출
get_detailed_stats

QR 코드 및 리타겟팅

내 최신 링크의 QR 코드를 생성하고 거기에 내 Facebook 픽셀을 추가해줘.

호출
list_links
create_qr_code
list_pixels
assign_pixel_to_links

오래된 테스트 정리

제목에 "test"가 들어간 내 링크를 찾아서 삭제해 주세요.

호출
list_links
bulk_delete_links

팀 워크스페이스에서 작업

팀 워크스페이스로 전환하고 우리가 쓸 수 있는 브랜드 도메인 목록을 보여 주세요.

호출
get_account
switch_workspace
list_domains

LinkTwin MCP 서버 작동 방식

AI 클라이언트가 npx로 내 컴퓨터에서 서버를 시작하고 stdio로 통신합니다. 서버는 내 계정 안에서 API 키를 사용해 HTTPS로 LinkTwin API를 호출합니다.

내 AI 클라이언트 Claude, Cursor, Windsurf, Cline 또는 모든 MCP 클라이언트
stdio
LinkTwin MCP 서버 npx -y @linktwin/mcp로 시작 내 컴퓨터에서
HTTPS + API 키
LinkTwin API 내 링크, 컬렉션, 픽셀, QR 코드, 통계

API 키가 허용하는 작업만, 내 계정과 워크스페이스 안에서만 수행합니다.
잘못된 키, 속도 제한, 플랜 한도, 잘못된 입력 같은 오류는 오류로 표시된 도구 결과로 돌아오므로, 에이전트가 설명하거나 다시 시도할 수 있습니다.
에이전트가 delete_link나 bulk_delete_links 같은 삭제 도구를 호출하지 않는 한 아무것도 삭제되지 않습니다.
API 키를 언제든 재발급해 즉시 액세스를 취소할 수 있습니다.

MCP 서버 관련 질문

링크 단축 및 딥링크 MCP에 관한 모든 것. 더 궁금한 점이 있나요? 문의하기.

LinkTwin MCP 서버란 무엇인가요?

LinkTwin MCP 서버는 링크 단축과 딥링크를 위한 공식 Model Context Protocol(MCP) 서버입니다. Claude, Cursor 같은 AI 어시스턴트를 LinkTwin 계정에 연결해, 평소 말투의 대화만으로 단축 링크와 딥링크를 만들고 편집하고 관리하며, 컬렉션을 정리하고, 리타겟팅 픽셀을 연결하고, QR 코드를 생성하고, 클릭 분석을 읽을 수 있게 합니다.

MCP(Model Context Protocol) 서버란 무엇인가요?

MCP는 AI 어시스턴트가 외부 도구와 데이터에 연결할 수 있게 해 주는 개방형 표준입니다. MCP 서버는 어시스턴트가 호출할 수 있는 도구 모음을 제공합니다. LinkTwin MCP 서버는 34개의 링크 관리 도구를 제공하므로, MCP 호환 앱(Claude Desktop, Claude Code, Cursor, Windsurf, Cline 등)이 링크를 대신 관리할 수 있습니다.

링크 단축 MCP는 무료인가요?

MCP 서버 자체는 무료이며 MIT 라이선스로 npm에 @linktwin/mcp로 배포되어 있습니다. LinkTwin API를 통해 작동하며, API 액세스는 모든 플랜에서 제공됩니다. 먼저 무료 계정을 만들고 에이전트를 연결할 준비가 되면 업그레이드하세요.

어떤 AI 클라이언트가 지원되나요?

stdio로 Model Context Protocol을 지원하는 모든 클라이언트입니다. Claude Desktop, Claude Code, Cursor, Windsurf, Cline 등이 포함됩니다. 클라이언트의 MCP 설정에 JSON 스니펫 하나를 추가하고 재시작하면 LinkTwin 도구가 나타납니다.

MCP 서버로 단축 링크뿐 아니라 딥링크도 만들 수 있나요?

네. 링크 단축 MCP이자 딥링크 MCP입니다. 어시스턴트를 통해 YouTube, Amazon, Spotify 같은 앱에서 열리는 링크를 만들 수 있으며, 지역, 기기, 언어 타겟팅, A/B 테스팅 변형, UTM 매개변수, 브랜드 도메인, 인앱 브라우저 탈출까지 지원합니다. LinkTwin 대시보드 및 API와 같은 옵션입니다.

API 키는 어떻게 받나요?

LinkTwin에 로그인한 뒤 대시보드에서 설정을 열거나, 도구 및 연동에서 MCP 서버를 여세요. API 키를 복사해 MCP 클라이언트 설정에 LINKTWIN_API_KEY로 붙여넣으세요. 키는 플랜에 API 액세스가 포함되면 표시됩니다.

AI 에이전트에게 내 링크 접근 권한을 주는 게 안전한가요?

MCP 서버는 내 컴퓨터에서 실행되며, API 키가 허용하는 작업만 내 계정 안에서 수행합니다. 키는 내 컴퓨터에서 LinkTwin API로만 전송되며 제3자와 공유되지 않습니다. 무언가를 삭제하려면 명시적인 도구 호출이 필요하고, API 키를 언제든 재발급해 즉시 액세스를 취소할 수 있습니다.

LinkTwin MCP 서버에는 어떤 도구가 있나요?

7개 그룹의 도구 34개: 링크(create_link, list_links, get_link, update_link, delete_link, bulk_delete_links), 분석(get_link_stats, get_dashboard_stats, get_detailed_stats, get_day_trend), 컬렉션, 브랜드 도메인, 리타겟팅 픽셀, QR 코드, 계정. 각 도구는 LinkTwin REST API를 얇게 감싼 것으로, API 문서에 설명되어 있습니다.

무언가를 설치해야 하나요?

Node.js 18 이상만 있으면 됩니다. 설정 스니펫이 npx -y @linktwin/mcp로 필요할 때 서버를 실행하므로, 전역 설치가 필요 없고 항상 배포된 버전을 사용합니다.

API 키 하나, 세 가지 개발 방식

REST API, MCP 서버, CLI는 모두 같은 API 키를 사용하고 같은 링크를 관리합니다.

REST API

직접 작성한 코드로 링크 자동화

URL 단축 API 보기

명령줄

터미널에서 링크 단축

LinkTwin CLI 보기

API 문서

모든 엔드포인트와 예제

API 문서 읽기

AI에게 링크 관리 능력을 부여하세요

LinkTwin MCP 서버를 연결하고 대화로 링크를 만들어 보세요.