linkonda-mcp

Servidor MCP Linkonda

Crie e gerencie Linkonda links curtos a partir do Claude, Claude Code, Cursor, ou qualquer outro cliente MCP.

O Linkonda registra uma contagem total de redirecionamentos por link e nada mais — sem endereços IP, geolocalização, dados de dispositivo ou referenciadores. Isso importa mais do que o normal para um agente, que pode gerar links em massa sem construir um conjunto de dados de visitantes que você depois precise proteger, reter e responder a solicitações sobre.

Funciona sem chave de API

A maioria dos servidores MCP de encurtadores se recusa a iniciar sem credenciais. Este encurta URLs imediatamente após a instalação: links anônimos são limitados por rede e expiram após 30 dias. Adicione uma chave quando quiser links que persistam e possam ser gerenciados.

	Sem chave	Com LINKONDA_API_KEY
shorten_link	✅ 10 links, expiram após 30 dias	✅ permanentes, salvos na sua conta
get_link_stats	✅	✅
check_quota	✅ cota anônima	✅ seu plano
shorten_links_bulk, list_links, update_link, delete_link	✗	✅

Autenticação Bearer requer um plano pago — veja preços. Crie uma chave no painel em Chaves de API; ela é exibida apenas uma vez.

Instalação

Adicione à configuração do seu cliente MCP (Claude Desktop: claude_desktop_config.json; Claude Code: .mcp.json):

{
  "mcpServers": {
    "linkonda": {
      "command": "npx",
      "args": ["-y", "@veranoapp/linkonda-mcp"]
    }
  }
}

Para usar uma chave de API, adicione-a à mesma entrada:

{
  "mcpServers": {
    "linkonda": {
      "command": "npx",
      "args": ["-y", "@veranoapp/linkonda-mcp"],
      "env": { "LINKONDA_API_KEY": "lk_your_key_here" }
    }
  }
}

Variável	Padrão	Finalidade
LINKONDA_API_KEY	(não definido)	Chave Bearer. Omita para executar anonimamente.
LINKONDA_API_BASE_URL	https://api.linkonda.com	Aponte para outra instância.

Ferramentas

Ferramenta	O que faz	Chave necessária
shorten_link	Encurta uma URL	Não
shorten_links_bulk	Encurta até 100 URLs em uma única solicitação	Sim
list_links	Lista seus links com destinos e contagens de cliques	Sim
update_link	Altera um destino, ou pausa/retoma um link	Sim
delete_link	Exclui permanentemente um link	Sim
get_link_stats	Contagem total de redirecionamentos para um link	Não
check_quota	Links ativos vs. cota do plano	Não

shorten_links_bulk é de sucesso parcial: algumas entradas podem falhar (cota, URL inválida) enquanto outras são criadas, e a ferramenta relata ambas as listas em vez de apenas os sucessos.

O que você não pode obter

Não há dados por visitante para retornar, portanto não há ferramentas para detalhamentos geográficos, de dispositivo ou de referenciadores — esses dados nunca são coletados. Se seu fluxo de trabalho precisar de atribuição de cliques, um encurtador com rastreamento é a ferramenta certa; veja as comparações.

Desenvolvimento

npm install
npm run build
LINKONDA_API_KEY=lk_... npm start   # speaks MCP over stdio

npm run typecheck executa o compilador sem emitir saída.