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 | Настроить ChatGPT | OAuth с динамической регистрацией клиента |
| Веб-интерфейс Claude (claude.ai) | Настроить Claude Web | OAuth с динамической регистрацией клиента |
| Claude Desktop | Настроить Claude Desktop | Поддерживает и OAuth, и API-токен |
| Claude Code | Настроить Claude Code | HTTP-транспорт — поддерживает и OAuth, и API-токен |
| Cursor | Настроить Cursor | HTTP-транспорт — поддерживает и OAuth, и API-токен |
| VS Code | Настроить VS Code | HTTP-транспорт — поддерживает и 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:
- Перейдите в настройки рабочего пространства Claude
- Откройте раздел конфигурации MCP-серверов
- Добавьте Bitly MCP Server:
- URL сервера:
https://api-ssl.bitly.com/v4/mcp- Аутентификация: OAuth
- URL сервера:
При появлении запроса войдите в свою учётную запись Bitly и авторизуйте подключение. Claude автоматически обработает поток OAuth с помощью динамической регистрации клиента.
Примечание: поддержка OAuth в Claude Web требует включения администратором рабочего пространства для тарифов Team и Enterprise.
ChatGPT
Для ChatGPT используйте аутентификацию OAuth:
- В ChatGPT перейдите в Settings > Apps & Connectors > Advanced Settings
- Включите Developer Mode
- Вернитесь назад и нажмите Create
- Добавьте Bitly MCP Server:
- URL сервера:
https://api-ssl.bitly.com/v4/mcp- Аутентификация: OAuth
- URL сервера:
При появлении запроса войдите в свою учётную запись Bitly и авторизуйте подключение. ChatGPT автоматически обработает поток OAuth с помощью динамической регистрации клиента.
Примечание: поддержка MCP в ChatGPT требует тарифов Plus, Team, Enterprise или Edu. Для рабочих пространств доступ к этим настройкам возможен только администратором.
Аутентификация
Bitly MCP Server поддерживает два метода аутентификации:
OAuth 2.1 с динамической регистрацией клиента (рекомендуется)
Для клиентов, поддерживающих OAuth (например, Claude Web, ChatGPT и другие современные ИИ-ассистенты), OAuth обеспечивает:
- Повышенную безопасность — нет необходимости вручную управлять API-токенами
- Автоматическую регистрацию клиента — динамическая регистрация клиента (DCR) автоматически настраивает клиент
- Обновление токенов — автоматическое продление токенов без ручного вмешательства
При настройке OAuth ваш ИИ-клиент:
- Перенаправит вас на страницу авторизации Bitly
- Попросит войти и авторизовать подключение
- Автоматически зарегистрируется как OAuth-клиент через DCR
- Прозрачно получит и будет управлять токенами доступа
API-токен (альтернатива)
Для более простых настроек или клиентов без поддержки OAuth:
- Войдите в свою учётную запись Bitly на bitly.com
- Перейдите в Settings → API
- Нажмите Generate Access Token
- Скопируйте токен и храните его в безопасном месте
- Используйте его в конфигурации вашего MCP-клиента, как показано в примерах выше
Проверьте работу
После настройки попробуйте спросить вашего ИИ:
"What Bitly tools are available?"
или
"Please shorten this URL: https://example.com/very-long-url"
После этого всё должно быть готово!