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:
- Claude Desktop
- ChatGPT Desktop
- Outros clientes compatíveis com MCP (Cursor, Windsurf, etc.)
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:
- Diretório de conectores Claude — conectar em 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 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/webhookpara 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
| Ferramenta | Descrição |
|---|---|
create_link | Criar um novo link curto com parâmetros UTM opcionais, pixels e muito mais |
update_link | Atualizar as configurações de um link existente |
delete_link | Deletar um link |
get_link | Obter detalhes de um link específico |
list_links | Listar todos os links em seu workspace |
search_links | Pesquisar links por nome, URL ou nota |
get_clicks | Obter dados de clique recentes |
get_analytics | Obter dados de cliques em série temporal para gráficos |
get_analytics_by | Obter cliques agrupados por país, navegador, plataforma, etc. |
list_domains | Listar seus domínios personalizados |
list_webhooks | Listar inscrições de webhook do workspace |
subscribe_webhook | Inscrever uma URL para receber eventos de clique |
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 - 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.comestá acessível de sua máquina - No Claude Code, execute
/mcpe 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.
Disponibilidade do plano
Disponível a partir do Pro
Rastreie 500 cliques mensais com todos os recursos incluídos.