¿Qué es el servidor MCP de Chaterimo?

El servidor MCP de Chaterimo expone 19 herramientas a través del Model Context Protocol, permitiendo que Claude AI lea y actualice los datos de tu chatbot en tiempo real — incluyendo conversaciones, análisis, productos, leads, tickets y configuración del chatbot.

¿Necesito un desarrollador para configurar la integración MCP?

No. El flujo OAuth de Claude Desktop solo requiere un inicio de sesión en Chaterimo — no se necesita programación. Pega la URL del endpoint en la configuración de Claude Desktop, autoriza mediante OAuth y ya estás conectado.

¿Qué puede leer Claude de mi cuenta Chaterimo mediante MCP?

Conversaciones, análisis, productos, leads, tickets, reglas de ventas, estadísticas del panel y la configuración completa del chatbot incluyendo el modelo de IA, el prompt del sistema y la apariencia del widget.

¿Puede Claude cambiar la configuración de mi chatbot mediante MCP?

Sí, utilizando el endpoint de acceso completo. Claude puede actualizar instrucciones, el modelo de IA, el idioma, los colores del widget y los mensajes, y activar el reentrenamiento. Usa el endpoint de solo lectura (/mcp-readonly/) para evitar escrituras.

¿Es segura la conexión MCP?

Sí. Las conexiones OAuth utilizan tokens de corta duración. Las conexiones mediante clave API usan tu clave cha_xxx — trátala como una contraseña y usa claves de solo lectura para accesos compartidos.

Chaterimo MCP Server: Conecta Claude AI a Tu Chatbot (2026)

Por David Langr • Actualizado el 2026-05-04 • 10 min de lectura

Usa Claude Desktop o Claude Code para leer conversaciones, revisar análisis, actualizar instrucciones de IA y gestionar el widget de tu chatbot — directamente desde Claude.

Clúster de API de desarrollador

Ver también: Atención al cliente con IA en Shopify · Mejor chatbot de IA para Shopify

Qué es MCP y por qué importa para el e-commerce

MCP son las siglas de Model Context Protocol — un estándar abierto que permite a Claude AI conectarse a herramientas externas y leer datos en vivo de tus sistemas en tiempo real. En lugar de copiar una transcripción de conversación de Chaterimo y pegarla en Claude para analizarla, le preguntas directamente a Claude: "¿Cuáles son las principales quejas de mi chatbot esta semana?" Claude llama a las herramientas MCP de Chaterimo, obtiene los datos y responde de inmediato.

Para los equipos de e-commerce, esto cambia la forma de interactuar con los datos de tu chatbot. Ya no necesitas iniciar sesión en un panel para consultar análisis, leer un ticket o actualizar tus instrucciones de IA. Lo haces dentro de una conversación con Claude usando lenguaje natural.

El servidor MCP de Chaterimo expone 19 herramientas que abarcan chatbots, conversaciones, productos, tickets, leads y análisis. Doce son de solo lectura; siete permiten escrituras. Tú eliges qué nivel de acceso otorgar a Claude según cómo te conectes.

      Qué puedes hacer con Chaterimo + Claude mediante MCP
      Pedir a Claude que resuma las quejas recientes de los clientes de tu chatbot
Hacer que Claude reescriba tu prompt del sistema de IA con un estilo más conciso
Consultar tendencias de análisis de los últimos 30 días sin abrir un panel
Buscar en tu catálogo de productos e inspeccionar patrones de tickets en una sola conversación
Cambiar el modelo de IA de tu chatbot o la configuración de idioma con una sola instrucción

    

Dos formas de conectarse: Claude Desktop (OAuth) vs Claude Code CLI

Chaterimo admite dos métodos de conexión. El adecuado depende de quién se conecta y cómo trabaja.

OAuth / Claude Desktop — sin token requerido

Los endpoints OAuth utilizan el flujo de autorización MCP estándar. Pegas una URL en Claude Desktop, autorizas con tu cuenta de Chaterimo y Claude obtiene un token de acceso de corta duración automáticamente. No hay clave API que gestionar ni archivos de configuración que editar.

Acceso completo (lectura + escritura): https://www.chaterimo.com/mcp/
Solo lectura (seguro para compartir): https://www.chaterimo.com/mcp-readonly/

Ideal para: propietarios de negocios, especialistas en marketing, gestores de soporte — cualquiera que use Claude Desktop y quiera consultar o gestionar su chatbot sin escribir código.

Clave API / Claude Code CLI — transporte stdio

La integración CLI utiliza FastMCP sobre stdio. Proporcionas tu clave API de Chaterimo (cha_xxx), disponible en el panel de Developer API, y Claude Code se conecta directamente al proceso del servidor MCP.

Ideal para: desarrolladores que usan Claude Code en la terminal y quieren acceso programático integrado en su flujo de trabajo.

URLs con token heredadas: Un tercer método de conexión — URL directa con token integrado — está disponible para integraciones avanzadas y pipelines de automatización. Contacta con soporte si necesitas este formato.

12 cosas que puedes leer desde Claude (herramientas de solo lectura)

Todas las siguientes herramientas están disponibles tanto en el endpoint de acceso completo como en el de solo lectura. Ofrecen a Claude una vista completa de tu cuenta Chaterimo sin modificar nada.

list_chatbots read

Lista todos los chatbots de tu organización con sus IDs, nombres y modelo de IA actual.

get_chatbot read

Configuración completa del chatbot: modelo de IA, prompt del sistema, temperatura, colores del widget, etiquetas de botones y todos los ajustes de apariencia.

list_conversations read

Filtra conversaciones por chatbot, rango de fechas y plataforma (web, WhatsApp, Facebook Messenger).

get_conversation read

Transcripción completa de la conversación con todos los mensajes, marcas de tiempo y metadatos del visitante. Admite paginación para sesiones largas.

search_products read

Busca en tu catálogo de productos sincronizado por palabra clave — la misma búsqueda híbrida que usa tu chatbot para responder preguntas sobre productos.

list_products read

Explora todos los productos sincronizados desde tu plataforma de e-commerce, incluyendo precio, descripción y disponibilidad.

list_tickets read

Filtra tickets de soporte por estado: new, in_progress, resolved o closed. Útil para detectar patrones de problemas abiertos.

get_ticket read

Detalles completos del ticket incluyendo hilo, historial de estado, agente asignado y conversación vinculada.

list_leads read

Todos los leads de visitantes capturados por el widget de chat — email, nombre, fecha de captura y chatbot de origen.

get_analytics read

Métricas de rendimiento del chatbot para cualquier período de hasta 365 días: número de sesiones, volumen de mensajes, desglose por plataforma y tasas de respuesta.

list_sales_rules read

Visualiza todas las reglas activas del agente de ventas — los disparadores y mensajes que usa tu widget de ventas proactivo para captar visitantes.

get_dashboard read

Resumen del panel: sesiones totales, chatbots activos, desglose por plataforma y resumen de actividad reciente.

7 acciones que Claude puede realizar en tu chatbot (herramientas de escritura)

Las herramientas de escritura solo están disponibles en el endpoint de acceso completo (/mcp/). Permiten que Claude realice cambios reales en la configuración de tu chatbot — útil cuando quieres actualizar tu configuración desde dentro de una conversación con Claude sin cambiar de pestaña.

update_chatbot_instructions write

Reescribe el prompt del sistema de IA (máx. 15.000 caracteres). Longitud recomendada: 15–40 líneas para mejores resultados. Los cambios surten efecto de inmediato.

update_chatbot_model write

Cambia el modelo de IA (GPT-4o, Claude Sonnet, Gemini Flash y otros) y ajusta la temperatura entre 0.1 y 1.0.

update_chatbot_language write

Establece un idioma de respuesta fijo o elige "Automático" para detectar el idioma de cada visitante y responder en consecuencia.

update_chatbot_settings write

Actualiza el nombre y la descripción del chatbot, habilita o deshabilita el widget, y ajusta la rigurosidad del comportamiento (con qué exactitud sigue las fuentes de la base de conocimiento).

update_widget_appearance write

Configura los colores del widget usando códigos hex, cambia la posición (izquierda, centro, derecha) y ajusta el estilo de la burbuja para que coincida con tu marca.

update_widget_messages write

Edita el mensaje de bienvenida, el texto del marcador de posición del campo de entrada, la etiqueta de la animación "pensando" y la etiqueta del botón de envío — todo visible para tus visitantes.

retrain_chatbot write

Activa un trabajo completo de reentrenamiento de la base de conocimiento. El chatbot reindexará todas las fuentes conectadas: productos, documentos y contenido personalizado.

Paso a paso: configuración de Claude Desktop (OAuth)

Esta es la forma más rápida de conectarse para quienes no son desarrolladores. Sin archivos de configuración, sin claves API — solo un flujo OAuth.

Abre Claude Desktop y ve a Configuración → Integraciones (también aparece como "Servidores MCP" en algunas versiones de la aplicación).
Haz clic en "Agregar servidor MCP" y pega una de las siguientes URLs:
- Acceso completo (lectura + escritura): https://www.chaterimo.com/mcp/
- Solo lectura: https://www.chaterimo.com/mcp-readonly/
Claude Desktop abre una página de autorización OAuth en tu navegador. Inicia sesión en tu cuenta Chaterimo y haz clic en Autorizar. Claude recibe un token de corta duración automáticamente — no lo ves ni lo almacenas.
Claude Desktop ahora muestra "Chaterimo" en tu lista de herramientas con un indicador verde de conexión activa. Las 19 herramientas (o las 12 de solo lectura) ya están disponibles.
Inicia una nueva conversación y prueba: "Lista mis chatbots" o "¿Cuáles son mis análisis de los últimos 7 días?" Claude llamará a las herramientas MCP y devolverá una respuesta formateada.

Cuándo usar el endpoint de solo lectura

Usa /mcp-readonly/ si quieres dar a Claude acceso a tus datos — conversaciones, análisis, tickets — sin permitirle cambiar ninguna configuración del chatbot. Esta es la opción correcta para miembros del equipo o analistas que deben poder consultar datos pero no modificar la configuración de tu chatbot en producción.

Paso a paso: configuración de Claude Code CLI

Para desarrolladores que usan Claude Code en la terminal, el servidor MCP se ejecuta como un proceso local a través del transporte stdio. Necesitas tu clave API de Chaterimo del panel de Developer API.

Obtén tu clave API: Inicia sesión en Chaterimo → Developer API → Claves API → Crear nueva clave. La clave comienza con cha_.

Añade lo siguiente a tu archivo .claude/settings.json (o claude_desktop_config.json en modo CLI de Claude Desktop):

// .claude/settings.json or claude_desktop_config.json
{
  "mcpServers": {
    "chaterimo": {
      "command": "python",
      "args": ["-m", "developer_api.mcp_server"],
      "env": {
        "CHATERIMO_API_KEY": "cha_your_key_here"
      }
    }
  }
}

O ejecuta el servidor directamente en una sesión de terminal para pruebas rápidas:

# Set your key and start the MCP server process
CHATERIMO_API_KEY=cha_xxx python -m developer_api.mcp_server

Una vez conectado, Claude Code puede llamar a cualquiera de las 19 herramientas de Chaterimo durante una sesión. Verás la salida de las llamadas a herramientas en línea mientras Claude obtiene datos de tu cuenta.

Mantén tu clave API privada

Tu clave cha_xxx otorga el mismo nivel de acceso que tu inicio de sesión en Chaterimo para operaciones API. No la incluyas en sistemas de control de versiones. Para entornos compartidos o contextos de equipo donde no quieres acceso de escritura, crea una clave API de solo lectura separada desde el panel de Developer API y úsala en su lugar.

Ejemplos de casos de uso reales

Aquí tienes cinco prompts concretos de Claude que muestran cómo se ve la integración MCP en la práctica. Cada prompt activa herramientas específicas de Chaterimo automáticamente.

"Lista todos mis chatbots y dime cuál tiene más conversaciones este mes."
Claude llama a list_chatbots para obtener los IDs de tus chatbots, luego llama a get_analytics para cada uno con un rango de 30 días. Compara el número de sesiones y devuelve un resumen ordenado con el mejor destacado.
"Muéstrame las últimas 10 conversaciones donde un cliente mencionó 'devolución'."
Claude llama a list_conversations para paginar sesiones recientes, luego llama a get_conversation en los candidatos. Filtra las transcripciones por la palabra clave y presenta fragmentos con marcas de tiempo y nombres de chatbot.
"Reescribe las instrucciones del chatbot #3 para que sean más concisas y amigables."
Claude llama a get_chatbot para leer el prompt del sistema actual, propone una versión revisada en la conversación para tu revisión y luego llama a update_chatbot_instructions para aplicarla tras tu confirmación.
"Cambia mi chatbot principal a GPT-4o con temperatura 0.3."
Claude llama a list_chatbots para identificar qué chatbot está marcado como principal, luego llama a update_chatbot_model con el modelo objetivo y el valor de temperatura. El cambio surte efecto de inmediato.
"¿Cuáles son mis principales tickets de soporte ahora mismo y qué patrones detectas?"
Claude llama a list_tickets filtrado por estado new e in_progress, luego llama a get_ticket para cada elemento abierto. Agrupa los tickets por tema, identifica problemas recurrentes y resume los problemas más comunes de los clientes en un informe estructurado.

Solo lectura vs acceso completo: ¿cuál deberías usar?

La elección correcta depende de tu rol y de cuánto quieres que Claude pueda cambiar. En caso de duda, empieza con solo lectura y actualiza cuando lo necesites.

	Solo lectura	Acceso completo
Ver conversaciones, análisis, leads	Sí	Sí
Leer configuración del chatbot y productos	Sí	Sí
Actualizar instrucciones del chatbot	No	Sí
Cambiar modelo de IA o idioma	No	Sí
Modificar apariencia del widget	No	Sí
Activar reentrenamiento	No	Sí
Endpoint (OAuth)	`/mcp-readonly/`	`/mcp/`
Ideal para	Analistas, miembros del equipo	Propietarios, desarrolladores

Límites de uso por plan

Las llamadas a herramientas MCP cuentan contra tu cuota de Developer API. Cada invocación de herramienta — ya sea que Claude la llame automáticamente durante una conversación o la actives manualmente — cuenta como una llamada API.

Plan	Llamadas por minuto	Llamadas por día
Gratuito	5	5
Prueba	10	100
De pago	30	1.000

Todas las llamadas a herramientas se registran en tu panel de Chaterimo en Developer API → Sesiones MCP. Puedes revisar qué herramientas se llamaron, cuándo y cuántas llamadas quedan en tu cuota diaria.

Todo en un solo lugar

El servidor MCP de Chaterimo conecta Claude con los datos en vivo de tu chatbot — conversaciones, análisis, productos, tickets y configuración — sin copiar y pegar ni cambiar de pestaña. Tanto si usas Claude Desktop con OAuth como Claude Code con una clave API, las mismas 19 herramientas están disponibles para consultar y gestionar tu chatbot en lenguaje natural.

Sin necesidad de copiar y pegar registros de conversaciones en Claude
Formula preguntas en lenguaje natural sobre el rendimiento de tu chatbot
Actualiza las instrucciones del chatbot desde dentro de una conversación con Claude
Compatible con Claude Desktop (OAuth) y Claude Code (clave API)
Endpoint de solo lectura para compartir con el equipo de forma segura

Empezar Gratis Documentación API de Desarrollador