본문 바로가기
cutty.dev
MCP · AI 에이전트용

AI 에이전트가 직접 다루는 URL 단축기

Model Context Protocol로 cutty를 연결해, 단축부터 국가 타기팅과 A/B 테스트까지 어시스턴트와의 대화에서 바로 링크를 관리하세요.

cutty는 AI 어시스턴트가 대신 운영해 주는 링크 단축기입니다. MCP로 한 번만 연결하면 채팅에서 이렇게 말하기만 하면 됩니다. "이 링크 줄여줘", "독일 방문자는 다른 사람들과 다른 곳으로 보내줘", "두 랜딩 페이지에 트래픽을 반반 나눠줘". 에이전트가 알아서 처리합니다 — 대시보드가 필요 없습니다.

MCP란

Model Context Protocol은 AI 어시스턴트(Claude, Cursor 등 점점 늘어나는 목록)가 외부 도구와 소통하는 데 사용하는 오픈 표준입니다. cutty 서버는 단축기를 모델이 대화 중에 호출할 수 있는 도구 모음으로 제공합니다. 코드를 작성할 필요 없이, 서버를 연결하고 원하는 결과를 평범한 말로 요청하면 됩니다.

열 가지 도구

링크 기본: create_link, list_links, get_link, update_link, delete_link — 비밀번호, 만료, 클릭 제한, 태그, 폴더까지 완전한 관리.

대규모 작업용: qr_link(모든 링크의 QR 코드), get_link_stats(클릭 분석: 기기, 브라우저, 시간대), bulk_create_links(한 번에 최대 500개 링크).

다른 곳에는 드문 기능:

  • set_link_targeting — 링크 하나가 방문자의 국가기기에 따라 다른 목적지로 연결됩니다(예: 미국 → 미국 스토어, 아이폰 → App Store).
  • set_link_ab_test — 가중치 기반 A/B 테스트: 각 클릭이 설정한 가중치 비율에 따라 여러 변형 중 하나로 무작위 이동합니다.

1분이면 준비 완료

1. API 키 만들기. 무료 계정을 만들고 대시보드API 키키 생성을 엽니다. 전체 키(ck_로 시작)는 한 번만 표시되니 바로 저장하세요.

2. 서버 연결. 엔드포인트는 https://mcp.cutty.dev/mcp(Streamable HTTP 전송)이며, API에 쓰는 것과 같은 키로 인증합니다.

Claude Code에서는 명령어 하나면 됩니다.

claude mcp add --transport http cutty https://mcp.cutty.dev/mcp \
  --header "Authorization: Bearer ck_twoj_klucz"

Claude Desktop, Cursor 및 기타 클라이언트에서는 MCP 설정에 항목을 추가하세요.

{
  "mcpServers": {
    "cutty": {
      "url": "https://mcp.cutty.dev/mcp",
      "headers": {
        "Authorization": "Bearer ck_twoj_klucz"
      }
    }
  }
}

터미널에서 간단히 확인해 보세요 — 도구 목록이 출력되어야 합니다.

curl -s https://mcp.cutty.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer ck_twoj_klucz" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

기본이 프라이버시

서버는 무상태(stateless)입니다 — 키를 저장하지 않고 매 요청마다 API로 전달만 합니다. 유럽연합에 호스팅되며, 추적 픽셀이나 리타기팅이 없습니다. 키 하나로 API와 MCP를 모두 쓸 수 있어 별도 자격 증명을 관리할 필요가 없습니다.

일반 REST가 더 편하다면

이 모든 동작은 일반 API에도 있습니다 — 자세한 내용과 curl 예제는 API 문서에 있습니다. 문제가 있나요? [email protected]로 메일 주시면 당일에 답장드립니다.