Saltar para o conteúdo
Todos os artigos

mcpclaude-codeagents

Como adicionar um encurtador de URLs ao Claude Code com MCP

Ligue o Claude Code ao Linkdash por MCP para criar links curtos, dividir tráfego, partilhar ficheiros e ler estatísticas de cliques sem sair do terminal.

Igor Kirnosov6 min de leitura

O Claude Code a chamar o servidor MCP do Linkdash para criar o link curto lida.sh/pricing

O Claude Code pode criar e gerir links curtos depois de o ligar a um encurtador de URLs por MCP. Adicione o servidor MCP do Linkdash com um único comando, inicie sessão uma vez no navegador e o Claude passa a poder encurtar URLs, dividir tráfego entre páginas, partilhar ficheiros com data de expiração e ler estatísticas de cliques, tudo na mesma sessão de terminal onde escreve o seu código.

Este guia cobre a configuração, como partilhá-la com a sua equipa, como escolher as ferramentas que o Claude pode executar sem perguntar, os fluxos de trabalho em que compensa e como usá-lo em CI. Usa o Cursor ou o Codex? A documentação do MCP lista os respetivos comandos de configuração.

O que o Claude Code pode fazer com ele

O servidor MCP do Linkdash expõe as mesmas operações que a CLI e a API HTTP, como ferramentas que o Claude descobre sozinho:

Ferramentas O que o Claude pode fazer
links_create, links_update, links_delete Criar, alterar, pausar e remover links
variants_add, variants_update, variants_remove Dividir tráfego ou encaminhar por país, dispositivo ou sistema operativo
links_list, links_get, links_stats Encontrar links e ler visitas, países e origens
files_upload_url Carregar um ficheiro e partilhá-lo como link
links_export, links_import Importar e exportar links em CSV
domains_*, webhooks_* Gerir domínios personalizados e webhooks

Passo 1: Adicione o servidor

claude mcp add --transport http linkdash \
  https://api.linkdash.dev/mcp

Isto adiciona o Linkdash ao projeto atual. Acrescente --scope user para o disponibilizar em todos os projetos da sua máquina.

Passo 2: Inicie sessão

claude mcp login linkdash

O navegador abre o início de sessão do Linkdash. Se ainda não tiver conta, pode criar uma aí no plano Free. Depois de iniciar sessão, um ecrã de consentimento pergunta se o Claude Code pode usar a sua conta. Clique em Permitir, e o Claude Code guarda o token de acesso e renova-o sozinho.

Também pode iniciar sessão a partir de uma sessão do Claude Code: execute /mcp, escolha linkdash e opte por autenticar. Verifique a ligação com:

claude mcp list

linkdash deve aparecer como ✔ Connected. Depois, experimente:

Encurte https://example.com/pricing como lida.sh/pricing.

O Claude chama links_create e responde com o novo link curto.

Passo 3: Partilhe a configuração com a sua equipa

Para dar a todos num repositório o mesmo servidor, adicione um ficheiro .mcp.json à raiz do projeto:

{
  "mcpServers": {
    "linkdash": {
      "type": "http",
      "url": "https://api.linkdash.dev/mcp"
    }
  }
}

O ficheiro não contém nada secreto, por isso pode fazer commit dele em segurança. Da primeira vez que um colega abre o projeto, o Claude Code pede-lhe que aprove o servidor, e cada pessoa inicia sessão com a sua própria conta Linkdash, por isso cada link fica na conta de quem o pediu.

Passo 4: Decida o que é executado sem perguntar

Por predefinição, o Claude Code pergunta antes de chamar uma ferramenta MCP. Ler estatísticas é inofensivo, por isso vale a pena permitir; eliminar links é algo que vale a pena bloquear de vez. Adicione regras de permissões a .claude/settings.json:

{
  "permissions": {
    "allow": [
      "mcp__linkdash__links_list",
      "mcp__linkdash__links_get",
      "mcp__linkdash__links_stats"
    ],
    "deny": [
      "mcp__linkdash__links_delete",
      "mcp__linkdash__variants_remove"
    ]
  }
}

As ferramentas MCP chamam-se mcp__<server>__<tool>, por isso estas regras pressupõem que deu ao servidor o nome linkdash no passo 1. Criar e atualizar links continua a pedir confirmação de cada vez, o que o mantém a par de tudo o que muda o destino de um link.

Fluxos de trabalho que compensam no terminal

Crie links curtos para todos os URLs em CHANGELOG.md na secção 2.4.0, dê-lhes a etiqueta release-2.4 e substitua os URLs no ficheiro.

O Claude lê o ficheiro, chama links_create uma vez por URL com a etiqueta e edita o changelog. A etiqueta mantém os links da versão juntos no painel e em perguntas posteriores sobre estatísticas.

Dividir uma página que acabou de construir

Crie lida.sh/pricing a dividir os visitantes 50/50 entre /pricing e /pricing-v2, com utm_content definido com o nome de cada variante.

O Claude cria um link com duas variantes, cada uma com a sua etiqueta para que a sua ferramenta de análise consiga distinguir os grupos. O guia sobre como fazer um teste A/B a um link explica durante quanto tempo executar o teste e como ler o resultado.

Partilhar uma build que expira

Partilhe dist/app-1.4.2.dmg como um link que expira daqui a 3 dias e deixa de funcionar após 5 aberturas.

Como o Claude Code tem acesso a uma shell, consegue lidar com ficheiros: chama files_upload_url, carrega o ficheiro para o URL devolvido com curl e depois chama links_create com o ficheiro carregado, expires: "3d" e maxOpenings: 5. O ficheiro nunca passa pela conversa.

Que links com a etiqueta release-2.4 tiveram mais visitas nos últimos 7 dias, e de onde vieram as visitas?

O Claude lista os links com essa etiqueta e depois chama links_stats para cada um com last: "7d". Cada resultado inclui visitas, países e origens. Com as regras de permissões do passo 4, estas leituras são executadas sem pedir confirmação.

Usar o Claude Code em CI

Iniciar sessão exige uma pessoa num navegador, por isso as execuções sem interface, como claude -p numa tarefa de CI, usam uma chave de API. Crie uma em Chaves de API (as chaves começam por ldash_), guarde-a como um segredo de CI chamado LINKDASH_API_KEY e passe-a como cabeçalho:

{
  "mcpServers": {
    "linkdash": {
      "type": "http",
      "url": "https://api.linkdash.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${LINKDASH_API_KEY}"
      }
    }
  }
}

O Claude Code preenche ${LINKDASH_API_KEY} a partir do ambiente, por isso a chave nunca entra num commit. As ferramentas e as regras de permissões funcionam da mesma forma nos dois casos.

MCP ou CLI?

O Claude Code também pode executar a CLI linkdash através da shell, e ambas acedem à mesma conta:

  • O MCP não precisa de instalação. O Claude vê ferramentas tipadas e os respetivos parâmetros, o que o torna a escolha mais simples quando só quer que o Claude gira links.
  • A CLI (npm i -g linkdash-cli) devolve JSON, o que é ideal para scripts que o Claude escreve por si. Para ensinar a CLI ao Claude, instale o skill de agente do Linkdash com npx skills add https://linkdash.dev/skills/linkdash/SKILL.md.

Resolução de problemas

  • linkdash mostra ! Needs authentication. Execute claude mcp login linkdash e inicie sessão novamente. Isto também acontece depois de desligar o Claude Code no painel.
  • Um servidor de .mcp.json fica pendente. Inicie claude no projeto e aprove-o. claude mcp reset-project-choices limpa as escolhas anteriores.
  • As ferramentas falham com um erro 401 em CI. LINKDASH_API_KEY não está definida ou está errada nesse ambiente, ou a chave foi eliminada.

Perguntas frequentes

O Claude vê a minha palavra-passe ou uma chave?

Não. Inicia sessão em linkdash.dev no navegador, e o Claude Code recebe um token que guarda na sua própria configuração. Nem a palavra-passe nem o token precisam de aparecer na conversa.

Como desligo o Claude Code?

No painel do Linkdash, abra Chaves de API e clique em Desligar ao lado do Claude Code, em Apps ligadas. O acesso termina de imediato. Executar claude mcp logout linkdash também remove o token guardado na sua máquina.

Só se o permitir. As regras de recusa do passo 4 bloqueiam links_delete e variants_remove, mesmo que o Claude tente.

É gratuito?

Sim, no plano Free, que inclui 5000 eventos por mês. Consulte os preços para limites mais altos.

Também posso ligar o Cursor, o Codex ou o ChatGPT?

Sim. O mesmo servidor funciona com todos eles, e a maioria só precisa do URL e de um início de sessão. A documentação do MCP lista os passos para cada um.