DocumentaciónEmpezarConectar Claude y Codex con tu cuenta (MCP)
Empezar
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:
https://api.limecount.com/mcp
Esta conexión es distinta de la de Instalar y gestionar la analítica con una IA: 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, con los mismos límites del plan.
Cómo funciona el inicio de sesión
- Añades el servidor en tu cliente (ver abajo).
- La primera vez, el cliente abre una ventana de
api.limecount.comen tu navegador. - 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).
- Eliges organización y nivel de acceso y pulsas Autorizar.
- 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
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
- Abre Configuración → Conectores → Añadir conector personalizado.
- Nombre:
Limecount. URL:https://api.limecount.com/mcp. - 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)
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:
[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 (lck_...) en lugar del inicio de sesión. La clave decide los permisos (ámbito y webs).
# Claude Code
claude mcp add --transport http limecount https://api.limecount.com/mcp \
--header "Authorization: Bearer $LIMECOUNT_API_KEY"
# 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 eventopurchase.» - «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.
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.