Snipzr

Crea, gestiona y mide enlaces cortos en tu propio dominio desde Claude, ChatGPT, Cursor o VS Code.

Servidor MCP alojado

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

Se instala en Claude Code, Codex, Cursor y más

Documentación

Servidor MCP de Snipzr

El servidor MCP oficial de Snipzr. Un único endpoint alojado ofrece a cualquier cliente MCP trece herramientas para crear, gestionar y medir enlaces cortos: dominios personalizados, creación por lotes, analíticas sin cookies, informes de campañas, generación de UTM y códigos QR.

https://mcp.snipzr.com/mcp

No hay nada que instalar ni ejecutar. El servidor es remoto (HTTP Streamable), sin estado y está disponible en todos los planes de pago de Snipzr. Este repositorio es su hogar público: configuración, referencia de herramientas y metadatos de registro. El servidor en sí es parte de la plataforma Snipzr, y sus herramientas son adaptadores ligeros sobre los mismos manejadores que sirven la API REST pública, por lo que ambas superficies siempre se comportan de manera idéntica.

Inicio rápido

1. Conéctate con inicio de sesión (recomendado). La mayoría de los clientes no necesitan ningún token: apúntalos a la dirección del servidor y abrirán un inicio de sesión de Snipzr. La pantalla de consentimiento muestra exactamente qué permisos recibe la aplicación y en cuáles de tus espacios de trabajo puede actuar; desmarca lo que no quieras y desconéctalo más tarde desde Configuración.

Claude Code, dos comandos:

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

Claude en la web, escritorio y móvil: abre Configuración, luego Conectores, luego Añadir conector personalizado, introduce la dirección del servidor y selecciona Conectar. ChatGPT se conecta de la misma manera en modo desarrollador. Smithery, Glama y otros directorios se conectan a través del mismo inicio de sesión.

2. O usa un token. En Configuración, crea un token y copia el secreto (se muestra solo una vez):

  • Los tokens de API de usuario actúan como tú. Elige los espacios de trabajo en los que el token puede actuar y qué puede hacer en cada uno.
  • Los tokens de API de espacio de trabajo pertenecen a un espacio de trabajo y actúan como ese espacio de trabajo. La opción correcta para un asistente de equipo compartido o un cliente sin navegador.

Cursor, VS Code y cualquier otro cliente MCP aceptan la configuración remota genérica:

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

Un cliente que solo hable stdio puede hacer un puente con npx mcp-remote https://mcp.snipzr.com/mcp --header "Authorization: Bearer YOUR_TOKEN".

3. Confirma que funcionó. Pide a tu asistente que liste las herramientas de Snipzr. Trece nombres que empiezan con snipzr_ significa que estás conectado.

Las trece herramientas

HerramientaQué haceAlcance
snipzr_create_linkCrear un enlace corto: destino, dominio opcional, parte final, títulolinks:write
snipzr_create_links_batchCrear hasta 100 enlaces cortos en una sola llamadalinks:write
snipzr_list_linksListar enlaces con filtros de texto, dominio y campañalinks:read
snipzr_get_linkLeer un enlace por su parte finallinks:read
snipzr_update_linkCambiar un destino o títulolinks:write
snipzr_delete_linkEliminar un enlace, con una puerta de confirmaciónlinks:write
snipzr_get_link_statsClics y escaneos por día, los bots se cuentan por separadostats:read
snipzr_get_campaign_reportClics agrupados por campañastats:read
snipzr_get_usagePlan, asignación restante y fecha de reiniciousage:read
snipzr_list_domainsTus dominios cortos y su estadodomains:read
snipzr_get_qr_codeUn código QR escaneable (PNG, JPEG o SVG) con colores, un pie de foto y un logotipo, además de una URL de descarga firmadalinks:read
snipzr_build_utm_linkComponer un enlace UTM que sigue las convenciones de tu espacio de trabajolinks:read
snipzr_list_workspacesLos espacios de trabajo en los que esta conexión puede actuar, con los ids para pasar como workspaceIdcualquiera

Cada herramienta lleva anotaciones de solo lectura o destructivas, por lo que los clientes bien comportados piden antes de eliminar y nunca antes de leer, y cada herramienta publica un esquema de salida y devuelve contenido estructurado junto al texto, para que los agentes lean campos en lugar de analizar prosa.

Modelo de acceso

  • Los alcances limitan un token a solo lo que necesita: links:read, links:write, stats:read, usage:read, domains:read. Una llamada fuera de los alcances del token se rechaza con un mensaje que nombra el alcance faltante.
  • Las conexiones actúan en los espacios de trabajo que elegiste. Una conexión con inicio de sesión alcanza exactamente los espacios de trabajo que marcaste en la pantalla de consentimiento; un token de usuario alcanza los que se eligieron al crearlo. Espacio de trabajo personal por defecto. Para trabajar en otro espacio de trabajo concedido, el asistente pasa su id como argumento workspaceId de cualquier herramienta (snipzr_list_workspaces los lista). El acceso sigue tu membresía activa allí, verificada en cada llamada: sal de un espacio de trabajo y el token lo pierde al instante; vuelve a ser añadido y se reanuda con tu nuevo rol.
  • Los tokens de espacio de trabajo son su único espacio de trabajo y rechazan cualquier otro. No están vinculados a una persona, por lo que la gente puede ir y venir mientras las automatizaciones siguen funcionando.
  • Los rechazos llevan códigos estables (SCOPE_REQUIRED, NOT_GRANTED, GRANT_INACTIVE, GRANT_REDUCED, PLAN_REQUIRED) para que un agente pueda explicar y autocorregirse.

Bueno saber

  • Los enlaces que crea un agente cuentan para la misma asignación mensual que los enlaces que creas a mano, y las solicitudes comparten el límite de tasa de API del plan. snipzr_get_usage informa de ambos antes del trabajo masivo.
  • Los códigos QR se devuelven como una imagen en línea más una URL de descarga firmada de corta duración, para que un agente pueda guardar el archivo sin enviar bytes de imagen a través del modelo.
  • Revocar un token o desconectar una aplicación en Configuración corta al cliente de inmediato, y una aplicación desconectada no puede reconectarse silenciosamente: tiene que pedírtelo de nuevo.
  • El servidor nunca registra tus destinos, y las analíticas permanecen sin cookies.

Enlaces

Soporte

Las preguntas e informes de problemas son bienvenidos en los issues de este repositorio, o en support@snipzr.com. Por favor, nunca publiques un secreto de token; si se filtra, revócalo o cámbialo primero en Configuración.