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

# Conectar Zelto a Claude

> Agregue Zelto como conector personalizado en claude.ai o Claude Desktop, inicie sesión con su cuenta de Zelto y trabaje con sus monitores, hallazgos y conversaciones desde un chat de Claude.

Zelto ofrece un [servidor MCP](/es/docs/mcp) remoto en `https://api.zelto.ai/mcp`.
Claude (claude.ai en la web y la aplicación Claude Desktop) puede conectarse a él como
**conector personalizado**. Usted inicia sesión con su cuenta habitual de Zelto, así que
no hay ninguna clave de API que crear, copiar ni rotar.

Una vez conectado, puede pedirle a Claude el trabajo que haría en el panel: listar e
inspeccionar [monitores](/es/docs/monitors), crear o editar uno, leer los resultados que
produjo, abrir [hallazgos](/es/docs/findings) y leer [conversaciones](/es/docs/conversations)
y sus transcripciones.

## Antes de empezar

* **Una cuenta de Zelto que pertenezca a la organización.** Cualquier rol puede conectarse.
  El rol que tenga en esa organización sigue decidiendo qué herramientas funcionan;
  consulte [Su rol decide lo que puede hacer](#su-rol-decide-lo-que-puede-hacer).
* **Un plan de Claude que permita conectores personalizados.** En los planes Team y
  Enterprise, un propietario de su organización de Claude puede tener que agregar primero
  el conector, y luego cada persona conecta su propia cuenta de Zelto.
* **La URL exacta del servidor**, sin añadir ni quitar nada:

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

  La misma URL aparece, con un botón de copiar, en **Configuración → Integraciones →
  Acceso para agentes de IA → Claude** en el panel.

## Agregar Zelto en claude.ai

<Steps>
  <Step title="Abra la configuración de conectores">
    En claude.ai, abra **Configuración** y vaya a **Conectores**.
  </Step>

  <Step title="Agregue un conector personalizado">
    Elija la opción para agregar un conector personalizado. Póngale un nombre como `Zelto`
    y pegue `https://api.zelto.ai/mcp` como URL del servidor. Deje vacíos los campos
    avanzados de ID de cliente o secreto de OAuth: Zelto registra el cliente por usted
    automáticamente.
  </Step>

  <Step title="Conecte">
    Guarde el conector y elija **Conectar**. Se abre una ventana de Zelto en su navegador.
  </Step>

  <Step title="Inicie sesión y autorice">
    Inicie sesión en Zelto si aún no lo hizo (si su cuenta tiene verificación en dos
    pasos, se le pide el código). Luego revise y apruebe la solicitud en la
    [pantalla de autorización](#qué-pide-la-pantalla-de-autorización).
  </Step>

  <Step title="Úselo en un chat">
    De vuelta en Claude, inicie un chat y verifique que el conector de Zelto esté activado
    en él. Pruebe `Lista mis monitores` o `¿Qué hallazgos hay abiertos para mi agente más reciente?`.
  </Step>
</Steps>

## Agregar Zelto en Claude Desktop

Claude Desktop agrega los servidores remotos desde el mismo lugar que claude.ai:
**Configuración → Conectores**. Agregue un conector personalizado con el mismo nombre y la
misma URL de servidor de arriba. Apruebe la solicitud en la ventana del navegador que se
abre y vuelva a la aplicación.

No edita ningún archivo de configuración ni pega una clave de API. El fragmento
`mcpServers` con una clave bearer que aparece en el panel es para clientes que no pueden
iniciar sesión mediante el navegador, como [Claude Code](/es/docs/mcp#código-claude).

## Qué pide la pantalla de autorización

Al conectar, Zelto muestra una pantalla **Autorizar acceso**:

* **Quién lo pide.** `<cliente> quiere acceder a tu organización de Zelto mediante MCP`,
  donde el cliente es el nombre con el que Claude se registró. Si no acaba de iniciar una
  conexión, elija **Denegar**.
* **Qué podrá hacer.** Una lista bajo *Esto permitirá que la aplicación*. Muestra
  exactamente lo que el cliente solicitó, por ejemplo *Leer los datos de tu organización*
  y *Modificar los datos de tu organización*. Consulte
  [Acceso de lectura y escritura](#acceso-de-lectura-y-escritura).
* **Qué organización.** Si pertenece a más de una, elige una en *Elige una organización*.
  La conexión queda ligada solo a esa organización; Claude nunca ve las demás. Para
  cambiar después, desconecte y vuelva a conectar.
* **Permitir o Denegar.** No se comparte nada hasta que elija **Permitir**. Si todavía no
  pertenece a ninguna organización, la pantalla le indica que cree una antes de conectar.

La aprobación es válida durante diez minutos. Si deja la pantalla abierta más tiempo,
inicie la conexión de nuevo desde Claude.

## Acceso de lectura y escritura

Zelto tiene dos alcances de acceso, `read` y `write`, y `write` incluye `read`. Crear o
editar un monitor, cambiar el estado de un hallazgo y cualquier otro cambio requiere
`write`. Leer monitores, resultados, hallazgos, conversaciones y transcripciones solo
requiere `read`.

El cliente pide sus alcances; la pantalla de autorización los muestra pero no le permite
cambiarlos. Una conexión con solo `read` falla ante un cambio con
`This credential is read-only and cannot call "<tool>"`. Consulte
[Alcance de lectura y escritura](/es/docs/mcp#alcance-de-lectura-y-escritura) para ver
las reglas completas.

## Su rol decide lo que puede hacer

Un conector actúa como usted. Solo puede hacer lo que su rol en la organización elegida
permite, verificado en cada llamada:

* **Cualquier miembro** puede leer todo y hacer los cambios del día a día: crear, editar,
  pausar y eliminar monitores, y clasificar hallazgos.
* **Propietarios y administradores** pueden además usar las herramientas de la
  organización, como invitar o quitar miembros, cambiar la configuración de la
  organización, eliminar un agente y rellenar el historial de un monitor con una fecha
  `analysisStart`.
* **Solo los propietarios** pueden cambiar el rol de otro miembro.

Una herramienta que su rol no permite responde `Only an organization owner or admin can
perform this action.` en lugar de actuar. La lista completa está en
[Su rol decide lo que puede hacer](/es/docs/mcp#tu-papel-decide-lo-que-puedes-hacer).

## Tarjetas interactivas

En Claude, algunas respuestas se abren como una tarjeta interactiva dentro del chat en
lugar de texto plano: la lista de hallazgos, un hallazgo, una conversación, su
transcripción y su traza. Son las
[vistas de MCP Apps](/es/docs/mcp#vistas-interactivas-mcp-apps). Usan el mismo inicio de
sesión, rol y alcance que cualquier otra llamada a una herramienta. Si su plan o cliente de
Claude no muestra tarjetas, Claude recurre a las herramientas de texto equivalentes y
usted igualmente obtiene los datos.

## Desconectar

Elimine el conector en Claude (**Configuración → Conectores**) para dejar de usarlo. Eso,
por sí solo, no revoca el acceso que concedió en Zelto, así que desconéctelo también desde
Zelto:

1. Abra **Configuración → Clientes MCP** en el panel.
2. Busque la fila del cliente, que muestra quién lo autorizó, sus alcances y cuándo se
   usó por última vez.
3. Elija **Desconectar**.

Desconectar termina el acceso de inmediato: la siguiente solicitud de Claude se rechaza.
Los propietarios y administradores ven todas las conexiones de la organización y pueden
desconectar cualquiera; un miembro ve y puede desconectar solo las suyas. El acceso
también se detiene si usted deja la organización o su cuenta es suspendida.

Los tokens de acceso duran una hora y Claude los renueva en segundo plano. Si más adelante
Claude indica que el conector debe autorizarse de nuevo, elija **Conectar** y apruebe otra
vez.

## Solución de problemas

* **Claude dice que no puede conectarse o muestra `401`.** Verifique que la URL del
  servidor sea exactamente `https://api.zelto.ai/mcp`, luego elimine el conector y
  agréguelo de nuevo. Un `401` también significa que la conexión se desconectó en Zelto o
  expiró; conecte de nuevo.
* **La pantalla de autorización lo envía al panel al pulsar Permitir.** La solicitud tenía
  más de diez minutos o ya se usó. Inicie la conexión de nuevo desde Claude.
* **`Invalid redirect URI`.** El registro guardado de Claude ya no coincide con la
  solicitud. Elimine el conector, agréguelo de nuevo y apruebe otra vez.
* **`This credential is read-only and cannot call "<tool>"`.** La conexión solo tiene el
  alcance `read`. En **Configuración → Clientes MCP** desconéctela, vuelva a conectar y
  verifique que la pantalla incluya *Modificar los datos de tu organización*. Si la
  pantalla solo ofrece lectura, consulte con su contacto en Zelto; el cliente decide qué
  solicita.
* **`Only an organization owner or admin can perform this action.`** La herramienta
  funcionó; su rol no lo permitió. Pida a un propietario o administrador que la ejecute o
  que cambie su rol.
* **No ve la organización que necesita.** La pantalla de autorización lista solo las
  organizaciones a las que usted pertenece. Pida a un propietario que lo
  [invite](/es/docs/settings#miembros-e-invitaciones) y conecte de nuevo. Una conexión
  queda ligada a una organización; para usar otra, desconecte, conecte de nuevo y elíjala.
* **Las herramientas de Zelto no aparecen en un chat.** Active el conector de Zelto en
  ese chat o inicie un chat nuevo después de conectar.

## Relacionado

* [MCP](/es/docs/mcp) para ver todas las herramientas, los equivalentes REST y los demás
  clientes.
* [Monitores](/es/docs/monitors) para saber qué es un monitor y cómo se juzgan los
  resultados.
* [A bordo con un agente](/es/docs/onboarding-with-an-agent) para configurar una
  organización nueva de principio a fin.


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