Bitly MCP Server

официальный

Превратите вашего ИИ-ассистента в центр цифрового маркетинга, который создает, организует и анализирует ссылки и QR-коды по запросу.

Что можно делать с Bitly MCP?

  • Сокращение URL — Попросите вашего ИИ сократить длинный URL, например: «Пожалуйста, сократите этот URL: https://example.com/very-long-url»
  • Обнаружение доступных инструментов — Спросите вашего ИИ: «Какие инструменты Bitly доступны?», чтобы получить список возможностей MCP-сервера
  • Управление ссылками Bitly — Используйте MCP-сервер для создания, получения и управления короткими ссылками через Bitly API

Размещённый MCP-сервер

npx add-mcp 'https://api-ssl.bitly.com/v4/mcp'

Устанавливается в Claude Code, Codex, Cursor и другие

Документация

Bitly MCP Server

Добро пожаловать в руководство по Bitly MCP Server.

Если вы здесь, то, вероятно, уже знаете, что такое MCP Server, но если вам нужно введение, ознакомьтесь с нашей страницей «Что такое MCP?».

Bitly MCP Server предоставляет доступ ко всем функциям, которые вы ожидаете от интерфейса Bitly — например, к Bitly API, bitly.com, расширению Bitly для Chrome, мобильному приложению Bitly — но теперь для вашего ИИ-агента по выбору.

Хотите использовать Bitly с ChatGPT? Bitly MCP Server или Bitly Custom GPT. Хотите использовать Bitly с Claude? Bitly MCP Server. Хотите использовать Bitly с Cursor, VSCode или Windsurf? Bitly MCP Server.

Быстрая настройка

Bitly MCP Server размещён по адресу https://api-ssl.bitly.com/v4/mcp.

Варианты аутентификации:

  • OAuth 2.1 (рекомендуется) — для клиентов, поддерживающих OAuth, обеспечивает безопасную аутентификацию на основе токенов с автоматической регистрацией клиента
  • API-токен — для более простых настроек или клиентов без поддержки OAuth используйте свой API-токен Bitly с https://bitly.com/settings/api

Ниже приведена таблица конфигураций со ссылками на подробные инструкции — если здесь нет нужной вам, вы найдёте рекомендации на странице Configuration Details. Мы будем добавлять дополнительные руководства по настройке со временем.

ИИ-агентИнструкции по настройкеПримечания
ChatGPTНастроить ChatGPTOAuth с динамической регистрацией клиента
Веб-интерфейс Claude (claude.ai)Настроить Claude WebOAuth с динамической регистрацией клиента
Claude DesktopНастроить Claude DesktopПоддерживает и OAuth, и API-токен
Claude CodeНастроить Claude CodeHTTP-транспорт — поддерживает и OAuth, и API-токен
CursorНастроить CursorHTTP-транспорт — поддерживает и OAuth, и API-токен
VS CodeНастроить VS CodeHTTP-транспорт — поддерживает и OAuth, и API-токен
WindsurfНастроить WindsurfИспользует прокси npx для локального подключения
Большинство других HTTP-совместимых агентовСмотрите наш раздел ConfigurationУниверсальная 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-прокси):

Предварительное требование: требуется Node.js 20 LTS или выше с поддержкой npx.

{
  "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 Web

Для Claude в вебе (claude.ai) используйте аутентификацию OAuth:

  1. Перейдите в настройки рабочего пространства Claude
  2. Откройте раздел конфигурации MCP-серверов
  3. Добавьте Bitly MCP Server:
    • URL сервера: https://api-ssl.bitly.com/v4/mcp
      • Аутентификация: OAuth

При появлении запроса войдите в свою учётную запись Bitly и авторизуйте подключение. Claude автоматически обработает поток OAuth с помощью динамической регистрации клиента.

Примечание: поддержка OAuth в Claude Web требует включения администратором рабочего пространства для тарифов Team и Enterprise.

ChatGPT

Для ChatGPT используйте аутентификацию OAuth:

  1. В ChatGPT перейдите в Settings > Apps & Connectors > Advanced Settings
  2. Включите Developer Mode
  3. Вернитесь назад и нажмите Create
  4. Добавьте Bitly MCP Server:
    • URL сервера: https://api-ssl.bitly.com/v4/mcp
      • Аутентификация: OAuth

При появлении запроса войдите в свою учётную запись Bitly и авторизуйте подключение. ChatGPT автоматически обработает поток OAuth с помощью динамической регистрации клиента.

Примечание: поддержка MCP в ChatGPT требует тарифов Plus, Team, Enterprise или Edu. Для рабочих пространств доступ к этим настройкам возможен только администратором.

Аутентификация

Bitly MCP Server поддерживает два метода аутентификации:

OAuth 2.1 с динамической регистрацией клиента (рекомендуется)

Для клиентов, поддерживающих OAuth (например, Claude Web, ChatGPT и другие современные ИИ-ассистенты), OAuth обеспечивает:

  • Повышенную безопасность — нет необходимости вручную управлять API-токенами
  • Автоматическую регистрацию клиента — динамическая регистрация клиента (DCR) автоматически настраивает клиент
  • Обновление токенов — автоматическое продление токенов без ручного вмешательства

При настройке OAuth ваш ИИ-клиент:

  1. Перенаправит вас на страницу авторизации Bitly
  2. Попросит войти и авторизовать подключение
  3. Автоматически зарегистрируется как OAuth-клиент через DCR
  4. Прозрачно получит и будет управлять токенами доступа

API-токен (альтернатива)

Для более простых настроек или клиентов без поддержки OAuth:

  1. Войдите в свою учётную запись Bitly на bitly.com
  2. Перейдите в Settings → API
  3. Нажмите Generate Access Token
  4. Скопируйте токен и храните его в безопасном месте
  5. Используйте его в конфигурации вашего MCP-клиента, как показано в примерах выше

Проверьте работу

После настройки попробуйте спросить вашего ИИ:

"What Bitly tools are available?"

или

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

После этого всё должно быть готово!