# Instalar Limecount con una IA

> Pide a Claude Code, Cursor u otra IA que instale Limecount en tu web o consulte tus estadísticas. Conecta el servidor MCP o usa llms.txt, con prompts listos.

Si programas con un asistente de IA (Claude Code, Cursor, Claude Desktop, VS Code con Copilot…), puede instalar y configurar Limecount por ti. Para que no invente atributos, Limecount publica su documentación en un formato pensado para IA: un servidor MCP y los ficheros `llms.txt` y `llms-full.txt`.

> Las herramientas de **documentación** del servidor MCP son públicas: no necesitan cuenta ni clave. Las de **estadísticas** son opcionales y solo funcionan si añades una [clave de API](https://limecount.com/docs/api.md) de solo lectura al conectar; sin ella, el servidor no accede a tus estadísticas ni a tu panel, y nunca a datos de visitantes individuales.

## Antes de empezar

Crea tu web en Limecount y copia su **clave pública** (empieza por `lc_`) desde **Webs → tu web → Instalar**. Es pública: va en el HTML de tu web, así que puedes pegarla en el chat con la IA sin riesgo. Si no la tienes aún, la IA instalará el código con un marcador y te dirá dónde cambiarlo.

## Opción 1: servidor MCP (recomendada)

La dirección del servidor es `https://limecount.com/mcp` (protocolo MCP sobre HTTP). Para instalar Limecount con ayuda de la IA no hace falta autenticación; para consultar tus estadísticas, añade la clave como se explica [más abajo](#consultar-tus-estadisticas-con-la-ia).

### Claude Code

Ejecuta una vez en tu terminal:

```bash
claude mcp add --transport http limecount https://limecount.com/mcp
```

### Claude Desktop y Claude.ai

Abre **Configuración → Conectores → Añadir conector personalizado**, pon el nombre `Limecount` y la dirección `https://limecount.com/mcp`. No hace falta iniciar sesión.

### Cursor

Crea o edita `.cursor/mcp.json` en tu proyecto (o el global `~/.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "limecount": {
      "url": "https://limecount.com/mcp"
    }
  }
}
```

### VS Code

Crea o edita `.vscode/mcp.json`:

```json
{
  "servers": {
    "limecount": {
      "type": "http",
      "url": "https://limecount.com/mcp"
    }
  }
}
```

### Qué herramientas ofrece

| Herramienta           | Para qué sirve                                                                                  |
| --------------------- | ----------------------------------------------------------------------------------------------- |
| `get_install_snippet` | El código exacto de instalación y los pasos para tu framework, con cómo comprobar que funciona. |
| `list_docs`           | Lista las páginas de la documentación.                                                          |
| `get_doc`             | Devuelve una página completa en Markdown.                                                       |
| `search_docs`         | Busca en la documentación y devuelve fragmentos.                                                |
| `get_event_guide`     | Cómo enviar eventos, objetivos y embudos.                                                       |

Para consultar tus estadísticas están las herramientas de la sección [Consultar tus estadísticas con la IA](#consultar-tus-estadisticas-con-la-ia).

`get_install_snippet` conoce HTML, Next.js, React, Vue, Angular, Astro, Nuxt, Svelte, WordPress y Google Tag Manager.

## Consultar tus estadísticas con la IA

Con una clave de la [API de estadísticas](https://limecount.com/docs/api.md), tu asistente puede responder preguntas como «¿cuántas visitas tuve el último trimestre?» o «¿qué páginas traen más tráfico desde Google?». Las herramientas reenvían la petición a la API de Limecount con tu clave, y solo devuelven datos agregados.

> La clave da **acceso de lectura a las estadísticas** de las webs que elijas. Guárdala como una contraseña: no la subas a un repositorio ni la pegues en un chat. Puedes limitarla a algunas webs y revocarla en cualquier momento desde **Ajustes de organización → Claves de API**. Limecount no guarda ni registra la clave que envía tu cliente MCP.

### 1. Crea la clave

En **Ajustes de organización → Claves de API** (solo propietarios y administradores), pulsa **Crear clave** y cópiala: empieza por `lck_` y no se vuelve a mostrar.

### 2. Pásala en la cabecera Authorization

En Claude Code:

```bash
claude mcp add --transport http limecount https://limecount.com/mcp --header "Authorization: Bearer lck_..."
```

En Cursor (`.cursor/mcp.json`, mejor el global `~/.cursor/mcp.json` para no subir la clave al repositorio):

```json
{
  "mcpServers": {
    "limecount": {
      "url": "https://limecount.com/mcp",
      "headers": {
        "Authorization": "Bearer lck_..."
      }
    }
  }
}
```

En VS Code (`.vscode/mcp.json`; con `inputs` y `password: true` VS Code te pide la clave y no queda escrita en el fichero):

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "limecount-key",
      "description": "Clave de API de Limecount",
      "password": true
    }
  ],
  "servers": {
    "limecount": {
      "type": "http",
      "url": "https://limecount.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:limecount-key}"
      }
    }
  }
}
```

Los conectores personalizados de Claude Desktop y Claude.ai no admiten, por ahora, cabeceras propias: para consultar estadísticas usa Claude Code, Cursor, VS Code u otro cliente que admita `headers`.

### Herramientas de estadísticas

| Herramienta            | Para qué sirve                                                                                                    |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `list_sites`           | Lista tus webs y su `id`. La IA la usa primero.                                                                   |
| `get_stats_overview`   | Totales del periodo (visitas, páginas vistas, eventos…), con comparación opcional.                                |
| `get_stats_timeseries` | Evolución por hora, día, semana, mes o trimestre.                                                                 |
| `get_stats_breakdown`  | Ranking por página, fuente, país, dispositivo, evento y el resto de [dimensiones](https://limecount.com/docs/api.md#get-stats-breakdown). |
| `get_goals`            | Objetivos con conversiones y tasa.                                                                                |
| `get_funnels`          | Embudos con sus pasos.                                                                                            |

Admiten el periodo (`today`, `7d`, `30d`, `month`, `lastMonth`, `90d`, `12m`, `year`) o un rango `from`/`to`, y los mismos filtros que el panel. Si falta la clave, la herramienta devuelve un error que explica cómo crearla y configurarla; si la clave no es válida o se supera el límite de 60 peticiones por minuto, devuelve el mensaje de la API.

Un prompt de ejemplo: «Con Limecount, dime las visitas por trimestre del último año de midominio.com y qué tres páginas crecieron más».

## Opción 2: llms.txt si tu herramienta no admite MCP

Si tu asistente no soporta MCP, dale una de estas direcciones o pégalas en el chat:

- [llms.txt](https://limecount.com/llms.txt): índice de la documentación con enlaces y una descripción de cada página.
- [llms-full.txt](https://limecount.com/llms-full.txt): toda la documentación en un solo fichero Markdown.
- Cualquier página en Markdown: añade `.md` a su dirección, por ejemplo [`/docs/instalacion.md`](https://limecount.com/docs/instalacion.md).

## Un prompt para copiar

Cambia la clave y el dominio por los tuyos. Si todavía no tienes clave, borra esa frase y la IA te indicará dónde ponerla.

```text
Instala Limecount (analítica web sin cookies) en este proyecto.
Mi clave pública es lc_XXXXXXXXXXXXXXXXXXXX y el dominio de la web es midominio.com.
Usa el servidor MCP de Limecount (get_install_snippet) para obtener el código exacto;
si no puedes usar MCP, lee https://limecount.com/llms.txt.
Detecta el framework del proyecto, coloca la etiqueta <script> en la cabecera de todas
las páginas y no añadas ninguna librería ni cookies. No inventes atributos.
Al terminar, dime cómo comprobar que funciona.
```

## Comprueba el resultado

Despliega tu web y ábrela en otra pestaña. La pantalla de instalación del panel pasa a **recibido** en cuanto llega la primera visita. Si no llega, revisa la [comprobación de la instalación](https://limecount.com/docs/comprobar.md). Para probar en local, la IA puede añadir `data-local="1"` a la etiqueta (quítalo en producción).

Más información sobre el código: [instalar Limecount](https://limecount.com/docs/instalacion.md) y [modos de medición y consentimiento](https://limecount.com/docs/modos-de-medicion.md).
