Bitly MCP Server

oficial

Transforme seu assistente de IA em um hub de marketing digital que cria, organiza e analisa links e QR Codes sob demanda.

O que você pode fazer com Bitly MCP?

  • Encurtar URLs — Peça à sua IA para encurtar uma URL longa, por exemplo: "Por favor, encurte esta URL: https://example.com/very-long-url"
  • Descobrir ferramentas disponíveis — Pergunte à sua IA "Quais ferramentas do Bitly estão disponíveis?" para listar as capacidades do servidor MCP
  • Gerenciar links do Bitly — Use o servidor MCP para criar, recuperar e gerenciar links curtos por meio da API do Bitly

Documentação

O Bitly MCP Server

Bem-vindo ao guia do Bitly MCP Server.

Se você está aqui, provavelmente já sabe o que é um MCP Server, mas se precisar de uma introdução, confira nossa página O que é MCP?.

O Bitly MCP Server fornece acesso a toda a funcionalidade que você esperaria de uma interface Bitly -- como a API Bitly, como o site bitly.com, como a Extensão do Chrome do Bitly, como o aplicativo móvel do Bitly -- mas desta vez para o seu agente de IA de escolha.

Quer usar o Bitly com ChatGPT? Bitly MCP Server ou Bitly Custom GPT. Quer usar o Bitly com Claude? Bitly MCP Server. Quer usar o Bitly com Cursor, VSCode ou Windsurf? Bitly MCP Server.

Configuração Rápida

O Bitly MCP Server está hospedado em https://api-ssl.bitly.com/v4/mcp.

Opções de Autenticação:

  • OAuth 2.1 (Recomendado) - Para clientes que suportam OAuth, isso fornece autenticação segura baseada em token com registro automático de cliente
  • Token de API - Para configurações mais simples ou clientes sem suporte a OAuth, use seu token de API do Bitly de https://bitly.com/settings/api

Abaixo está a grade de configurações com links para instruções detalhadas -- se faltar alguma que você use, você encontrará orientação na página Detalhes de Configuração. Adicionaremos guias de configuração adicionais ao longo do tempo.

Agente de IAInstruções de ConfiguraçãoNotas
ChatGPTConfigurar ChatGPTOAuth com Registro Dinâmico de Cliente
Claude Web Interface (claude.ai)Configurar Claude WebOAuth com Registro Dinâmico de Cliente
Claude DesktopConfigurar Claude DesktopSuporta tanto OAuth quanto token de API
Claude CodeConfigurar Claude CodeTransporte HTTP – suporta tanto OAuth quanto token de API
CursorConfigurar CursorTransporte HTTP – suporta tanto OAuth quanto token de API
VS CodeConfigurar VS CodeTransporte HTTP – suporta tanto OAuth quanto token de API
WindsurfConfigurar WindsurfUsa proxy npx para conexão local
A maioria dos outros agentes compatíveis com HTTPConsulte nossa seção de ConfiguraçãoA configuração HTTP genérica funciona para a maioria

Configurações

Claude Code

Adicione em ~/.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"
      }
    }
  }
}

Reinicie o Claude Code após adicionar a configuração.

Cursor

Adicione em ~/.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"
      }
    }
  }
}

Reinicie o Cursor após adicionar a configuração.

Claude Desktop

Adicione ao seu arquivo de configuração do 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):

Pré-requisito: Requer Node.js 20 LTS ou superior com suporte a 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"
      }
    }
  }
}

Reinicie o Claude Desktop após adicionar a configuração.

VS Code

Adicione em ~/.vscode/mcp.json no seu workspace:

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

Adicione em ~/.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 na web (claude.ai), use autenticação OAuth:

  1. Navegue até as configurações do seu workspace Claude
  2. Vá para a seção de configuração de servidores MCP
  3. Adicione o Bitly MCP Server:
    • URL do Servidor: https://api-ssl.bitly.com/v4/mcp
      • Autenticação: OAuth

Quando solicitado, faça login na sua conta Bitly e autorize a conexão. O Claude lidará com o fluxo OAuth automaticamente usando o Registro Dinâmico de Cliente.

Nota: O suporte a OAuth no Claude Web requer habilitação de Administrador do Workspace para Planos Team e Enterprise.

ChatGPT

Para ChatGPT, use autenticação OAuth:

  1. No ChatGPT, vá para Configurações > Aplicativos e Conectores > Configurações Avançadas
  2. Ative o Modo de Desenvolvedor
  3. Volte e clique em Criar
  4. Adicione o Bitly MCP Server:
    • URL do Servidor: https://api-ssl.bitly.com/v4/mcp
      • Autenticação: OAuth

Quando solicitado, faça login na sua conta Bitly e autorize a conexão. O ChatGPT lidará com o fluxo OAuth automaticamente usando o Registro Dinâmico de Cliente.

Nota: O suporte a MCP no ChatGPT requer planos Plus, Team, Enterprise ou Edu. Para planos de workspace, você deve ser administrador para acessar essas configurações.

Autenticação

O Bitly MCP Server suporta dois métodos de autenticação:

OAuth 2.1 com Registro Dinâmico de Cliente (Recomendado)

Para clientes que suportam OAuth (como Claude Web, ChatGPT e outros assistentes de IA modernos), o OAuth fornece:

  • Segurança Aprimorada - Sem necessidade de gerenciar tokens de API manualmente
  • Registro Automático de Cliente - O Registro Dinâmico de Cliente (DCR) lida com a configuração do cliente automaticamente
  • Atualização de Token - Renovação automática de token sem intervenção manual

Ao configurar OAuth, seu cliente de IA irá:

  1. Redirecionar você para a página de autorização do Bitly
  2. Pedir que você faça login e autorize a conexão
  3. Registrar-se automaticamente como cliente OAuth usando DCR
  4. Receber e gerenciar tokens de acesso de forma transparente

Token de API (Alternativa)

Para configurações mais simples ou clientes sem suporte a OAuth:

  1. Faça login na sua conta Bitly em bitly.com
  2. Navegue até Configurações → API
  3. Clique em Gerar Token de Acesso
  4. Copie o token e armazene-o com segurança
  5. Use-o na configuração do seu cliente MCP conforme mostrado nos exemplos acima

Teste

Depois de configurado, tente perguntar ao seu IA:

"What Bitly tools are available?"

ou

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

A partir daí, você deve estar pronto!