Model Context Protocol

Servidor MCP do LinkTwin: deixe seu agente de IA criar e gerenciar links.

O servidor MCP oficial de encurtamento de links e deep linking. Conecte o Claude, o Cursor e outros assistentes de IA à sua conta do LinkTwin e é só pedir: crie links curtos e deep links, organize coleções, associe pixels, gere QR codes e leia suas análises.

Ver a configuração
npx -y @linktwin/mcp
  • Licença MIT, no npm
  • Roda na sua máquina
  • Funciona com qualquer cliente MCP
Assistente de IA 34 ferramentas do LinkTwin
Crie um link curto para o meu vídeo de tour pela mesa https://www.youtube.com/watch?v=x7K2pQ9mW4s com o alias desk-tour e adicione à minha coleção YouTube.
linktwin create_linkEm execução Pronto
{
  "url": "https://www.youtube.com/watch?v=x7K2pQ9mW4s",
  "custom": "desk-tour",
  "collections": ["YouTube"]
}

Pronto. Seu novo link está na coleção YouTube:

linktw.in/desk-tourAbre no app do YouTube
Exemplos de conversas. Os nomes das ferramentas e os argumentos são os reais.

Por que um servidor MCP

De "encurta isso" até pronto, sem sair do chat.

Trocar para um painel ou configurar a API REST manualmente quebra seu fluxo. O servidor MCP do LinkTwin dá ao seu assistente de IA ferramentas de gerenciamento de links de primeira classe, para que ele possa criar links de campanha, deep links e QR codes para você enquanto você permanece na conversa.

Passos até concluir

  • Painel e copiar e colar
  • Servidor MCP do LinkTwin
Criar um link com alias
Encontre seu link principal deste mês
Contado para alguém que já está logado. Cada bloco é uma ação. Alguns clientes permitem sempre autorizar uma ferramenta, o que também elimina a etapa de aprovação.
A tarefa Sem um MCP Com o MCP do LinkTwin
Criação de links Copiar e colar entre o chat e o painel Crie links apenas pedindo
Segmentação e UTM Escrever à mão chamadas de API e cabeçalhos de autenticação Deep links, segmentação e UTM em um único prompt
Seus números A IA não consegue ver seus links ou estatísticas A IA lê suas análises sob demanda
Trabalho repetitivo Lento, propenso a erros, repetitivo Operações em massa em segundos

Configuração

Conecte em três passos

Nada para instalar: o npx executa o servidor sob demanda. Você só precisa do Node.js 18 ou mais recente e da sua chave de API.

  1. Obtenha sua chave de API

    Copie sua chave de API em Configurações ou na página Servidor MCP do seu painel do LinkTwin. O acesso à API está disponível em todos os planos.

  2. Adicione o trecho de configuração

    Cole o JSON abaixo na configuração do seu cliente de IA e insira sua chave de API.

  3. Basta pedir

    Reinicie seu cliente e peça para ele criar, editar ou analisar links. As ferramentas do LinkTwin aparecem automaticamente.

Um único trecho para conectar

Adicione isto ao Claude Desktop, Cursor ou qualquer cliente MCP e depois reinicie.

Claude Desktop

No Claude Desktop, abra Settings, depois Developer, depois Edit Config. Cole o bloco em claude_desktop_config.json.

{
  "mcpServers": {
    "linktwin": {
      "command": "npx",
      "args": ["-y", "@linktwin/mcp"],
      "env": { "LINKTWIN_API_KEY": "YOUR_API_KEY" }
    }
  }
}
Cursor

No Cursor, crie .cursor/mcp.json no seu projeto e cole o bloco.

{
  "mcpServers": {
    "linktwin": {
      "command": "npx",
      "args": ["-y", "@linktwin/mcp"],
      "env": { "LINKTWIN_API_KEY": "YOUR_API_KEY" }
    }
  }
}
Outros clientes MCP

Claude Code, Windsurf, Cline e outros clientes MCP aceitam o mesmo JSON nas configurações de MCP.

{
  "mcpServers": {
    "linktwin": {
      "command": "npx",
      "args": ["-y", "@linktwin/mcp"],
      "env": { "LINKTWIN_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Duas variáveis de ambiente

O servidor se comunica em JSON-RPC via stdio e lê as configurações do bloco env da sua configuração.

VariávelO que faz
LINKTWIN_API_KEY Obrigatória. Sua chave de API da página Configurações do LinkTwin.
LINKTWIN_BASE_URL Opcional. A raiz do site que o servidor chama. O padrão é https://linktw.in.

Funciona com

  • Claude Desktop
  • Claude Code
  • Cursor
  • Windsurf
  • Cline
  • Qualquer cliente MCP
  • Node.js 18 ou mais recente, nada mais para instalar.
  • As ferramentas têm nomes de acordo com o que fazem, então você pode pedir por elas com suas próprias palavras.
  • Prefere o terminal? Use a CLI do LinkTwin. Criando sua própria integração? Leia a documentação da API.

Recursos

Tudo o que seu agente pode gerenciar

34 ferramentas que cobrem toda a superfície de gerenciamento de links do LinkTwin. Toda ferramenta de link aceita segmentação por localização, dispositivo e idioma, variantes de teste A/B e parâmetros UTM, definidos em um único prompt.

34

ferramentas em sete grupos. Cada uma encapsula um endpoint da API REST do LinkTwin e verifica os dados antes de rodar.

Links6

Crie, edite, liste e exclua links com aliases personalizados, expiração, senhas e limites de cliques.

  • create_linkCriar link curto
  • list_linksListar links
  • get_linkObter link
  • update_linkAtualizar link
  • delete_linkExcluir link
  • bulk_delete_linksExcluir links em massa

Análises4

Estatísticas de cliques por link e de toda a conta: principais países, referenciadores, navegadores, dispositivos e tendências diárias.

  • get_link_statsObter análises do link
  • get_dashboard_statsEstatísticas do painel da conta
  • get_detailed_statsEstatísticas detalhadas da conta
  • get_day_trendTendência diária da conta

Coleções6

Agrupe links em coleções e gerencie seus domínios personalizados com marca.

  • list_collectionsListar coleções
  • get_collectionObter itens da coleção
  • create_collectionCriar coleção
  • update_collectionAtualizar coleção
  • add_links_to_collectionAdicionar/remover links da coleção
  • delete_collectionExcluir coleção

Domínios4

Adicione domínios personalizados e escolha para onde o domínio raiz e os links inexistentes enviam os visitantes.

  • list_domainsListar domínios
  • add_domainAdicionar domínio personalizado
  • update_domainAtualizar domínio
  • delete_domainExcluir domínio

Pixels6

Crie pixels do Facebook, GTM e outros e anexe-os a links em massa.

  • list_pixelsListar pixels
  • get_pixelObter pixel
  • create_pixelCriar pixel
  • update_pixelAtualizar pixel
  • delete_pixelExcluir pixel
  • assign_pixel_to_linksAssociar pixel a links

QR codes5

Gere e atualize QR codes para qualquer link, com cores e logos.

  • list_qr_codesListar Códigos QR
  • get_qr_codeObter QR code
  • create_qr_codeCriar QR code
  • update_qr_codeAtualizar QR code
  • delete_qr_codeExcluir QR code

Conta3

Confira seu plano e uso, defina seu domínio e fuso horário padrão e alterne entre workspaces.

  • get_accountObter informações da conta
  • update_account_settingsAtualizar configurações da conta
  • switch_workspaceAlternar workspace

Experimente pedir ao seu assistente

Escreva o pedido do jeito que você falaria. O assistente escolhe as ferramentas, preenche os argumentos e conta o que fez.

Criar um link de campanha

Crie um link curto para https://example.com/spring-sale com o alias spring-sale e adicione-o à minha coleção de Marketing.
  • Chama
  • create_link

Direcione visitantes por país

Crie um deep link que abre o example.ca para visitantes canadenses e o example.com para todos os demais.
  • Chama
  • create_link

Encontre seus melhores links

Quais dos meus links receberam mais cliques este mês e de onde veio o tráfego?
  • Chama
  • get_detailed_stats

QR codes e retargeting

Gere um QR code para o meu link mais recente e anexe meu pixel do Facebook a ele.
  • Chama
  • list_links
  • create_qr_code
  • list_pixels
  • assign_pixel_to_links

Limpar testes antigos

Encontre meus links com "test" no título e exclua todos.
  • Chama
  • list_links
  • bulk_delete_links

Trabalhe no workspace de uma equipe

Mude para o workspace da minha equipe e liste os domínios personalizados que podemos usar.
  • Chama
  • get_account
  • switch_workspace
  • list_domains

Como funciona o servidor MCP do LinkTwin

Seu cliente de IA inicia o servidor no seu computador com o npx e se comunica com ele via stdio. O servidor chama a API do LinkTwin via HTTPS com a sua chave de API, dentro da sua própria conta.

  1. Seu cliente de IA Claude, Cursor, Windsurf, Cline ou qualquer cliente MCP
  2. Servidor MCP do LinkTwin Iniciado por npx -y @linktwin/mcp No seu computador
  3. API do LinkTwin Seus links, coleções, pixels, QR codes e estatísticas
  • Ele só faz o que a sua chave de API permite, dentro da sua própria conta e workspace.
  • Erros como chave errada, limite de requisições, limite do plano ou dados inválidos voltam como resultados da ferramenta marcados como erro, para que o agente possa explicar ou tentar de novo.
  • Nada é excluído a menos que o agente chame uma ferramenta de exclusão, como delete_link ou bulk_delete_links.
  • Gere uma nova chave de API a qualquer momento para revogar o acesso na hora.

Perguntas sobre o Servidor MCP

Tudo sobre o MCP de encurtamento de links e deep linking. Ainda tem dúvidas? Fale conosco.

O que é o servidor MCP do LinkTwin?

O servidor MCP do LinkTwin é o servidor oficial do Model Context Protocol (MCP) para encurtamento de links e deep linking. Ele conecta assistentes de IA como Claude e Cursor à sua conta do LinkTwin, para que possam criar, editar e gerenciar links curtos e deep links, organizar coleções, associar pixels de retargeting, gerar QR codes e ler análises de cliques, tudo a partir de uma conversa em linguagem natural.

O que é um servidor MCP (Model Context Protocol)?

MCP é um padrão aberto que permite que assistentes de IA se conectem a ferramentas e dados externos. Um servidor MCP expõe um conjunto de ferramentas que o assistente pode chamar. O servidor MCP do LinkTwin expõe 34 ferramentas de gerenciamento de links, então qualquer app compatível com MCP (Claude Desktop, Claude Code, Cursor, Windsurf, Cline e outros) pode gerenciar seus links por você.

O MCP de encurtamento de links é gratuito?

O servidor MCP em si é gratuito e tem licença MIT, publicado no npm como @linktwin/mcp. Ele funciona por meio da API do LinkTwin, e o acesso à API está disponível em todos os planos. Você pode criar uma conta grátis primeiro e fazer upgrade quando estiver pronto para conectar seu agente.

Quais clientes de IA são suportados?

Qualquer cliente que fale o Model Context Protocol via stdio, incluindo Claude Desktop, Claude Code, Cursor, Windsurf e Cline. Você adiciona um trecho de JSON às configurações de MCP do cliente, e as ferramentas do LinkTwin aparecem depois de reiniciar.

O servidor MCP consegue criar deep links e não apenas links curtos?

Sim. Ele é um MCP de deep linking e também de encurtamento de links. Pelo seu assistente, você pode criar links que abrem em apps como YouTube, Amazon e Spotify, com segmentação por localização, dispositivo e idioma, variantes de teste A/B, parâmetros UTM, domínios personalizados e saída do navegador interno. São as mesmas opções do painel e da API do LinkTwin.

Como obtenho minha chave de API?

Entre no LinkTwin e abra Configurações, ou Ferramentas e Integrações e depois Servidor MCP, no seu painel. Copie sua chave de API e cole na configuração do seu cliente MCP como LINKTWIN_API_KEY. A chave aparece quando o seu plano inclui acesso à API.

É seguro dar a um agente de IA acesso aos meus links?

O servidor MCP roda no seu próprio computador e só faz o que a sua chave de API permite, dentro da sua própria conta. Sua chave vai da sua máquina para a API do LinkTwin e nunca é compartilhada com terceiros. Excluir qualquer coisa exige uma chamada explícita de ferramenta, e você pode gerar uma nova chave de API a qualquer momento para revogar o acesso na hora.

Quais ferramentas o servidor MCP do LinkTwin inclui?

34 ferramentas em sete grupos: links (create_link, list_links, get_link, update_link, delete_link e bulk_delete_links), análises (get_link_stats, get_dashboard_stats, get_detailed_stats e get_day_trend), coleções, domínios personalizados, pixels de retargeting, QR codes e sua conta. Cada uma é uma camada fina sobre a API REST do LinkTwin, documentada na documentação da API.

Preciso instalar alguma coisa?

Só o Node.js 18 ou mais recente. O trecho de configuração executa o servidor sob demanda com npx -y @linktwin/mcp, então não há instalação global e você sempre usa a versão publicada.

Uma chave de API, três formas de desenvolver

A REST API, o servidor MCP e a CLI usam a mesma chave de API e gerenciam os mesmos links.

Dê à sua IA o poder de gerenciar links

Conecte o servidor MCP do LinkTwin e comece a criar links conversando.

npx -y @linktwin/mcp

O acesso à API está disponível em todos os planos. Ver planos