Snipzr

Crie, gerencie e meça links curtos no seu próprio domínio a partir do Claude, ChatGPT, Cursor ou VS Code.

Servidor MCP hospedado

npx add-mcp 'https://mcp.snipzr.com/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Servidor MCP Snipzr

O servidor MCP oficial do Snipzr. Um único endpoint hospedado dá a qualquer cliente MCP treze ferramentas para criar, gerenciar e medir links curtos: domínios personalizados, criação em lote, analytics sem cookies, relatórios de campanha, construção de UTM e QR codes.

https://mcp.snipzr.com/mcp

Não há nada para instalar ou executar. O servidor é remoto (HTTP Streamable), sem estado e disponível em todos os planos pagos do Snipzr. Este repositório é sua casa pública: configuração, referência de ferramentas e metadados de registro. O servidor em si faz parte da plataforma Snipzr, e suas ferramentas são adaptadores leves sobre os mesmos handlers que atendem à API REST pública, então as duas superfícies sempre se comportam de forma idêntica.

Início rápido

1. Conecte-se com login (recomendado). A maioria dos clientes não precisa de token algum: aponte-os para o endereço do servidor e eles abrem um login do Snipzr. A tela de consentimento mostra exatamente quais permissões o aplicativo recebe e em quais de seus workspaces ele pode atuar; desmarque o que não quiser e desconecte-o depois em Configurações.

Claude Code, dois comandos:

claude mcp add --transport http snipzr https://mcp.snipzr.com/mcp
claude mcp login snipzr

Claude na web, desktop e mobile: abra Configurações, depois Conectores, depois Adicionar conector personalizado, insira o endereço do servidor e selecione Conectar. O ChatGPT conecta da mesma forma no modo desenvolvedor. Smithery, Glama e outros diretórios conectam pelo mesmo login.

2. Ou use um token. Em Configurações, crie um token e copie o segredo (ele é mostrado apenas uma vez):

Tokens de API de usuário agem como você. Escolha os workspaces em que o token pode atuar e o que ele pode fazer em cada um.
Tokens de API de workspace pertencem a um workspace e agem como esse workspace. A escolha certa para um assistente de equipe compartilhado ou um cliente sem navegador.

Cursor, VS Code e qualquer outro cliente MCP usam a configuração remota genérica:

{
  "mcpServers": {
    "snipzr": {
      "url": "https://mcp.snipzr.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Um cliente que só fala stdio pode fazer a ponte com npx mcp-remote https://mcp.snipzr.com/mcp --header "Authorization: Bearer YOUR_TOKEN".

3. Confirme que funcionou. Peça ao seu assistente para listar as ferramentas do Snipzr. Treze nomes começando com snipzr_ significa que você está conectado.

As treze ferramentas

Ferramenta	O que faz	Escopo
`snipzr_create_link`	Cria um link curto: destino, domínio opcional, back-half, título	`links:write`
`snipzr_create_links_batch`	Cria até 100 links curtos em uma única chamada	`links:write`
`snipzr_list_links`	Lista links com filtros de texto, domínio e campanha	`links:read`
`snipzr_get_link`	Lê um link pelo seu back-half	`links:read`
`snipzr_update_link`	Altera um destino ou título	`links:write`
`snipzr_delete_link`	Exclui um link, com uma etapa de confirmação	`links:write`
`snipzr_get_link_stats`	Cliques e escaneamentos por dia, bots contados separadamente	`stats:read`
`snipzr_get_campaign_report`	Cliques agrupados por campanha	`stats:read`
`snipzr_get_usage`	Plano, cota restante e data de renovação	`usage:read`
`snipzr_list_domains`	Seus domínios curtos e seu status	`domains:read`
`snipzr_get_qr_code`	Um QR code escaneável (PNG, JPEG ou SVG) com cores, legenda e logotipo, além de uma URL de download assinada	`links:read`
`snipzr_build_utm_link`	Compõe um link UTM que segue as convenções do seu workspace	`links:read`
`snipzr_list_workspaces`	Os workspaces em que esta conexão pode atuar, com os ids para passar como `workspaceId`	qualquer

Toda ferramenta carrega anotações somente leitura ou destrutivas, então clientes bem comportados pedem confirmação antes de uma exclusão e nunca antes de uma leitura, e toda ferramenta publica um esquema de saída e retorna conteúdo estruturado além do texto, para que agentes leiam campos em vez de interpretar prosa.

Modelo de acesso

Escopos restringem um token apenas ao que ele precisa: links:read, links:write, stats:read, usage:read, domains:read. Uma chamada fora dos escopos do token é recusada com uma mensagem que nomeia o escopo ausente.
Conexões atuam nos workspaces que você escolheu. Uma conexão por login alcança exatamente os workspaces que você marcou na tela de consentimento; um token de usuário alcança os escolhidos quando foi criado. Workspace pessoal por padrão. Para trabalhar em outro workspace concedido, o assistente passa seu id como argumento workspaceId de qualquer ferramenta (snipzr_list_workspaces os lista). O acesso segue sua associação ativa lá, verificada a cada chamada: saia de um workspace e o token perde o acesso instantaneamente; seja readicionado e ele retoma no seu novo papel.
Tokens de workspace são seu único workspace e recusam qualquer outro. Eles não estão vinculados a uma pessoa, então pessoas podem entrar e sair enquanto as automações continuam funcionando.
Recusas trazem códigos estáveis (SCOPE_REQUIRED, NOT_GRANTED, GRANT_INACTIVE, GRANT_REDUCED, PLAN_REQUIRED) para que um agente possa explicar e se autocorrigir.

Bom saber

Links que um agente cria contam para a mesma cota mensal que links criados manualmente por você, e as requisições compartilham o limite de taxa da API do plano. snipzr_get_usage relata ambos antes de trabalhos em massa.
QR codes retornam como uma imagem embutida mais uma URL de download assinada de curta duração, para que um agente possa salvar o arquivo sem empurrar bytes de imagem pelo modelo.
Revogar um token ou desconectar um aplicativo em Configurações corta o acesso do cliente imediatamente, e um aplicativo desconectado não pode se reconectar silenciosamente: ele precisa pedir novamente.
O servidor nunca registra seus destinos, e os analytics permanecem sem cookies.

Suporte

Perguntas e relatos de problemas são bem-vindos nas issues deste repositório, ou em support@snipzr.com. Nunca publique um segredo de token; se um vazar, revogue ou renove-o em Configurações primeiro.