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:
- 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 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
- 1Faça login no seu painel Linkly
- 2Vá para Configurações → Chaves de API
- 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
| Ferramenta | Descrição |
|---|---|
create_link | Criar um novo link curto com parâmetros UTM opcionais, pixels e mais |
update_link | Atualizar as configurações de um link existente |
delete_link | Excluir 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 cliques 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 assinaturas de webhook do workspace |
subscribe_webhook | Inscrever 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ável | Obrigatória | Descrição |
|---|---|---|
LINKLY_API_KEY | Sim | Sua chave de API Linkly |
LINKLY_WORKSPACE_ID | Não | Seu 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-serverem 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.