Guías de conexión / Claude

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ónQué tienes que hacer
Claude webAbre claude.ai en tu navegador e inicia sesión. No necesitas instalar una aplicación.
Claude DesktopDescarga 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.
CoworkEs 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.

Captura 1. La pestaña Claves de API está en el menú izquierdo de Configuración. El botón Nuevo cliente API está debajo de las instrucciones de conexión. Pulsa la imagen para ampliarla.

2. Crea una clave para Claude

  1. En Nombre, escribe el nombre que quieras.
  2. En Validez en días, indica cuánto tiempo debe funcionar. Por ejemplo, 30.
  3. 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.

Captura 2. Pulsa Crear cuando los dos campos estén completos. Pulsa la imagen para ampliarla.

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.

Captura 4. Pulsa Personalizar en el menú izquierdo y después Conectores en la parte superior. Esta captura conserva el encuadre original que se proporcionó. Pulsa la imagen para ampliarla.

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.

Captura 5. El botón Añadir está en la esquina superior derecha del apartado Conectores. Abre el formulario para introducir tu servidor. Pulsa la imagen para ampliarla.

6. Introduce el nombre y la URL

En Nombre, escribe Zaly.

En URL del servidor MCP, pega esta dirección:

https://mcp.zaly.app/mcp

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

Captura 6. El formulario debe mostrar Zaly como nombre y https://mcp.zaly.app/mcp como dirección. Después, pulsa Continuar. Pulsa la imagen para ampliarla.

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.

¿Ves el aviso amarillo?

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.

Captura 7. La opción seleccionada es Sin inicio de sesión. El aviso amarillo indica que debes proporcionar una clave API en Encabezados de solicitud. Pulsa la imagen para ampliarla.

8. Selecciona authorization

  1. Baja hasta Encabezados de solicitud.
  2. Pulsa Añadir encabezado.
  3. Abre Nombre del encabezado.
  4. 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.

Captura 8. Abre el desplegable Nombre del encabezado y selecciona authorization. El resto de la ventana se mantiene visible para que puedas localizar este campo. Pulsa la imagen para ampliarla.

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.

Formato del valorBearer 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.

Captura 9. El valor aparece oculto con puntos. Deja marcada la casilla Obligatorio y pulsa Añadir al final de la ventana. Pulsa la imagen para ampliarla.

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.

Captura 10. Esta pantalla aparece después de guardar el conector. Pulsa Conectar para iniciar la conexión con Zaly. Pulsa la imagen para ampliarla.

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.

Captura 11. El botón Desconectar y la lista de herramientas indican que el conector está disponible. Requiere aprobación permite revisar las solicitudes de uso. Pulsa la imagen para ampliarla.

12. Activa Zaly en el chat o en Cowork

  1. Pulsa Nuevo.
  2. Elige Chat o Cowork, si tu cuenta lo incluye.
  3. Pulsa + junto al cuadro de mensaje.
  4. Abre Conectores.
  5. 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.

Captura 12. En una conversación nueva, abre +, entra en Conectores y activa Zaly. El interruptor azul indica que está seleccionado. La captura muestra el modo Cowork. Pulsa la imagen para ampliarla.

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.

Captura 13. Una vez conectado, puedes preguntar por las funciones de Zaly. La captura muestra una respuesta de ejemplo. Pulsa la imagen para ampliarla.
SI ALGO NO SALE COMO EN LA CAPTURA

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.