Servidor MCP Linkly

O Servidor MCP Linkly 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 conversação natural.

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 aplicativos, você pode pedir ao seu assistente de IA para executar ações diretamente.

Assistentes de IA Suportados

O Servidor MCP 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 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://meu-site.com/webhook para receber eventos de cliques"

Opções de Instalação

O Servidor MCP Linkly está disponível de duas formas:

Opção 1: Servidor Hospedado (Recomendado)

Use nosso servidor MCP hospedado - nenhuma instalação necessária:

https://mcp.linklyhq.com

Opção 2: Pacote npm

Instale e execute localmente usando npx:

npx -y linkly-mcp-server

Ou instale globalmente:

npm install -g linkly-mcp-server

Veja o pacote no npm.

Configuração

Obtendo Suas Credenciais de API

  1. 1Faça login no seu painel Linkly
  2. 2Vá para Configurações → Chaves de API
  3. 3Copie sua Chave de API e ID do Workspace

Configuração do 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 MCP Linkly:

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "sua-chave-de-api",
        "LINKLY_WORKSPACE_ID": "seu-id-de-workspace"
      }
    }
  }
}

Configuração do 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:

Usando npx:

{
  "servers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "sua-chave-de-api"
      }
    }
  }
}

Usando servidor hospedado:

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com",
      "env": {
        "LINKLY_API_KEY": "sua-chave-de-api"
      }
    }
  }
}

Ferramentas Disponíveis

FerramentaDescrição
create_linkCriar um novo link curto com parâmetros UTM opcionais, pixels e mais
update_linkAtualizar as configurações de um link existente
delete_linkExcluir 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 cliques 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 assinaturas de webhook do workspace
subscribe_webhookInscrever uma URL para receber eventos de cliques

Opções de Criação de Links

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

Variáveis de Ambiente

VariávelObrigatóriaDescrição
LINKLY_API_KEYSimSua chave de API Linkly
LINKLY_WORKSPACE_IDNãoSeu ID de workspace (alguns clientes exigem isso)

Solução de Problemas

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

  • Verifique se sua chave de API e ID de Workspace estão corretos
  • Certifique-se de ter o Node.js instalado (v18 ou posterior)
  • Tente executar npx linkly-mcp-server em um terminal para ver quaisquer erros

"Falha na autenticação"

  • Verifique sua chave de API no painel Linkly em Configurações → Chaves de API
  • Certifique-se de que não há espaços extras em suas credenciais
  • Tente regenerar sua chave de API

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)

Servidor não acessível

  • Confirme se o caminho do comando está correto
  • Se estiver usando o servidor hospedado, verifique sua conexão com a internet
  • Verifique se o servidor MCP executa manualmente a partir do terminal

Recursos Relacionados

Perguntas Frequentes sobre Servidor MCP

Preciso instalar algo para usar o servidor MCP?

Não, se você usar o servidor hospedado em https://mcp.linklyhq.com. Se preferir executar localmente, você precisará do Node.js v18 ou posterior instalado.

Quais assistentes de IA suportam MCP?

Claude Desktop e ChatGPT Desktop suportam MCP. Outras ferramentas como Cursor e Windsurf também têm suporte para MCP.

Minha chave de API é segura?

Sim. Sua chave de API é armazenada localmente no arquivo de configuração do seu assistente de IA e é enviada apenas aos servidores da Linkly ao fazer solicitações de API. Ela nunca é compartilhada com o próprio modelo de IA.

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

Não, o MCP requer os aplicativos desktop. As versões web não suportam conexões MCP.

Como atualizo o servidor MCP?

Se estiver usando npx, ele busca automaticamente a versão mais recente a cada execução. Se instalado globalmente, execute npm update -g linkly-mcp-server.

Track 1000 monthly clicks with all features included.

No credit card required