Servidor MCP do Linkly

O Servidor MCP do Linkly permite conectar 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 de forma segura a ferramentas externas e fontes de dados. Em vez de copiar e colar entre aplicativos, você pode pedir ao seu assistente de IA para executar ações diretamente.

Assistentes de IA Suportados

O Servidor MCP do Linkly funciona com:

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"
  • Acompanhar desempenho - "Quantos cliques meus links receberam esta semana?"
  • Gerenciar links - "Atualize o link chamado 'promo' com um novo destino"
  • Ver análises - "Mostre-me os 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 cliques"

Primeiros Passos

O Servidor MCP do Linkly hospedado está disponível em https://mcp.linklyhq.com. Não há nada para instalar nem chave de API para copiar — o servidor usa OAuth, portanto, na primeira vez que seu assistente de IA se conectar, uma janela do navegador será aberta 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 o 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 MCP do Linkly:

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

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

Claude Code (CLI)

O Claude Code tem suporte nativo a servidores MCP remotos. Adicione o Linkly com um único comando:

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

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

ChatGPT Desktop

Abra o arquivo de configuração do ChatGPT:

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

Adicione o servidor MCP do Linkly:

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

Ferramentas Disponíveis

FerramentaDescrição
create_linkCrie um novo link curto com parâmetros UTM opcionais, pixels e mais
update_linkAtualize as configurações de um link existente
delete_linkExclua um link
get_linkObtenha detalhes de um link específico
list_linksListe todos os links em seu espaço de trabalho
search_linksPesquise links por nome, URL ou nota
get_clicksObtenha dados de cliques recentes
get_analyticsObtenha dados de cliques em série temporal para gráficos
get_analytics_byObtenha cliques agrupados por país, navegador, plataforma, etc.
list_domainsListe seus domínios personalizados
list_webhooksListe assinaturas de webhook do espaço de trabalho
subscribe_webhookInscreva uma URL para receber eventos de cliques

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 está acessível a partir da sua máquina
  • Se seu cliente usa mcp-remote, certifique-se de que o Node.js v18 ou posterior está instalado
  • No Claude Code, execute /mcp e escolha linkly para acionar novamente o fluxo OAuth

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

Limpe as credenciais MCP em cache do seu cliente e autorize novamente. No Claude Code, execute /mcplinkly → reconectar. No Claude Desktop, encerre o aplicativo, exclua o token em cache do mcp-remote em ~/.mcp-auth/ e reinicie.

Ferramentas não aparecem

  • Reinicie seu assistente de IA após 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 o ícone de ferramentas em seu assistente)

Recursos Relacionados

Perguntas Frequentes sobre o Servidor MCP

Preciso instalar algo para usar o servidor MCP?

Não. O servidor hospedado em https://mcp.linklyhq.com usa OAuth, então basta fazer login uma vez no navegador e seu assistente de IA permanece conectado. Além do próprio assistente de IA, não há nada para instalar na sua máquina.

Preciso de uma chave de API?

Não. O servidor MCP usa OAuth — você faz login no Linkly pelo navegador na primeira vez que seu assistente de IA se conecta, e não há nenhuma chave de API para copiar ou colar em lugar algum.

Quais assistentes de IA suportam MCP?

Claude Desktop, Claude Code (CLI) e ChatGPT Desktop suportam MCP. Outras ferramentas como Cursor e Windsurf também têm suporte a MCP.

Minha conta é segura?

Sim. O servidor hospedado usa OAuth 2.1 com PKCE — sua senha do Linkly é inserida apenas em app.linklyhq.com, e seu assistente de IA vê somente um token de acesso com escopo limitado ao seu espaço de trabalho. O próprio modelo de IA nunca vê suas credenciais.

Posso usar MCP com as versões web do Claude ou ChatGPT?

Não, o MCP requer os aplicativos desktop ou o CLI do Claude Code. As versões web não suportam conexões MCP.

Como atualizo o servidor MCP?

Não há nada para atualizar — implantamos melhorias continuamente no servidor hospedado e todo cliente conectado as recebe automaticamente.

Rastreie 500 cliques mensais com todos os recursos incluídos.

Cartão de crédito não necessário