Servidor Linkly MCP

O Servidor Linkly MCP permite conectar assistentes de IA à sua conta Linkly usando o Model Context Protocol. Depois de conectado, você pode criar e gerenciar links curtos através de conversação natural.

O que é MCP?

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

Assistentes de IA suportados

O Servidor Linkly MCP funciona com:

Onde encontrá-lo

O Servidor Linkly MCP está listado nos principais diretórios MCP, para que você possa instalá-lo de onde já procura por conectores:

Servidor MCP ou Linkly CLI?

Se seu assistente de IA é um agente de codificação que pode executar comandos shell — como Claude Code ou Cursor — o Linkly CLI geralmente é uma melhor opção do que o servidor MCP. Agentes de codificação já estão familiarizados com ferramentas de linha de comando, e o CLI oferece saída --json em cada comando além de um comando linkly schema que imprime a árvore completa de comandos, para que o agente possa descobrir tudo o que pode fazer. O servidor MCP continua sendo a melhor opção para assistentes que não podem executar comandos shell, como Claude Desktop e ChatGPT Desktop.

O que você pode fazer

Depois de 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"
  • Visualizar análises - "Mostre-me cliques por país nos ú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 fica 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 é aberta pedindo para você entrar no Linkly e aprovar o acesso. Depois disso, seu assistente fica conectado.

https://mcp.linklyhq.com

Configuração

Claude desktop

No Claude Desktop, vá para Configurações → Conectores → Adicionar conector personalizado. Digite um nome (Linkly) e a URL do servidor MCP remoto:

https://mcp.linklyhq.com

Clique em Adicionar, depois em Conectar no conector Linkly. Uma aba do navegador é aberta para você entrar e aprovar o acesso. O Claude Desktop fica então conectado — sem arquivo de config ou ferramentas extras necessárias.

Claude code (CLI)

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 MCP Linkly:

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

Ferramentas disponíveis

FerramentaDescrição
create_linkCriar um novo link curto com parâmetros UTM opcionais, pixels e muito mais
update_linkAtualizar as configurações de um link existente
delete_linkDeletar um link
get_linkObter detalhes de um link específico
list_linksListar todos os links em seu workspace
search_linksPesquisar links por nome, URL ou nota
get_clicksObter dados de clique recentes
get_analyticsObter dados de cliques em série temporal para gráficos
get_analytics_byObter cliques agrupados por país, navegador, plataforma, etc.
list_domainsListar seus domínios personalizados
list_webhooksListar inscrições de webhook do workspace
subscribe_webhookInscrever uma URL para receber eventos de clique

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
  • Seus próprios dados: metadata, pares chave-valor como IDs do seu sistema. É retornado com o link e incluído nas cargas úteis dos webhooks. Veja link metadata

Solução de problemas

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

  • Confirme que https://mcp.linklyhq.com está acessível de sua máquina
  • No Claude Code, execute /mcp e escolha linkly para disparar novamente o fluxo OAuth

"Falha na autenticação", "invalid_client" ou o navegador continua pedindo para entrar

Isso significa que seu cliente está mantendo um registro de conexão obsoleto. Limpe as credenciais em cache e autorize novamente. No Claude Code, execute /mcp → linkly → reconectar. No Claude Desktop, remova o conector Linkly em Configurações → Conectores e adicione-o novamente, depois entre novamente.

Ferramentas não aparecem

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

Recursos relacionados

Perguntas frequentes sobre servidor MCP

Preciso instalar algo para usar o servidor MCP?

Não. O servidor hospedado em https://mcp.linklyhq.com usa OAuth — você entra uma vez no navegador e seu assistente de IA fica conectado. Não há software para instalar em sua máquina além do próprio assistente de IA.

Preciso de uma chave de API?

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

Quais assistentes de IA suportam MCP?

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

Minha conta está segura?

Sim. O servidor hospedado usa OAuth 2.1 com PKCE — sua senha Linkly é inserida apenas em app.linklyhq.com, e seu assistente de IA vê apenas um token de acesso limitado ao seu workspace. O modelo de IA em si nunca vê suas credenciais.

O servidor MCP respeita minha função no espaço de trabalho?

Sim. Seu assistente de IA pode fazer tudo o que sua função permite e nada mais. Se você tiver a função Leitura, pode consultar links e análises, mas não pode criar, editar ou deletar nada.

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

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

Como faço para atualizar o servidor MCP?

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

Disponibilidade do plano

Disponível a partir do Pro

Comparar planos →

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