Conectar el MCP de Zaly a Claude
Esta guía explica cómo crear una clave API en Zaly, añadir el conector en Claude y activarlo en una conversación. Sigue los pasos en orden y compara tu pantalla con cada captura.
Antes de empezar
MCP es la conexión que permite a Claude consultar y usar las herramientas de Zaly. Para este recorrido necesitas una cuenta de Zaly, acceso a sus claves API y una cuenta de Claude.
Elige dónde vas a usar Claude
| Opción | Qué tienes que hacer |
|---|---|
| Claude web | Abre claude.ai en tu navegador e inicia sesión. No necesitas instalar una aplicación. |
| Claude Desktop | Descarga la aplicación desde claude.com/download. Elige macOS o Windows según tu ordenador. Abre el archivo de Descargas y sigue el instalador. En Mac, lleva Claude a Aplicaciones si te lo pide. Después, abre Claude e inicia sesión. |
| Cowork | Es un modo de trabajo dentro de Claude. Selecciona Cowork al iniciar una tarea si tu cuenta lo incluye. Usa el mismo conector remoto de Zaly; no necesitas añadir un servidor distinto. |
Las capturas muestran Claude Desktop en macOS. Los conectores remotos también están disponibles en Claude web y Cowork. La disponibilidad de Cowork depende del plan y de los controles de tu organización.
No necesitas usar la terminal ni instalar un servidor MCP en tu ordenador para seguir estos pasos. Claude Code y Codex tienen una configuración distinta; las instrucciones de esta guía corresponden al conector de Claude.
Información oficial: conectores remotos de Claude · disponibilidad de Cowork.
Cómo leer las capturas
Las imágenes conservan el encuadre completo de los archivos proporcionados. El texto indica el nombre del botón o campo y dónde se encuentra. Pulsa cualquier imagen para verla ampliada; pulsa Cerrar o la tecla Esc para volver a la guía.
1. Abre las claves de API en Zaly
Entra en Zaly con tu cuenta. Abre el menú de tu perfil, arriba a la derecha, y pulsa Configuración.
Selecciona Claves de API. En el bloque Clientes API, pulsa Nuevo cliente API.
Si ya tienes una clave completa guardada para esta conexión, puedes pasar al paso 4. El prefijo que aparece en la lista no es la clave completa.
Si la ventana tiene desplazamiento, baja hasta ver el botón rosa. Las pestañas Codex y Claude Code que aparecen en esta captura contienen instrucciones para otros clientes. Para seguir esta guía, empieza por Nuevo cliente API.
2. Crea una clave para Claude
- En Nombre, escribe el nombre que quieras.
- En Validez en días, indica cuánto tiempo debe funcionar. Por ejemplo, 30.
- Pulsa Crear.
Ese nombre te ayudará a reconocer la conexión. Cuando termine la validez, tendrás que usar una clave nueva.
La validez es el número de días durante los que podrás usar esa clave.
3. Copia la clave antes de salir
Después de pulsar Crear, Zaly muestra el aviso «Guarda esta clave ahora. Zaly no volverá a mostrarla.»
Pulsa el botón de copiar que está junto a la clave. Guárdala en tu gestor de contraseñas para recuperarla en el paso 9.
No copies solo el prefijo de la lista. Necesitas la clave completa que se muestra justo después de crearla.
Pega la clave únicamente en el campo de credenciales del conector. No la pegues en un chat.
El botón de copiar tiene el icono de dos cuadrados superpuestos. Está junto al campo que contiene la clave recién creada. No cierres la pantalla hasta haber guardado el valor completo.
Si saliste sin guardarla, la lista solo mostrará un prefijo. Crea otra clave para esta conexión y guarda su valor cuando aparezca. No intentes reconstruir la clave a partir del prefijo.
4. Abre Personalizar en Claude
Abre Claude en el navegador o en la aplicación de escritorio e inicia sesión.
En el menú de la izquierda, pulsa Personalizar. Después, pulsa la pestaña Conectores.
Las capturas de esta guía corresponden a Claude Desktop en macOS. El conector remoto también se configura desde tu cuenta de Claude en la web.
Si el menú de la izquierda está cerrado, abre la barra lateral con su botón. No tienes que entrar en Code ni crear un proyecto para conectar Zaly.
5. Añade un conector personalizado
Dentro de Conectores, pulsa Añadir, arriba a la derecha.
Se abre el formulario Añadir conector personalizado.
En cuentas Team o Enterprise, el propietario puede tener que añadir el conector antes de que los miembros puedan conectarlo.
Según la vista de tu cuenta, puedes estar en Tuyo o en Descubrir. Busca el botón Añadir de la parte superior, no el botón de otra aplicación del directorio.
6. Introduce el nombre y la URL
En Nombre, escribe Zaly.
En URL del servidor MCP, pega esta dirección:
https://mcp.zaly.app/mcpPulsa Continuar.
Si Claude dice que el conector ya existe, cancela este formulario y abre Zaly en la lista de conectores.
La URL termina en /mcp. Pega solo la dirección del servidor en ese campo. La clave se introduce más adelante, en un campo separado.
7. Selecciona Sin inicio de sesión
En Autenticación, selecciona la tercera opción: Sin inicio de sesión.
Zaly usa una clave API en este recorrido. La clave se añade en el siguiente apartado.
El aviso indica que el servidor necesita credenciales. Mantén esta opción y añade la clave en Encabezados de solicitud. Así completamos la conexión.
No necesitas rellenar Cliente OAuth ni abrir Avanzada.
Aunque Claude marque Iniciar sesión ahora como «Detectado», selecciona Sin inicio de sesión para este recorrido con clave API. Al cambiar esta opción, deja de ser necesario configurar un cliente OAuth.
8. Selecciona authorization
- Baja hasta Encabezados de solicitud.
- Pulsa Añadir encabezado.
- Abre Nombre del encabezado.
- Selecciona authorization en el desplegable.
Elige la opción de la lista para que quede seleccionada.
El campo de la derecha se llama Valor. Ahí introducirás la credencial en el siguiente paso. No selecciones x-api-key para reproducir la configuración que hemos comprobado.
9. Pega la clave y guarda
En Valor, escribe Bearer, añade un espacio y pega la clave completa que guardaste en el paso 3.
Bearer TU_CLAVE_API_DE_ZALYSustituye TU_CLAVE_API_DE_ZALY por tu clave real.Escribe Bearer una sola vez, sin comillas ni saltos de línea. Deja marcada Obligatorio y pulsa Añadir.
Los puntos negros del campo ocultan la clave. Es normal.
Por ejemplo, si tu clave fuese CLAVE_DE_EJEMPLO, el valor sería Bearer CLAVE_DE_EJEMPLO. Este ejemplo no sirve para conectarse. Usa tu clave real de Zaly.
10. Pulsa Conectar
Espera a que Claude termine de comprobar el servidor.
Si aparece «Todavía no estás conectado a Zaly», pulsa Conectar.
Espera a que se carguen las herramientas. Puede aparecer un mensaje temporal mientras se carga la lista.
Si no aparece este botón y ya ves las herramientas, la conexión está hecha. Continúa con el paso siguiente.
11. Comprueba las herramientas
La conexión está disponible cuando ves el botón Desconectar y las herramientas de Zaly.
En la conexión de estas capturas se cargaron 16 herramientas de lectura y 20 de escritura/eliminación. El número puede cambiar.
Mantén Requiere aprobación para revisar cada solicitud antes de permitir que Claude use una herramienta.
No pulses Desconectar: ese botón permite cerrar una conexión que ya está activa. Puedes desplegar cada grupo para revisar las herramientas que contiene.
12. Activa Zaly en el chat o en Cowork
- Pulsa Nuevo.
- Elige Chat o Cowork, si tu cuenta lo incluye.
- Pulsa + junto al cuadro de mensaje.
- Abre Conectores.
- Activa el interruptor de Zaly.
En la captura, el interruptor azul indica que Zaly está activo.
Conectar Zaly en Personalizar y activarlo en una conversación son dos pasos distintos. Si Claude no lo usa en un chat nuevo, vuelve a comprobar este interruptor.
13. Haz una primera consulta
Copia este mensaje y envíalo en Claude:
Dime qué es lo que puede hacer Zaly.Claude debe explicar qué puede hacer con Zaly y qué herramientas tiene disponibles.
La captura muestra una respuesta de ejemplo sobre las funciones de Zaly. Tus resultados dependerán de tu cuenta y sus permisos.
Resuelve los problemas más comunes
Claude muestra un aviso amarillo sobre el inicio de sesión
Mantén Sin inicio de sesión. Añade authorization y el valor Bearer seguido de un espacio y tu clave completa. El aviso aparece porque Zaly requiere credenciales.
La conexión falla o aparece 401
Revisa la URL, el encabezado authorization y el valor completo. Comprueba que hay un espacio después de Bearer y que la clave no ha caducado ni se ha revocado. El prefijo de la lista de clientes API no sirve para conectarte.
Ya existe un conector con esta URL
Abre el conector Zaly que ya aparece en Conectores. Pulsa Conectar si es necesario. No necesitas crear otro conector con la misma dirección.
Está conectado, pero Claude no usa Zaly
Abre una conversación nueva. Pulsa +, entra en Conectores y comprueba que Zaly está activo. Pide de forma explícita que use Zaly para una consulta de lectura y revisa cualquier solicitud de aprobación.
No aparecen herramientas
Espera a que termine la carga. Si la lista sigue vacía, abre el menú de tres puntos del conector y pulsa Actualizar lista de herramientas. Si persiste, revisa la clave y los permisos de tu cuenta.
No veo Añadir o no tengo Cowork
Comprueba que usas la versión actual de Claude. En una cuenta de equipo, consulta al propietario si puede añadir conectores. Cowork requiere un plan compatible; puedes usar la conexión desde Chat sin elegir Cowork.