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
| Herramienta | Qué hace | Alcance |
|---|---|---|
snipzr_create_link | Crear un enlace corto: destino, dominio opcional, parte final, título | links:write |
snipzr_create_links_batch | Crear hasta 100 enlaces cortos en una sola llamada | links:write |
snipzr_list_links | Listar enlaces con filtros de texto, dominio y campaña | links:read |
snipzr_get_link | Leer un enlace por su parte final | links:read |
snipzr_update_link | Cambiar un destino o título | links:write |
snipzr_delete_link | Eliminar un enlace, con una puerta de confirmación | links:write |
snipzr_get_link_stats | Clics y escaneos por día, los bots se cuentan por separado | stats:read |
snipzr_get_campaign_report | Clics agrupados por campaña | stats:read |
snipzr_get_usage | Plan, asignación restante y fecha de reinicio | usage:read |
snipzr_list_domains | Tus dominios cortos y su estado | domains:read |
snipzr_get_qr_code | Un código QR escaneable (PNG, JPEG o SVG) con colores, un pie de foto y un logotipo, además de una URL de descarga firmada | links:read |
snipzr_build_utm_link | Componer un enlace UTM que sigue las convenciones de tu espacio de trabajo | links:read |
snipzr_list_workspaces | Los espacios de trabajo en los que esta conexión puede actuar, con los ids para pasar como workspaceId | cualquiera |
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
workspaceIdde cualquier herramienta (snipzr_list_workspaceslos 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_usageinforma 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
- Configuración con detalles por cliente: snipzr.com/integrations/mcp
- Guía de documentación: Conecta tu IA con MCP
- Referencia de la API REST: snipzr.com/docs/api
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.