Bitly MCP Server

공식

AI 어시스턴트를 필요에 따라 링크와 QR 코드를 생성, 정리, 분석하는 디지털 마케팅 허브로 전환하세요.

Bitly MCP(으)로 무엇을 할 수 있나요?

  • URL 단축 — AI에게 긴 URL을 단축하도록 요청하세요. 예: "이 URL을 단축해 주세요: https://example.com/very-long-url"
  • 사용 가능한 도구 탐색 — AI에게 "어떤 Bitly 도구를 사용할 수 있나요?"라고 물어 MCP 서버의 기능을 확인하세요
  • Bitly 링크 관리 — MCP 서버를 사용하여 Bitly API를 통해 단축 링크를 생성, 조회 및 관리하세요

문서

Bitly MCP 서버

Bitly MCP 서버 가이드에 오신 것을 환영합니다.

여기까지 오셨다면 MCP 서버가 무엇인지 이미 알고 계실 가능성이 높지만, 기본 개념이 필요하시다면 MCP란 무엇인가요? 페이지를 확인해 보세요.

Bitly MCP 서버는 Bitly 인터페이스에서 기대할 수 있는 모든 기능에 대한 액세스를 제공합니다. Bitly API, bitly.com 웹사이트, Bitly Chrome 확장 프로그램, Bitly 모바일 앱과 같은 기능을 이제 선택한 AI 에이전트에서 사용할 수 있습니다.

ChatGPT에서 Bitly를 사용하고 싶으신가요? Bitly MCP 서버 또는 Bitly Custom GPT를 사용하세요. Claude에서 Bitly를 사용하고 싶으신가요? Bitly MCP 서버를 사용하세요. Cursor, VSCode 또는 Windsurf에서 Bitly를 사용하고 싶으신가요? Bitly MCP 서버를 사용하세요.

빠른 설정

Bitly MCP 서버는 https://api-ssl.bitly.com/v4/mcp에서 호스팅됩니다.

인증 옵션:

  • OAuth 2.1 (권장) - OAuth를 지원하는 클라이언트의 경우 자동 클라이언트 등록과 함께 안전한 토큰 기반 인증을 제공합니다.
  • API 토큰 - 더 간단한 설정이나 OAuth를 지원하지 않는 클라이언트의 경우 https://bitly.com/settings/api에서 Bitly API 토큰을 사용하세요.

아래는 자세한 지침에 대한 링크가 포함된 구성 표입니다. 사용 중인 구성이 누락된 경우 구성 세부 정보 페이지에서 안내를 확인할 수 있습니다. 시간이 지남에 따라 추가 구성 가이드를 추가할 예정입니다.

AI 에이전트구성 지침참고 사항
ChatGPTChatGPT 구성동적 클라이언트 등록을 통한 OAuth
Claude 웹 인터페이스 (claude.ai)Claude 웹 구성동적 클라이언트 등록을 통한 OAuth
Claude DesktopClaude Desktop 구성OAuth 및 API 토큰 모두 지원
Claude CodeClaude Code 구성HTTP 전송 – OAuth 및 API 토큰 모두 지원
CursorCursor 구성HTTP 전송 – OAuth 및 API 토큰 모두 지원
VS CodeVS Code 구성HTTP 전송 – OAuth 및 API 토큰 모두 지원
WindsurfWindsurf 구성로컬 연결에 npx 프록시 사용
기타 대부분의 HTTP 호환 에이전트구성 섹션 확인일반 HTTP 설정으로 대부분 작동

구성

Claude Code

~/.claude/mcp.json에 추가:

OAuth 사용 시 (권장):

{
  "mcpServers": {
    "Bitly": {
      "type": "http",
      "url": "https://api-ssl.bitly.com/v4/mcp"
    }
  }
}

API 토큰 사용 시:

{
  "mcpServers": {
    "Bitly": {
      "type": "http",
      "url": "https://api-ssl.bitly.com/v4/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_BITLY_AUTH_TOKEN"
      }
    }
  }
}

구성 추가 후 Claude Code를 다시 시작하세요.

Cursor

~/.cursor/mcp.json에 추가:

OAuth 사용 시 (권장):

{
  "mcpServers": {
    "Bitly": {
      "type": "http",
      "url": "https://api-ssl.bitly.com/v4/mcp"
    }
  }
}

API 토큰 사용 시:

{
  "mcpServers": {
    "Bitly": {
      "type": "http",
      "url": "https://api-ssl.bitly.com/v4/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_BITLY_AUTH_TOKEN"
      }
    }
  }
}

구성 추가 후 Cursor를 다시 시작하세요.

Claude Desktop

Claude 구성 파일에 추가:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

OAuth 사용 시 (권장):

{
  "mcpServers": {
    "Bitly": {
      "url": "https://api-ssl.bitly.com/v4/mcp"
    }
  }
}

API 토큰 사용 시 (npx 프록시 사용):

전제 조건: npx 지원과 함께 Node.js 20 LTS 이상이 필요합니다.

{
  "mcpServers": {
    "Bitly": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api-ssl.bitly.com/v4/mcp",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "YOUR_BITLY_AUTH_TOKEN"
      }
    }
  }
}

구성 추가 후 Claude Desktop을 다시 시작하세요.

VS Code

작업 공간의 ~/.vscode/mcp.json에 추가:

OAuth 사용 시 (권장):

{
  "servers": {
    "Bitly": {
      "type": "http",
      "url": "https://api-ssl.bitly.com/v4/mcp"
    }
  }
}

API 토큰 사용 시:

{
  "servers": {
    "Bitly": {
      "type": "http",
      "url": "https://api-ssl.bitly.com/v4/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_BITLY_AUTH_TOKEN"
      }
    }
  }
}

Windsurf

~/.windsurf/config.json에 추가:

{
  "mcpServers": {
    "Bitly": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api-ssl.bitly.com/v4/mcp",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "YOUR_BITLY_AUTH_TOKEN"
      }
    }
  }
}

Claude 웹

웹용 Claude (claude.ai)에서는 OAuth 인증을 사용하세요:

  1. Claude 작업 공간 설정으로 이동
  2. MCP 서버 구성 섹션으로 이동
  3. Bitly MCP 서버 추가:
    • 서버 URL: https://api-ssl.bitly.com/v4/mcp
      • 인증: OAuth

메시지가 표시되면 Bitly 계정에 로그인하고 연결을 승인하세요. Claude가 동적 클라이언트 등록을 사용하여 OAuth 흐름을 자동으로 처리합니다.

참고: Claude 웹의 OAuth 지원은 팀 및 엔터프라이즈 요금제에서 작업 공간 관리자 활성화가 필요합니다.

ChatGPT

ChatGPT에서는 OAuth 인증을 사용하세요:

  1. ChatGPT에서 설정 > 앱 및 커넥터 > 고급 설정으로 이동
  2. 개발자 모드를 켜기
  3. 뒤로 돌아가 만들기 클릭
  4. Bitly MCP 서버 추가:
    • 서버 URL: https://api-ssl.bitly.com/v4/mcp
      • 인증: OAuth

메시지가 표시되면 Bitly 계정에 로그인하고 연결을 승인하세요. ChatGPT가 동적 클라이언트 등록을 사용하여 OAuth 흐름을 자동으로 처리합니다.

참고: ChatGPT의 MCP 지원은 Plus, Team, Enterprise 또는 Edu 요금제가 필요합니다. 작업 공간 요금제의 경우 이러한 설정에 액세스하려면 관리자여야 합니다.

인증

Bitly MCP 서버는 두 가지 인증 방법을 지원합니다:

동적 클라이언트 등록을 통한 OAuth 2.1 (권장)

OAuth를 지원하는 클라이언트(Claude 웹, ChatGPT 및 기타 최신 AI 어시스턴트 등)의 경우 OAuth는 다음을 제공합니다:

  • 향상된 보안 - API 토큰을 수동으로 관리할 필요 없음
  • 자동 클라이언트 등록 - 동적 클라이언트 등록(DCR)이 클라이언트 설정을 자동으로 처리
  • 토큰 갱신 - 수동 개입 없이 자동 토큰 갱신

OAuth를 구성할 때 AI 클라이언트는 다음을 수행합니다:

  1. Bitly의 인증 페이지로 리디렉션
  2. 로그인 및 연결 승인 요청
  3. DCR을 사용하여 OAuth 클라이언트로 자동 등록
  4. 액세스 토큰을 투명하게 수신 및 관리

API 토큰 (대안)

더 간단한 설정이나 OAuth를 지원하지 않는 클라이언트의 경우:

  1. bitly.com에서 Bitly 계정에 로그인
  2. 설정 → API로 이동
  3. 액세스 토큰 생성을 클릭
  4. 토큰을 복사하여 안전하게 저장
  5. 위 예시와 같이 MCP 클라이언트 구성에서 사용

테스트

구성이 완료되면 AI에게 다음을 시도해 보세요:

"What Bitly tools are available?"

또는

"Please shorten this URL: https://example.com/very-long-url"

이제 모든 준비가 완료되었습니다!