limecountDocumentaciónVolver al panel

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

  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).
  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

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)

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 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.

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.