> ## Documentation Index
> Fetch the complete documentation index at: https://help.ciarem.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Asistentes de IA (MCP)

> Conecta Ciarem a Claude, ChatGPT, Cursor o cualquier asistente compatible con MCP, y pregunta por tus conversaciones, contactos, base de conocimiento, métricas y la configuración y el desempeño de tu agente de IA en lenguaje natural.

Puedes conectar Ciarem a un asistente de IA como Claude o ChatGPT. Una vez conectado, puedes preguntarle cosas como "¿qué chats están esperando respuesta?" o "prepárame para mi llamada con Laura", y el asistente lee la respuesta de tu espacio de trabajo de Ciarem. Ciarem se conecta mediante MCP (Model Context Protocol), un estándar abierto, así que funciona en cualquier asistente que admita servidores MCP remotos.

La conexión es **de solo lectura**: el asistente puede consultar información, pero no puede enviar mensajes, editar contactos ni cambiar ninguna configuración.

## Antes de empezar

* Necesitas un usuario de Ciarem en un espacio de trabajo con un plan o una prueba activa.
* Cada persona se conecta con su propio inicio de sesión de Ciarem. El asistente ve lo mismo que esa persona ve en Ciarem, nada más.
* No hace falta configurar nada en Ciarem. Cualquier miembro del espacio de trabajo puede conectarse.

La dirección que debes agregar en tu asistente es:

```
https://api.ciarem.ai/mcp
```

## Conectar

Al agregar la dirección, el asistente abre una página de inicio de sesión de Ciarem. Inicia sesión, elige el **espacio de trabajo** que quieres conectar si perteneces a más de uno y permite el acceso. Cada conexión lee un solo espacio de trabajo; para usar dos, agrega Ciarem dos veces y elige uno distinto en cada una.

Los menús de abajo son de cada asistente y pueden cambiar. Si una etiqueta no coincide, busca "conectores", "apps" o "servidores MCP" en su configuración.

**Claude**

Ciarem está en el directorio de conectores de Claude como **Ciarem AI**, así que no necesitas pegar la dirección.

**1. Abre el conector Ciarem AI**

Abre [Ciarem AI en el directorio de Claude](https://claude.ai/directory/ciarem-ai), o en Claude (web o escritorio) ve a **Settings > Connectors**, explora los conectores y busca "Ciarem AI".

**2. Conecta tu cuenta**

Haz clic en **Connect**, inicia sesión en Ciarem y elige tu espacio de trabajo.

**3. Úsalo en un chat**

Activa Ciarem desde el menú **+** de una conversación y haz tu pregunta.

En los planes Team y Enterprise de Claude, puede que un propietario tenga que habilitar el conector para la organización en **Admin settings > Connectors** antes de que los miembros puedan conectarse.

**ChatGPT**

Ciarem está en el directorio de apps de ChatGPT, así que no necesitas pegar la dirección.

**1. Abre la app de Ciarem**

Abre [Ciarem en el directorio de ChatGPT](https://chatgpt.com/plugins/plugin_asdk_app_6ac028974a38819183e40cf821805610), o en ChatGPT ve a **Settings > Apps & Connectors**, explora el directorio y busca "Ciarem".

**2. Conecta tu cuenta**

Haz clic en **Connect**, inicia sesión en Ciarem y elige tu espacio de trabajo.

**3. Úsalo en un chat**

Selecciona Ciarem en el menú de herramientas de una conversación y haz tu pregunta.

En los planes Business y Enterprise, puede que el administrador de ChatGPT tenga que permitir la app primero.

**Claude Code, Cursor, VS Code**

En Claude Code, ejecuta:

```bash theme={null}
claude mcp add --transport http ciarem https://api.ciarem.ai/mcp
```

Luego escribe `/mcp`, elige **ciarem** e inicia sesión.

En Cursor (`~/.cursor/mcp.json`) o VS Code (`.vscode/mcp.json`), agrega el servidor e inícialo; el editor abre el inicio de sesión de Ciarem la primera vez:

```json theme={null}
{
  "servers": {
    "ciarem": { "type": "http", "url": "https://api.ciarem.ai/mcp" }
  }
}
```

Cursor usa `mcpServers` en lugar de `servers` como clave principal.

**Otros asistentes**

Cualquier asistente que admita **servidores MCP remotos con OAuth** puede conectarse. Agrega un servidor MCP remoto (HTTP) con la dirección de arriba y sin clave de API. El asistente se registra solo y te lleva a la página de inicio de sesión de Ciarem.

## Qué puedes preguntar

| El asistente puede | Quién |
| - | - |
| Decirte con qué usuario y espacio de trabajo de Ciarem está conectado | Todos |
| Buscar contactos por nombre, teléfono o correo, opcionalmente por etapa del embudo o solo los tuyos, y abrir un contacto con sus últimas conversaciones | Todos |
| Listar conversaciones del inbox por estado, canal, asignadas a ti o sin asignar, y leer una conversación, notas internas incluidas | Todos |
| Buscar en tus [bases de conocimiento](https://help.ciarem.ai/es/ai-agent/knowledge-bases.md) igual que lo hace tu agente de IA, o encontrar dónde aparece una frase exacta | Todos |
| Consultar los pasos de este centro de ayuda, en español, inglés o portugués | Todos |
| Reportar métricas de conversaciones y del equipo de las últimas 24 horas o 7 días | Administradores |
| Revisar si tu agente de IA está listo y qué falta corregir, además del estado de cada canal | Administradores |
| Explicar por qué el agente de IA respondió, transfirió o se abstuvo en las conversaciones recientes de un contacto | Administradores |
| Mostrar cómo está configurado tu agente de IA: perfil del negocio, tono y demás ajustes, la función y las preguntas de cada agente, el coaching y las [reglas de transferencia](https://help.ciarem.ai/es/ai-agent/human-handoff-and-escalation.md) | Administradores |
| Reportar cómo le fue al agente de IA en las últimas 24 horas, 7 días o 30 días: cuánto atendió o transfirió, errores, tiempo de respuesta y las reglas de transferencia que más se activaron | Administradores |
| Listar tus fuentes de conocimiento, leer una completa y listar las preguntas de los clientes que tu conocimiento no pudo responder | Administradores |
| Resumir tus [evaluaciones de respuestas](https://help.ciarem.ai/es/ai-agent/evaluation-center.md): el veredicto de cada categoría, la corrección aplicada y respuestas de ejemplo | Administradores |

Algunas preguntas para probar:

* "¿Qué conversaciones asignadas a mí están esperando respuesta? Resume cada una en una línea."
* "Prepárame para mi llamada con Laura Gómez: su etapa del embudo, sus propiedades y de qué hablamos la última vez."
* "¿Qué dice nuestra base de conocimiento sobre los reembolsos?"
* "Dame un reporte semanal: conversaciones, cuántas atendió la IA y el ranking del equipo."
* "¿Por qué la IA transfirió la última conversación con +57 300 123 4567?"
* "¿Qué debería mejorar en mi agente de IA?"
* "¿De qué fuente saca la IA que el envío cuesta \$5?"

Cada respuesta incluye enlaces a Ciarem, para que abras el contacto o la conversación y respondas desde ahí.

## Quién ve qué

El asistente usa el [rol](https://help.ciarem.ai/es/using-ciarem/roles-and-permissions.md) de la persona que lo conectó:

* Los **agentes** ven solo sus propios contactos y las conversaciones que pueden ver en el inbox. Las preguntas exclusivas de administradores responden que hace falta un administrador.
* Los **administradores** ven todo el espacio de trabajo.

Ciarem revisa tu acceso en cada pregunta. Si te quitan del espacio de trabajo o cambia tu rol, la conexión lo refleja de inmediato.

Lo que preguntas, y los datos de Ciarem que el asistente lee para responder, se envían al proveedor de ese asistente (por ejemplo, Anthropic u OpenAI) y se tratan según sus términos. Conecta solo asistentes que tu empresa permita usar con datos de clientes.

## Desconectar

Quita o desconecta Ciarem en la configuración de conectores o apps del asistente. Quitar a una persona del espacio de trabajo también termina todas las conexiones que hizo.

## Solución de problemas

* **"subscription\_required"**: el espacio de trabajo no tiene un plan ni una prueba activa. Consulta [Planes y facturación](https://help.ciarem.ai/es/billing/plans-and-billing.md).
* **"requires\_admin"**: la pregunta necesita un administrador; los agentes no pueden ver métricas, el estado de la cuenta, las explicaciones de decisiones de la IA ni la configuración, el desempeño, las fuentes de conocimiento, las preguntas sin respuesta y las evaluaciones del agente de IA.
* **"help\_unavailable"**: no se pudo consultar el centro de ayuda; vuelve a preguntar en un momento.
* **El inicio de sesión se repite o aparece "invalid token" justo después de conectar**: desconecta, vuelve a conectar y asegúrate de elegir un espacio de trabajo en la página de inicio de sesión de Ciarem.
* **No encuentra un contacto o una conversación**: tu usuario tampoco lo ve en Ciarem, o pertenece a un espacio de trabajo distinto del que conectaste.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.