Referencia del servidor MCP #

Revolink admite el Model Context Protocol (MCP): un estándar abierto que permite a los asistentes de IA (Claude, Cursor, Windsurf y otros) interactuar con servicios externos como herramientas.

Una vez configurado, tu asistente de IA puede crear enlaces, actualizar reglas de enrutamiento y consultar la analítica sin que tengas que salir del chat.

Endpoint #

POST https://api.revolink.link/apiv1/mcp

Transporte: Streamable HTTP (sin estado, una petición por cada llamada a una herramienta).

Autenticación #

MCP de Revolink admite dos formas de conectarse. Elige la que mejor encaje en tu caso:

Método 1: clave de API #

Genera una clave en Perfil → Integraciones, activa los permisos (scopes) de MCP que necesites y pásala en la configuración de tu cliente. Consulta Configuración más abajo para las instrucciones de cada cliente.

Errores:

Método 2: OAuth 2.0 #

Para clientes como claude.ai (web) que admiten OAuth: no hace falta clave. Apruebas el acceso una vez y el cliente se encarga de todo automáticamente.

Cómo conectar (claude.ai web):

1. Ve a Settings → Integrations en claude.ai.
2. Haz clic en Add MCP server.
3. Pega: https://api.revolink.link/apiv1/mcp
4. Haz clic en Connect: te redirigirá a Revolink para aprobar el acceso.
5. Listo. Las herramientas de Revolink ya están disponibles en tu chat.

Para revocar el acceso en cualquier momento: Perfil → Aplicaciones conectadas → Revocar.

Permisos de MCP #

Los permisos de MCP son independientes de los permisos normales de la API. Una clave puede tener acceso completo a la API pero ninguno a MCP, o al revés. Permisos (scopes) disponibles:

Con autenticación por clave de API, los permisos se configuran por clave en Perfil → Integraciones → MCP dentro de la aplicación.

Con OAuth, los permisos los solicita el cliente y los aprueba el usuario durante el flujo de consentimiento.

Configuración #

Clave de API: paso a paso #

1. Ve a Perfil → Integraciones en la aplicación de Revolink.
2. Haz clic en Crear clave de API.
3. Ponle un nombre a la clave (p. ej. Claude MCP).
4. En MCP, activa los permisos que quieras conceder. Cada permiso se puede activar de forma independiente.
5. Haz clic en Crear y copia la clave: se muestra una sola vez.

Una clave con MCP activado pero sin permisos de MCP seleccionados será rechazada en el endpoint de MCP con un error 403.

Configura tu cliente de IA (clave de API) #

{
  "mcpServers": {
    "revolink": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.revolink.link/apiv1/mcp",
        "--header",
        "X-Api-Key:YOUR_API_KEY"
      ]
    }
  }
}

claude mcp add --transport http revolink https://api.revolink.link/apiv1/mcp \
  --header "X-Api-Key: YOUR_API_KEY"

{
  "mcpServers": {
    "revolink": {
      "type": "http",
      "url": "https://api.revolink.link/apiv1/mcp",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "revolink": {
      "url": "https://api.revolink.link/apiv1/mcp",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

{
  "servers": {
    "revolink": {
      "type": "http",
      "url": "https://api.revolink.link/apiv1/mcp",
      "headers": {
        "X-Api-Key": "${input:revolinkApiKey}"
      }
    }
  },
  "inputs": [
    {
      "id": "revolinkApiKey",
      "type": "promptString",
      "description": "Revolink API Key",
      "password": true
    }
  ]
}

{
  "context_servers": {
    "revolink": {
      "settings": {
        "url": "https://api.revolink.link/apiv1/mcp",
        "api_key": "YOUR_API_KEY"
      }
    }
  }
}

Configura tu cliente de IA (OAuth) #

https://api.revolink.link/apiv1/mcp

Espacios de trabajo: selección automática #

Nunca necesitas indicar un ID de espacio de trabajo a mano. Cuando envías una petición sin elegir un espacio de trabajo, el servidor devuelve la lista de tus espacios de trabajo disponibles. La IA elige el adecuado según el contexto y continúa la operación automáticamente. Desde tu punto de vista es invisible: solo describe lo que necesitas con lenguaje natural.

Herramientas disponibles #

list_links #

Devuelve una lista paginada de los enlaces de un espacio de trabajo.

Permiso necesario: links:read

get_link #

Devuelve todos los detalles de un enlace, incluidas sus reglas de enrutamiento.

Permiso necesario: links:read

create_link #

Crea un enlace inteligente nuevo con reglas de enrutamiento.

Permiso necesario: links:write

Ejemplo de petición:

«Crea un enlace llamado "Product Hunt Launch" que envíe a los visitantes de escritorio a la landing de escritorio y a los visitantes móviles a la landing móvil.»

update_link #

Actualiza un enlace existente. Incluye solo los campos que quieras cambiar.

Permiso necesario: links:write

Los mismos parámetros que create_link, además de:

Cuando se indica rules, todo el array de reglas se sustituye. Incluye todas las reglas que quieras conservar, no solo las modificadas. La IA obtiene internamente los ID de las reglas existentes antes de actualizar.

delete_link #

Elimina un enlace de forma permanente.

Permiso necesario: links:delete

bulk_create_links #

Crea varios enlaces en una sola petición. Sujeto a la cuota de enlaces del plan.

Permiso necesario: links:bulk

La respuesta incluye los arrays created (correctos) y failed (fallidos, con el motivo), por lo que es posible un éxito parcial.

get_link_analytics #

Devuelve la analítica de clics de un enlace, desglosada por país, dispositivo, navegador, sistema operativo, regla de enrutamiento y variante A/B.

Permiso necesario: analytics:read

get_workspace_analytics #

Devuelve la analítica de clics agregada de todos los enlaces de un espacio de trabajo.

Permiso necesario: analytics:read

Objeto de regla #

Todo enlace debe tener al menos una regla. Exactamente una regla debe tener isDefault: true: es el respaldo cuando no se cumplen las condiciones de ninguna otra regla. La regla predeterminada no puede tener ninguna condición.

Objeto de prueba A/B #

Cuando abTest.enabled es true, los clics se reparten entre las variantes según sus pesos. Las reglas de enrutamiento se siguen aplicando primero: el reparto A/B solo ocurre para los visitantes que coinciden con una regla determinada.

Variante:

Gestión de errores #

El servidor MCP devuelve errores JSON-RPC estándar. Los errores a nivel de herramienta usan estos códigos:

Errores a nivel HTTP (antes de llamar a la herramienta):

Ejemplos de llamadas a herramientas #

Lista tus enlaces:

«Muéstrame todos los enlaces de mi espacio de trabajo con la etiqueta summer-sale.»

Crea un enlace con segmentación geográfica:

«Crea un enlace llamado "App Download". Envía a los usuarios de iOS a la App Store, a los de Android a Google Play y a todos los demás al sitio web.»

Actualiza las reglas de enrutamiento:

«Actualiza el enlace 664a1b2c…: añade una regla que redirija a los visitantes de Alemania a https://de.example.com.»

Obtén la analítica de la semana pasada:

«¿Cuáles fueron los países principales del enlace 664a1b2c… la semana pasada?»