# Conectar Claude y Codex con tu cuenta (MCP)

> Conecta Limecount a Claude o Codex con un inicio de sesión y gestiona claves de API, webs, estadísticas, embudos y exportaciones desde el chat.

Limecount tiene un servidor MCP con inicio de sesión: lo añades a Claude o a Codex, inicias sesión una vez en una ventana de Limecount y la IA trabaja sobre tu organización **sin que tengas que copiar ninguna clave**. Desde el chat puedes crear y revocar claves de API, dar de alta webs, consultar estadísticas, crear embudos y enlaces compartidos, exportar a CSV y cambiar los ajustes de una web.

La dirección es:

```text
https://api.limecount.com/mcp
```

> Esta conexión es distinta de la de [Instalar y gestionar la analítica con una IA](https://limecount.com/docs/usar-con-ia.md): aquella usa una clave de API que creas tú; esta usa tu cuenta (OAuth) y no necesita clave. Las dos llaman a la misma [API](https://limecount.com/docs/api.md), con los mismos límites del plan.

## Cómo funciona el inicio de sesión

1. Añades el servidor en tu cliente (ver abajo).
2. La primera vez, el cliente abre una ventana de `api.limecount.com` en tu navegador.
3. Entras con tu email y contraseña de Limecount (y el código de tu aplicación de autenticación si tienes la [verificación en dos pasos](https://limecount.com/docs/seguridad-de-la-cuenta.md)).
4. Eliges **organización** y **nivel de acceso** y pulsas **Autorizar**.
5. El navegador vuelve al cliente y la conexión queda lista.

La contraseña solo la ve Limecount, nunca el cliente de IA. El cliente recibe un token que caduca en una hora y se renueva solo; si alguien copiara un token de renovación ya usado, la conexión se corta.

### Niveles de acceso

| Nivel            | Qué puede hacer la IA                                                                  | Quién puede concederlo      |
| ---------------- | -------------------------------------------------------------------------------------- | --------------------------- |
| **Solo lectura** | Ver webs, ajustes, objetivos, embudos, anotaciones y estadísticas, y exportar a CSV.   | Cualquier rol               |
| **Gestión**      | Lo anterior y crear o editar webs, objetivos, embudos y anotaciones.                   | Propietario y administrador |
| **Completo**     | Lo anterior y crear o borrar enlaces compartidos y crear, ver y revocar claves de API. | Propietario y administrador |

El nivel se recorta con tu rol **en cada petición**: si te pasan a lectura o sales de la organización, la conexión pierde esos permisos al momento. Cada conexión es de **una organización**; para trabajar con varias, añade el servidor una vez por organización con nombres distintos (`limecount-agencia`, `limecount-cliente`).

## Claude Code

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

Después, dentro de Claude Code, escribe `/mcp`, elige `limecount` y pulsa **Authenticate**. Se abre el navegador para iniciar sesión.

Para que lo tengan todos los proyectos, añade `--scope user`. Para compartirlo con tu equipo en un repositorio, usa `--scope project` (se guarda en `.mcp.json`, sin ningún secreto: cada persona inicia sesión con su cuenta).

## Claude Desktop y claude.ai

1. Abre **Configuración → Conectores → Añadir conector personalizado**.
2. Nombre: `Limecount`. URL: `https://api.limecount.com/mcp`.
3. Pulsa **Conectar** e inicia sesión en la ventana de Limecount.

En planes de equipo o empresa, puede que el conector lo tenga que añadir un administrador de la organización de Claude.

## Codex (CLI y extensión)

```bash
codex mcp add limecount --url https://api.limecount.com/mcp
codex mcp login limecount
```

`codex mcp login` abre el navegador para iniciar sesión. El resultado en `~/.codex/config.toml` es:

```toml
[mcp_servers.limecount]
url = "https://api.limecount.com/mcp"
```

Si tu versión de Codex no ofrece `codex mcp login`, actualízala. Mientras tanto, o en un entorno sin navegador (CI, un servidor), usa una clave de API como en el apartado siguiente.

## Sin navegador: con una clave de API

En scripts, CI o servidores donde no se puede abrir una ventana, el mismo servidor acepta una [clave de API](https://limecount.com/docs/api.md) (`lck_...`) en lugar del inicio de sesión. La clave decide los permisos (ámbito y webs).

```bash
# Claude Code
claude mcp add --transport http limecount https://api.limecount.com/mcp \
  --header "Authorization: Bearer $LIMECOUNT_API_KEY"
```

```toml
# Codex: ~/.codex/config.toml (la clave se lee de la variable de entorno)
[mcp_servers.limecount]
url = "https://api.limecount.com/mcp"
bearer_token_env_var = "LIMECOUNT_API_KEY"
```

No pegues la clave en ficheros que subas a un repositorio.

## Qué puedes pedirle

- «Lista mis webs y dime cuál ha tenido más visitas este mes.»
- «Crea una clave de API de solo lectura, entorno `live`, para el script de informes, limitada a la web de la tienda.» La clave completa aparece **solo en esa respuesta**: guárdala entonces.
- «Revoca la clave del script antiguo.»
- «Crea un embudo "Compra" en la tienda: `/precios`, `/checkout*` y el evento `purchase`.»
- «Pon una anotación hoy: "lanzamiento de la campaña de otoño".»
- «Crea un enlace compartido con contraseña para el cliente que caduque a fin de mes.»
- «Exporta a CSV las estadísticas de los últimos 30 días.»
- «Cambia la zona horaria de la web a Europe/Madrid y excluye `/admin*`.»

Las acciones que borran algo (embudos, anotaciones, objetivos, enlaces, revocar claves) piden confirmación explícita: la IA debe preguntarte antes.

## Herramientas disponibles

| Área                | Herramientas                                                                                                                       |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Cuenta              | `get_account` (plan, permisos y lo que queda de cuota)                                                                             |
| Webs                | `list_sites`, `get_site`, `get_site_status`, `create_site`, `update_site`                                                          |
| Estadísticas        | `get_stats_overview`, `get_stats_timeseries`, `get_stats_breakdown`, `get_goals`, `get_funnels`, `compare_periods`, `export_stats` |
| Objetivos           | `list_goals`, `create_goal`, `delete_goal`                                                                                         |
| Embudos             | `list_funnels`, `create_funnel`, `delete_funnel`                                                                                   |
| Anotaciones         | `list_annotations`, `create_annotation`, `delete_annotation`                                                                       |
| Enlaces compartidos | `list_shares`, `create_share`, `delete_share`                                                                                      |
| Claves de API       | `list_api_keys`, `create_api_key`, `revoke_api_key`                                                                                |

La IA solo ve las herramientas de tu nivel. Cada una consume unidades de los límites por minuto y por día de tu plan, igual que la API.

## Desconectar

- Desde el cliente: en Claude Code, `claude mcp remove limecount`; en Claude Desktop o claude.ai, quita el conector; en Codex, `codex mcp logout limecount`.
- Desde Limecount: cambiar la contraseña no corta la conexión. Si crees que alguien tiene acceso a tu equipo, quita el conector en el cliente y, si eres administrador, revoca las claves que la IA haya creado desde **Ajustes de organización → Claves de API**.

## Problemas frecuentes

**«La autorización ha caducado o se abrió en otro navegador».** La ventana de inicio de sesión dura 15 minutos y debe terminarse en el mismo navegador en el que se abrió. Vuelve a conectar desde el cliente.

**«Con tu rol en esa organización solo puedes conceder acceso de lectura».** Eres lector en esa organización. Elige **Solo lectura** o pide a un administrador que te cambie el rol.

**La IA dice que no tiene permiso (`insufficient_scope`).** El nivel que concediste no incluye esa acción. Desconecta y vuelve a conectar eligiendo un nivel mayor.

**`trial_expired`.** La prueba de tu organización ha terminado: la conexión sigue respondiendo a `get_account`, pero el resto de herramientas necesita un [plan](https://limecount.com/docs/plan-y-facturacion.md).

**El cliente pide iniciar sesión otra vez.** Pasa si la conexión se ha revocado, si has salido de la organización o si no se ha usado en 60 días.
