Linkly

MCP oficial do encurtador de URLs Linkly: crie links curtos personalizados, acompanhe análises de cliques, gerencie domínios e webhooks. Hospedado, OAuth, sem chaves de API.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP Linkly

Servidor oficial do Model Context Protocol (MCP) para Linkly — a plataforma de encurtamento de URLs e gerenciamento de links.

Este repositório alimenta o servidor MCP hospedado em https://mcp.linklyhq.com. Essa é a única forma suportada de conectar um assistente de IA ao Linkly via MCP. Consulte https://linklyhq.com/support/mcp-server para instruções de configuração.

⚠️ O pacote npm linkly-mcp-server está descontinuado. O fluxo auto-hospedado / com chave de API não é mais mantido. Todos os usuários devem migrar para o servidor hospedado — ele usa OAuth 2.1 com PKCE, não requer chaves de API nem instalação local, e sempre executa o conjunto de ferramentas mais recente. O pacote npm continuará existindo no registro para compatibilidade reversa, mas não receberá novas ferramentas ou correções de bugs, e poderá ser removido no futuro.

Documentação

Para documentação completa, guias de configuração e exemplos, visite: https://linklyhq.com/support/mcp-server

Recursos

Criar, atualizar e excluir links curtos
Visualizar análises e estatísticas de cliques
Gerenciar domínios personalizados e favicons
Configurar webhooks para eventos de clique
Pesquisar e filtrar links
Exportar dados de cliques

Usando o servidor hospedado

URL do servidor: https://mcp.linklyhq.com

Conecte seu cliente MCP ao servidor hospedado e faça login no Linkly quando o navegador abrir. É isso — sem chaves de API, sem instalação, sem desvio de configuração.

Claude Desktop

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linklyhq.com"]
    }
  }
}

Claude Code (CLI)

claude mcp add --transport http linkly https://mcp.linklyhq.com

ChatGPT Desktop

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com"
    }
  }
}

Ferramentas Disponíveis

Ferramenta	Descrição
`create_link`	Criar um novo link curto
`update_link`	Atualizar um link existente
`delete_link`	Excluir um link
`get_link`	Obter detalhes do link
`list_links`	Listar todos os links no espaço de trabalho
`search_links`	Pesquisar links por nome, URL ou nota
`get_analytics`	Obter dados de cliques em série temporal
`get_analytics_by`	Obter cliques agrupados por dimensão
`get_clicks`	Obter dados de cliques recentes
`export_clicks`	Exportar registros detalhados de cliques
`list_domains`	Listar domínios personalizados
`create_domain`	Adicionar um domínio personalizado
`delete_domain`	Remover um domínio personalizado
`update_domain_favicon`	Atualizar favicon do domínio
`list_webhooks`	Listar webhooks do espaço de trabalho
`subscribe_webhook`	Adicionar um webhook
`unsubscribe_webhook`	Remover um webhook
`list_link_webhooks`	Listar webhooks específicos de links
`subscribe_link_webhook`	Adicionar um webhook de link
`unsubscribe_link_webhook`	Remover um webhook de link

Suporte

Para ajuda e suporte, visite Suporte do Linkly ou envie um e-mail para support@linklyhq.com.

Publicação no Registro MCP (mantenedores)

O server.json na raiz do repositório é o manifesto do Registro MCP oficial para o servidor com.linklyhq/linkly. Ele é somente remoto: aponta os clientes para o servidor hospedado e intencionalmente não inclui pacote (a distribuição npm descontinuada foi removida em v2.0.0).

A publicação requer acesso DNS a linklyhq.com — o namespace com.linklyhq é verificado por meio de um registro TXT de DNS no ápice do domínio:

# 1. Generate an Ed25519 key + TXT record (macOS: use openssl@3; system LibreSSL lacks Ed25519)
openssl genpkey -algorithm Ed25519 -out key.pem
PUBLIC_KEY="$(openssl pkey -in key.pem -pubout -outform DER | tail -c 32 | base64)"
echo "linklyhq.com. IN TXT \"v=MCPv1; k=ed25519; p=${PUBLIC_KEY}\""   # add at the APEX of linklyhq.com

# 2. Authenticate the namespace + publish
PRIVATE_KEY="$(openssl pkey -in key.pem -noout -text | grep -A3 'priv:' | tail -n +2 | tr -d ' :\n')"
mcp-publisher login dns --domain linklyhq.com --private-key "$PRIVATE_KEY"
mcp-publisher publish

Consulte o guia de autenticação do registro para detalhes.

Atualizando o aplicativo ChatGPT (mantenedores)

chatgpt-app-submission.json é a importação de submissão do SDK de Apps da OpenAI — ela pré-preenche as anotações por ferramenta e as três justificativas de segurança (somente leitura / mundo aberto / destrutivo) para todas as 25 ferramentas, para que não precisem ser digitadas manualmente no painel.

A OpenAI congela um instantâneo de metadados no momento da publicação e não detecta automaticamente alterações no MCP. Portanto, após implantar alterações no servidor, você publica uma nova versão:

Implante o worker (faça push para o branch conectado / wrangler deploy).
Painel da plataforma → o aplicativo Linkly → crie uma nova versão de rascunho (mantenha a mesma URL do MCP https://mcp.linklyhq.com).
Na seção MCP, clique em Scan Tools para reler a lista de ferramentas ativas + anotações.
Arraste chatgpt-app-submission.json para o formulário (no topo da página) para preencher as justificativas.
Revise Testing e depois Submit. A versão publicada continua executando contra o servidor ativo até que a nova seja aprovada.

Mantenha este arquivo sincronizado com o worker sempre que ferramentas forem adicionadas/removidas ou quando seus readOnlyHint/destructiveHint mudarem. O sinalizador destrutivo é true apenas para as 5 ferramentas genuinamente destrutivas (delete_link, delete_domain, batchDeleteLinks, unsubscribe_webhook, unsubscribe_link_webhook); criações/atualizações/assinaturas são aditivas (false).

Licença

MIT