Servidor Linkly MCP

O Servidor Linkly MCP permite que você conecte assistentes de IA à sua conta Linkly usando o Model Context Protocol. Uma vez conectado, você pode criar e gerenciar links curtos através de conversas naturais.

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA se conectem com segurança a ferramentas externas e fontes de dados. Em vez de copiar e colar entre apps, você pode pedir ao seu assistente de IA para executar ações diretamente.

Assistentes de IA Suportados

O Servidor Linkly MCP funciona com:

• Claude Desktop
• ChatGPT Desktop
• Outros clientes compatíveis com MCP (Cursor, Windsurf, etc.)

O Que Você Pode Fazer

Uma vez conectado, você pode pedir ao seu assistente de IA para:

• Criar links curtos - "Crie um link curto para https://example.com"
• Rastrear desempenho - "Quantos cliques meus links receberam esta semana?"
• Gerenciar links - "Atualize o link chamado 'promo' com um novo destino"
• Ver análises - "Mostre-me cliques por país dos últimos 30 dias"
• Pesquisar links - "Encontre todos os links relacionados ao lançamento do produto"
• Gerenciar domínios - "Liste meus domínios personalizados"
• Configurar webhooks - "Inscreva https://my-site.com/webhook para receber eventos de clique"

Começando

O Servidor Linkly MCP hospedado está em https://mcp.linklyhq.com. Não há nada para instalar e nenhuma chave de API para copiar — o servidor usa OAuth, então na primeira vez que seu assistente de IA se conecta, uma janela do navegador se abre pedindo que você faça login no Linkly e aprove o acesso. Depois disso, seu assistente permanece conectado.

https://mcp.linklyhq.com

Configuração

Claude Desktop

Abra seu arquivo de configuração do Claude Desktop:

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

Adicione o servidor Linkly MCP:

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linklyhq.com"]
    }
  }
}

Reinicie o Claude Desktop. Na primeira vez que você usar uma ferramenta Linkly, uma aba do navegador se abre para você fazer login e aprovar o acesso.

Claude Code (CLI)

O Claude Code suporta servidores MCP remotos nativamente. Adicione Linkly com um comando:

claude mcp add --transport http linkly https://mcp.linklyhq.com

Depois execute /mcp dentro do Claude Code, escolha linkly e autorize no navegador quando solicitado.

ChatGPT Desktop

Abra seu arquivo de configuração do ChatGPT:

• macOS: ~/Library/Application Support/ChatGPT/mcp_servers.json
• Windows: %APPDATA%\ChatGPT\mcp_servers.json

Adicione o servidor Linkly MCP:

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com"
    }
  }
}

Ferramentas Disponíveis

Opções de Criação de Link

Ao criar links, você pode especificar:

• Básico: url, name, note, domain, slug, enabled
• Parâmetros UTM: utm_source, utm_medium, utm_campaign, utm_term, utm_content
• Open Graph: og_title, og_description, og_image
• Rastreamento: fb_pixel_id, ga4_tag_id, gtm_id
• Avançado: cloaking, forward_params, block_bots, hide_referrer
• Expiração: expiry_datetime, expiry_destination

Solução de Problemas

"Não foi possível conectar ao servidor MCP"

• Confirme que https://mcp.linklyhq.com é acessível a partir da sua máquina
• Se seu cliente usar mcp-remote, certifique-se de que o Node.js v18 ou posterior está instalado
• No Claude Code, execute /mcp e escolha linkly para reativar o fluxo OAuth

"Falha na autenticação" / navegador continua pedindo para fazer login

Limpe as credenciais MCP em cache do seu cliente e reautorize. No Claude Code, execute /mcp → linkly → reconecte. No Claude Desktop, saia do app, delete o token em cache de mcp-remote em ~/.mcp-auth/, depois reinicie.

Ferramentas não aparecem

• Reinicie seu assistente de IA depois de salvar a configuração
• Verifique se a sintaxe JSON em seu arquivo de configuração é válida
• Verifique se o servidor MCP está em execução (procure pelo ícone de ferramentas em seu assistente)

Recursos Relacionados

• Integração Claude Desktop
• Integração ChatGPT
• Documentação da API Linkly
• Webhooks
• Model Context Protocol