Bitly MCP Server

oficial

Convierte tu asistente de IA en un centro de marketing digital que crea, organiza y analiza enlaces y códigos QR bajo demanda.

¿Qué puedes hacer con Bitly MCP?

  • Acortar URLs — Pídele a tu IA que acorte una URL larga, p. ej., "Por favor, acorta esta URL: https://example.com/very-long-url"
  • Descubrir herramientas disponibles — Pregúntale a tu IA "¿Qué herramientas de Bitly están disponibles?" para listar las capacidades del servidor MCP
  • Gestionar enlaces de Bitly — Usa el servidor MCP para crear, obtener y gestionar enlaces cortos a través de la API de Bitly

Documentación

El Servidor MCP de Bitly

Bienvenido a la guía del Servidor MCP de Bitly.

Si estás aquí, probablemente ya sabes qué es un Servidor MCP, pero si necesitas una introducción, consulta nuestra página ¿Qué es MCP?.

El Servidor MCP de Bitly proporciona acceso a toda la funcionalidad que esperarías de una interfaz de Bitly — como la API de Bitly, como el sitio web bitly.com, como la Extensión de Chrome de Bitly, como la aplicación móvil de Bitly — pero esta vez para el agente de IA de tu elección.

¿Quieres usar Bitly con ChatGPT? Servidor MCP de Bitly o Bitly Custom GPT. ¿Quieres usar Bitly con Claude? Servidor MCP de Bitly. ¿Quieres usar Bitly con Cursor, VSCode o Windsurf? Servidor MCP de Bitly.

Configuración Rápida

El Servidor MCP de Bitly está alojado en https://api-ssl.bitly.com/v4/mcp.

Opciones de Autenticación:

  • OAuth 2.1 (Recomendado) - Para clientes que soportan OAuth, esto proporciona autenticación segura basada en tokens con registro automático de clientes
  • Token de API - Para configuraciones más simples o clientes sin soporte de OAuth, usa tu token de API de Bitly desde https://bitly.com/settings/api

A continuación se muestra la cuadrícula de configuraciones con enlaces a instrucciones detalladas — si falta alguna que uses, encontrarás orientación en la página de Detalles de Configuración. Agregaremos guías de configuración adicionales con el tiempo.

Agente de IAInstrucciones de ConfiguraciónNotas
ChatGPTConfigurar ChatGPTOAuth con Registro Dinámico de Clientes
Interfaz Web de Claude (claude.ai)Configurar Claude WebOAuth con Registro Dinámico de Clientes
Claude DesktopConfigurar Claude DesktopSoporta tanto OAuth como token de API
Claude CodeConfigurar Claude CodeTransporte HTTP – soporta tanto OAuth como token de API
CursorConfigurar CursorTransporte HTTP – soporta tanto OAuth como token de API
VS CodeConfigurar VS CodeTransporte HTTP – soporta tanto OAuth como token de API
WindsurfConfigurar WindsurfUsa el proxy npx para conexión local
La mayoría de otros agentes compatibles con HTTPConsulta nuestra sección de ConfiguraciónLa configuración HTTP genérica funciona para la mayoría

Configuraciones

Claude Code

Agrega a ~/.claude/mcp.json:

Para OAuth (recomendado):

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

Para Token de API:

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

Reinicia Claude Code después de agregar la configuración.

Cursor

Agrega a ~/.cursor/mcp.json:

Para OAuth (recomendado):

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

Para Token de API:

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

Reinicia Cursor después de agregar la configuración.

Claude Desktop

Agrega a tu archivo de configuración de Claude:

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

Para OAuth (recomendado):

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

Para Token de API (usando proxy npx):

Requisito previo: Requiere Node.js 20 LTS o superior con soporte de 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"
      }
    }
  }
}

Reinicia Claude Desktop después de agregar la configuración.

VS Code

Agrega a ~/.vscode/mcp.json en tu espacio de trabajo:

Para OAuth (recomendado):

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

Para Token de API:

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

Windsurf

Agrega a ~/.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

Para Claude en la web (claude.ai), usa autenticación OAuth:

  1. Navega a la configuración de tu espacio de trabajo de Claude
  2. Ve a la sección de configuración de servidores MCP
  3. Agrega el Servidor MCP de Bitly:
    • URL del Servidor: https://api-ssl.bitly.com/v4/mcp
      • Autenticación: OAuth

Cuando se te solicite, inicia sesión en tu cuenta de Bitly y autoriza la conexión. Claude manejará el flujo de OAuth automáticamente usando el Registro Dinámico de Clientes.

Nota: El soporte de OAuth en Claude Web requiere la habilitación del Administrador del Espacio de Trabajo para los Planes de Equipo y Empresa.

ChatGPT

Para ChatGPT, usa autenticación OAuth:

  1. En ChatGPT, ve a Configuración > Aplicaciones y Conectores > Configuración Avanzada
  2. Activa el Modo Desarrollador
  3. Regresa y haz clic en Crear
  4. Agrega el Servidor MCP de Bitly:
    • URL del Servidor: https://api-ssl.bitly.com/v4/mcp
      • Autenticación: OAuth

Cuando se te solicite, inicia sesión en tu cuenta de Bitly y autoriza la conexión. ChatGPT manejará el flujo de OAuth automáticamente usando el Registro Dinámico de Clientes.

Nota: El soporte de MCP en ChatGPT requiere planes Plus, Team, Enterprise o Edu. Para planes de espacio de trabajo, debes ser administrador para acceder a esta configuración.

Autenticación

El Servidor MCP de Bitly soporta dos métodos de autenticación:

OAuth 2.1 con Registro Dinámico de Clientes (Recomendado)

Para clientes que soportan OAuth (como Claude Web, ChatGPT y otros asistentes de IA modernos), OAuth proporciona:

  • Seguridad Mejorada - No es necesario gestionar tokens de API manualmente
  • Registro Automático de Clientes - El Registro Dinámico de Clientes (DCR) maneja la configuración del cliente automáticamente
  • Renovación de Tokens - Renovación automática de tokens sin intervención manual

Al configurar OAuth, tu cliente de IA:

  1. Te redirigirá a la página de autorización de Bitly
  2. Te pedirá iniciar sesión y autorizar la conexión
  3. Se registrará automáticamente como cliente OAuth usando DCR
  4. Recibirá y gestionará los tokens de acceso de manera transparente

Token de API (Alternativa)

Para configuraciones más simples o clientes sin soporte de OAuth:

  1. Inicia sesión en tu cuenta de Bitly en bitly.com
  2. Navega a Configuración → API
  3. Haz clic en Generar Token de Acceso
  4. Copia el token y guárdalo de forma segura
  5. Úsalo en la configuración de tu cliente MCP como se muestra en los ejemplos anteriores

Pruébalo

Una vez configurado, intenta preguntarle a tu IA:

"What Bitly tools are available?"

o

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

¡A partir de ahí deberías estar listo!