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:
- Claude Desktop
- ChatGPT Desktop
- Outros clientes compatíveis com MCP (Cursor, Windsurf, etc.)
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/webhookpara 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
| Ferramenta | Descrição |
|---|---|
create_link | Crie um novo link curto com parâmetros UTM opcionais, pixels e mais |
update_link | Atualize as configurações de um link existente |
delete_link | Exclua um link |
get_link | Obtenha detalhes de um link específico |
list_links | Liste todos os links em seu espaço de trabalho |
search_links | Pesquise links por nome, URL ou nota |
get_clicks | Obtenha dados de cliques recentes |
get_analytics | Obtenha dados de cliques em série temporal para gráficos |
get_analytics_by | Obtenha cliques agrupados por país, navegador, plataforma, etc. |
list_domains | Liste seus domínios personalizados |
list_webhooks | Liste assinaturas de webhook do espaço de trabalho |
subscribe_webhook | Inscreva 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
Solução de Problemas
"Não foi possível conectar ao servidor MCP"
- Confirme que
https://mcp.linklyhq.comestá 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
/mcpe 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 /mcp → linkly → 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