Linkly Link Shortener

Linkly MCP Server

O Linkly MCP Server permite conectar assistentes de IA à sua conta Linkly usando o Model Context Protocol. Uma vez conectado, você pode criar e gerenciar links curtos através de conversas naturais.

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA se conectem de forma segura 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 compatíveis

O Linkly MCP Server funciona com:

• Claude Desktop
• ChatGPT Desktop
• Outros clientes compatíveis com MCP (Cursor, Windsurf, etc.)

Servidor MCP ou Linkly CLI?

Se o seu assistente de IA for um agente de codificação que pode executar comandos shell — como Claude Code ou Cursor — a Linkly CLI geralmente é uma opção melhor do que o servidor MCP. Agentes de codificação já estão acostumados a usar ferramentas de linha de comando, e a CLI fornece a eles saída --json em cada comando, além de um comando linkly schema que imprime a árvore de comandos completa, para que o agente possa descobrir tudo o que pode fazer. O servidor MCP continua sendo a melhor escolha para assistentes que não podem executar comandos shell, como Claude Desktop e ChatGPT Desktop.

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://my-site.com/webhook para receber eventos de clique"

Primeiros passos

O Linkly MCP Server hospedado está em https://mcp.linklyhq.com. Não há nada para instalar e nenhuma chave de API para copiar — o servidor usa OAuth, então na primeira vez que seu assistente de IA se conectar, uma janela do navegador será aberta pedindo para você fazer login no Linkly e aprovar o acesso. Depois disso, seu assistente permanece conectado.

https://mcp.linklyhq.com

Configuração

Claude desktop

No Claude Desktop, vá para Configurações → Conectores → Adicionar conector personalizado. Insira um nome (Linkly) e a URL do servidor MCP remoto:

Click **Add**, then **Connect** on the Linkly connector. A browser tab opens for you to sign in and approve access. Claude Desktop then stays connected — no config file or extra tooling needed.

### Claude code (CLI)

Claude Code supports remote MCP servers natively. Add Linkly with one command:

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

Then run `/mcp` inside Claude Code, pick **linkly**, and authorize in the browser when prompted.

### ChatGPT desktop

Open your ChatGPT config file:

* **macOS:** `~/Library/Application Support/ChatGPT/mcp_servers.json`
* **Windows:** `%APPDATA%\ChatGPT\mcp_servers.json`

Add the Linkly MCP server:

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

## Ferramentas disponíveis

| Ferramenta         | Descrição                                                                 |
| ------------------ | ------------------------------------------------------------------------- |
| create_link       | Cria um novo link curto com parâmetros UTM opcionais, pixels e mais       |
| update_link       | Atualiza as configurações de um link existente                            |
| delete_link       | Exclui um link                                                            |
| get_link          | Obtém detalhes de um link específico                                      |
| list_links        | Lista todos os links no seu espaço de trabalho                            |
| search_links      | Pesquisa links por nome, URL ou nota                                      |
| get_clicks        | Obtém dados de cliques recentes                                           |
| get_analytics     | Obtém dados de cliques em série temporal para gráficos                    |
| get_analytics_by | Obtém cliques agrupados por país, navegador, plataforma, etc.             |
| list_domains      | Lista seus domínios personalizados                                        |
| list_webhooks     | Lista as inscrições de webhook do espaço de trabalho                      |
| subscribe_webhook | Inscreve uma URL para receber eventos de clique                           |

## 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`

## Solução de problemas

### "Não foi possível conectar ao servidor MCP"

* Confirme se `https://mcp.linklyhq.com` está acessível a partir da sua máquina
* No Claude Code, execute `/mcp` e escolha **linkly** para reativar o fluxo OAuth

### "Falha na autenticação", "invalid_client" ou o navegador continua pedindo para fazer login

Isso significa que seu cliente está mantendo um registro de conexão obsoleto. Limpe as credenciais em cache e reautorize. No Claude Code, execute `/mcp` → **linkly** → reconectar. No Claude Desktop, remova o conector Linkly em **Configurações → Conectores** e adicione-o novamente, depois faça login novamente.

### Ferramentas não aparecendo

* Reinicie seu assistente de IA após salvar a configuração
* Verifique se a sintaxe JSON no seu arquivo de configuração é válida
* Verifique se o servidor MCP está em execução (procure pelo ícone de ferramentas no seu assistente)

## Recursos relacionados

* Integração com Claude Desktop
* Integração com ChatGPT
* Documentação da API Linkly
* Linkly CLI
* Webhooks
* Model Context Protocol

### Experimente o encurtador de URL gratuito do Linkly

Obtenha 100 links curtos e 500 cliques mensais gratuitamente. Sem cartão de crédito.

Obtenha seu link gratuitamente

500 cliques rastreados/mêsDomínios personalizadosSem necessidade de cartão de crédito

## Perguntas frequentes sobre o servidor MCP

### Preciso instalar algo para usar o servidor MCP?

Não. O servidor hospedado em https://mcp.linklyhq.com usa OAuth — você faz login uma vez no navegador e seu assistente de IA permanece conectado. Não há software para instalar na sua máquina além do próprio assistente de IA.

### Preciso de uma chave de API?

Não. O servidor MCP usa OAuth — você faz login no Linkly através do seu navegador na primeira vez que seu assistente de IA se conectar, e não há chave de API para copiar ou colar em lugar nenhum.

### Quais assistentes de IA suportam MCP?

Claude Desktop, Claude Code (CLI) e ChatGPT Desktop suportam MCP. Outras ferramentas como Cursor e Windsurf também têm suporte a MCP.

### Minha conta está segura?

Sim. O servidor hospedado usa OAuth 2.1 com PKCE — sua senha do Linkly só é inserida em app.linklyhq.com, e seu assistente de IA só vê um token de acesso com escopo limitado ao seu espaço de trabalho. O modelo de IA em si nunca vê suas credenciais.

### Posso usar MCP com as versões web do Claude ou ChatGPT?

Não, o MCP requer os aplicativos desktop ou o Claude Code CLI. As versões web não suportam conexões MCP.

### Como atualizo o servidor MCP?

Não há nada para atualizar — implantamos melhorias no servidor hospedado continuamente e todos os clientes conectados as recebem automaticamente.

Disponibilidade do plano

Disponível no Pro e superiores

Comparar planos →

GrátisInicialProBusinessEnterprise

Obtenha 100 links curtos e rastreie 500 cliques mensais gratuitamente.

Comece Grátis

Sem necessidade de cartão de crédito

Alto volume? Fale com nossa equipe