Bitly MCP Server
oficialTransforme 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 IA | Instruções de Configuração | Notas |
|---|---|---|
| ChatGPT | Configurar ChatGPT | OAuth com Registro Dinâmico de Cliente |
| Claude Web Interface (claude.ai) | Configurar Claude Web | OAuth com Registro Dinâmico de Cliente |
| Claude Desktop | Configurar Claude Desktop | Suporta tanto OAuth quanto token de API |
| Claude Code | Configurar Claude Code | Transporte HTTP – suporta tanto OAuth quanto token de API |
| Cursor | Configurar Cursor | Transporte HTTP – suporta tanto OAuth quanto token de API |
| VS Code | Configurar VS Code | Transporte HTTP – suporta tanto OAuth quanto token de API |
| Windsurf | Configurar Windsurf | Usa proxy npx para conexão local |
| A maioria dos outros agentes compatíveis com HTTP | Consulte nossa seção de Configuração | A 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:
- Navegue até as configurações do seu workspace Claude
- Vá para a seção de configuração de servidores MCP
- Adicione o Bitly MCP Server:
- URL do Servidor:
https://api-ssl.bitly.com/v4/mcp- Autenticação: OAuth
- URL do Servidor:
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:
- No ChatGPT, vá para Configurações > Aplicativos e Conectores > Configurações Avançadas
- Ative o Modo de Desenvolvedor
- Volte e clique em Criar
- Adicione o Bitly MCP Server:
- URL do Servidor:
https://api-ssl.bitly.com/v4/mcp- Autenticação: OAuth
- URL do Servidor:
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á:
- Redirecionar você para a página de autorização do Bitly
- Pedir que você faça login e autorize a conexão
- Registrar-se automaticamente como cliente OAuth usando DCR
- Receber e gerenciar tokens de acesso de forma transparente
Token de API (Alternativa)
Para configurações mais simples ou clientes sem suporte a OAuth:
- Faça login na sua conta Bitly em bitly.com
- Navegue até Configurações → API
- Clique em Gerar Token de Acesso
- Copie o token e armazene-o com segurança
- 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!