Bitly MCP Server

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 tu agente de IA de preferencia.

¿Quieres usar Bitly con ChatGPT? Servidor MCP de Bitly o GPT Personalizado de Bitly. ¿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 cliente
• Token de API - Para configuraciones más simples o clientes sin soporte OAuth, usa tu token de API de Bitly desde https://bitly.com/settings/api

A continuación se muestra la tabla 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 IA	Instrucciones de Configuración	Notas
ChatGPT	Configurar ChatGPT	OAuth con Registro Dinámico de Cliente
Interfaz Web de Claude (claude.ai)	Configurar Claude Web	OAuth con Registro Dinámico de Cliente
Claude Desktop	Configurar Claude Desktop	Soporta tanto OAuth como token de API
Claude Code	Configurar Claude Code	Transporte HTTP – soporta tanto OAuth como token de API
Cursor	Configurar Cursor	Transporte HTTP – soporta tanto OAuth como token de API
VS Code	Configurar VS Code	Transporte HTTP – soporta tanto OAuth como token de API
Windsurf	Configurar Windsurf	Usa proxy npx para conexión local
La mayoría de agentes compatibles con HTTP	Consulta nuestra sección de Configuración	La 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:

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.jsonWindows: %APPDATA%\Claude\claude_desktop_config.json

{
  "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 para 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:

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

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

### Claude Web

For Claude on the web (claude.ai), use OAuth authentication:

1. Navigate to your Claude workspace settings
2. Go to the MCP servers configuration section
3. Add the Bitly MCP Server:  
   * **Server URL:** `https://api-ssl.bitly.com/v4/mcp`  
   * **Authentication:** OAuth

When prompted, log in to your Bitly account and authorize the connection. Claude will handle the OAuth flow automatically using Dynamic Client Registration.

> **Note:** OAuth support in Claude Web requires Workspace Admin enablement for Team and Enterprise Plans.

### ChatGPT

For ChatGPT, use OAuth authentication:

1. In ChatGPT, go to **Settings > Apps & Connectors > Advanced Settings**
2. Toggle **Developer Mode** on
3. Go back and click **Create**
4. Add the Bitly MCP Server:  
   * **Server URL:** `https://api-ssl.bitly.com/v4/mcp`  
   * **Authentication:** OAuth

When prompted, log in to your Bitly account and authorize the connection. ChatGPT will handle the OAuth flow automatically using Dynamic Client Registration.

> **Note:** MCP support in ChatGPT requires Plus, Team, Enterprise, or Edu plans. For workspace plans, you must be an admin to access these settings.

## Authentication

The Bitly MCP Server supports two authentication methods:

### OAuth 2.1 with Dynamic Client Registration (Recommended)

For clients that support OAuth (like Claude Web, ChatGPT, and other modern AI assistants), OAuth provides:

* **Enhanced Security** \- No need to manually manage API tokens
* **Automatic Client Registration** \- Dynamic Client Registration (DCR) handles client setup automatically
* **Token Refresh** \- Automatic token renewal without manual intervention

When configuring OAuth, your AI client will:

1. Redirect you to Bitly's authorization page
2. Ask you to log in and authorize the connection
3. Automatically register as an OAuth client using DCR
4. Receive and manage access tokens transparently

### API Token (Alternative)

For simpler setups or clients without OAuth support:

1. Log in to your Bitly account at bitly.com
2. Navigate to Settings → API
3. Click Generate Access Token
4. Copy the token and store it securely
5. Use it in your MCP client configuration as shown in the examples above

## Test It Out

Once configured, try asking your AI:

"¿Qué herramientas de Bitly están disponibles?"

"Por favor acorta esta URL: https://example.com/very-long-url"

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

---