Servidor MCP do Linkly

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

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto que permite assistentes de IA se conectarem 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 executar ações diretamente.

Assistentes de IA suportados

O Servidor MCP do Linkly funciona com:

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

Onde encontrá-lo

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

• Diretório de conectores Claude — conectar com um clique no Claude (web e Desktop)
• Registro MCP oficial — com.linklyhq/linkly
• Smithery
• Glama
• mcp.so
• ClaudePluginHub — o plugin Linkly para Claude Code e Cowork
• Código-fonte no GitHub — licença MIT

Servidor MCP ou CLI do Linkly?

Se seu assistente de IA for um agente de codificação que pode executar comandos shell — como Claude Code ou Cursor — a CLI do Linkly geralmente é mais adequada do que o servidor MCP. Os agentes de codificação já estão acostumados a usar ferramentas de linha de comando, e a CLI fornece saída --json em todos os comandos mais um comando linkly schema que imprime a árvore completa de comandos, para que o agente possa descobrir tudo que pode fazer. O servidor MCP permanece a melhor escolha para assistentes que não conseguem executar comandos shell, como Claude Desktop e ChatGPT Desktop.

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 o 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 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"

Primeiros passos

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

https://mcp.linklyhq.com

Configuração

Claude Desktop

No Claude Desktop, vá para Settings → Connectors → Add custom connector. Digite um nome (Linkly) e a URL do servidor MCP remoto:

https://mcp.linklyhq.com

Clique em Add, depois em Connect no conector Linkly. Uma aba do navegador abre para você fazer login e aprovar o acesso. O Claude Desktop então permanece conectado — nenhum arquivo de configuração ou ferramentas extras necessárias.

Claude Code (CLI)

Claude Code suporta servidores MCP remotos nativamente. Adicione o 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 do Linkly:

{
  "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

"Could not connect to MCP server"

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

"Authentication failed", "invalid_client" ou o navegador continua pedindo para fazer login

Isso significa que seu cliente está mantendo um registro de conexão obsoleto. Limpe as credenciais em cache e reautorize. No Claude Code, execute /mcp → linkly → reconectar. No Claude Desktop, remova o conector Linkly em Settings → Connectors e adicione-o novamente, depois faça login novamente.

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 pelo ícone de ferramentas em seu assistente)

Recursos relacionados

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