Conectar Adereso MCP con Claude o Codex
Conecta tu cuenta de Adereso con Claude o Codex para consultar tickets, revisar bots y realizar las acciones que autorices desde una conversación.
Conecta tu cuenta de Adereso con Claude o Codex para consultar tickets, revisar bots y realizar las acciones que autorices desde una conversación.
Para conectar el asistente usarás una API key: una clave de acceso que tú o tu administrador crean en Desk. Sus permisos determinan qué información puede consultar el asistente y qué acciones puede realizar.
Requisitos
- Necesitas ser Administrador de Desk para crear y configurar API keys. Si no tienes ese acceso, pide a tu administrador que prepare una para ti.
- Ten una cuenta de Claude o Codex que permita conectar servidores MCP. En una cuenta de equipo, su administrador puede necesitar agregar el conector.
- Elige una primera tarea, como resumir un ticket o revisar un bot. Así podrás conceder únicamente los permisos que necesitas.
Tú decides a qué puede acceder tu asistente. La API key limita las acciones y los recursos de tu organización que podrá utilizar. Crear la API key, activar MCP y autorizar la conexión son tres acciones distintas.
Crea una API key
En Desk, abre Admin. → Usuarios de API. La pantalla se identifica como Credenciales API.
- Selecciona Crear API Key.
- En Detalles, escribe un Nombre que te permita reconocer su uso, como
Asistente de soporte.
- Define Solicitudes por minuto (RPM): cuántas solicitudes puede realizar esa API key en un minuto. También se aplica el límite de tu organización. Por ejemplo, puedes usar
20para una prueba si tu cuenta lo permite.
- Selecciona Continuar.
Elige los permisos de tu asistente
En Permisos, revisa las pestañas Desk y Studio. Si solo quieres consultar información, elige permisos de consulta. Concede permisos para editar o publicar únicamente si quieres que el asistente pueda realizar esas acciones.
Quieres hacer esto | Qué acceso debes preparar |
Consultar un ticket y resumir su conversación | Consultar establecimiento, Consultar tickets y Consultar mensajes en Desk. |
Listar bots o revisar su configuración | Consultar bots y versiones en Studio. |
Modificar el borrador de un bot | Editar bots, con acceso al bot correspondiente. |
Publicar cambios de un bot | Publicar bots. Puede cambiar el comportamiento de los bots en uso. |
Consultar los secretos disponibles | Consultar secretos. Permite leer nombres y metadatos, sin revelar sus valores. |
Selecciona los permisos que necesita tu asistente. Puedes crear una API key con permisos de Desk, de Studio o de ambos. Si solo usarás Studio, no necesitas seleccionar ningún permiso de Desk.
Define a qué bots aplica
Si usarás Studio, elige a qué bots podrá acceder el asistente:
Opción | Bots incluidos | Si creas otro bot después |
Todos los bots de la organización | Todos los bots de tu organización. | Queda incluido automáticamente. |
Solo bots seleccionados | Únicamente los que elijas en el selector. | Debes agregarlo a la selección para darle acceso. |
La selección de bots se comparte entre los permisos de esa API key. Por ejemplo, si eliges dos bots y concedes permisos de consulta y edición, ambos permisos se aplican a esos dos bots.
Los permisos para crear bots y administrar secretos compartidos tienen alcance sobre la organización. Revisa la indicación junto a cada permiso antes de seleccionarlo.
Revisa y guarda tu API key
- Continúa al paso Confirmar y revisa el nombre, el límite y los permisos.
- Selecciona Crear API Key.
- En Guarda tu nueva API Key, copia la clave y guárdala en un lugar seguro. También puedes usar Descargar clave.
- Marca Ya guardé la clave en un lugar seguro y selecciona Terminar.
Guarda la API key antes de cerrar. Su valor completo se muestra una sola vez. Trátala como una contraseña: no la compartas en conversaciones, capturas ni solicitudes de soporte.
Activa MCP en tu API key
- Vuelve a la tabla de Credenciales API y localiza la API key.
- Haz clic en su interruptor de la columna MCP.
- En la ventana que se abre, marca Habilitar MCP para esta API Key y selecciona Guardar.
Comprueba que el interruptor MCP quede activado en la tabla.
Elegir permisos no activa MCP. Debes habilitar el interruptor antes de conectar tu asistente. Activarlo conserva los permisos que elegiste.
Configura la conexión en Claude o Codex
En Credenciales API, selecciona Cómo conectar MCP y elige la pestaña de tu asistente.
Puedes usar una de estas opciones:
- Manual: sigue las instrucciones para agregar Adereso desde la configuración de tu asistente.
- CLI: si ya utilizas Codex CLI o Claude Code, copia y ejecuta los comandos de conexión.
Elige una sola opción para el asistente que uses. La guía integrada también incluye los pasos de autorización y ejemplos de consulta.
Copia esta URL cuando tu asistente solicite la dirección del servidor MCP:
https://mcp.adereso.ai/mcpEsta dirección es un dato público de conexión. Tu API key se ingresa después, en la página de Adereso.
Claude
Manual
- Abre Personalización → Conectores en Claude.
- Selecciona Agregar → Agregar conector personalizado y usa
Aderesocomo nombre.
- Pega la URL del servidor que aparece en la guía de Desk y continúa.
- En Cliente OAuth, elige Usar tu propio cliente OAuth e introduce este identificador:
adereso-client-claude- Deja el secreto de cliente vacío. Tu API key se ingresará más adelante en la página de Adereso.
- Termina de agregar el conector y selecciona Conectar.
Si usas una cuenta de equipo, su administrador puede necesitar agregar primero el conector. Comprueba que estés en la cuenta de Claude donde quieres usar Adereso.
CLI en Claude Code
Si ya usas Claude Code, ejecuta:
claude mcp add --transport http --scope user --client-id adereso-client-claude-code adereso https://mcp.adereso.ai/mcp
claude mcp login aderesoEl segundo comando abre la autorización en el navegador. También puedes abrir /mcp dentro de Claude Code y autenticar Adereso desde allí.
Codex
Manual
- Abre
config.tomldesde la configuración de Codex. En la extensión del editor, la ruta es Codex Settings → Open config.toml.
- Agrega este bloque conservando el resto del archivo. Si ya existe una sección
mcp_servers.adereso, actualízala en lugar de duplicarla:
[mcp_servers.adereso]
url = "https://mcp.adereso.ai/mcp"
[mcp_servers.adereso.oauth]
client_id = "adereso-client-codex"- Guarda el archivo y reinicia Codex.
- En Configuración → Servidores MCP, busca Adereso y selecciona Autenticar para abrir la autorización.
Este archivo contiene la configuración de conexión. Ingresa tu API key únicamente en la página de autorización de Adereso.
CLI en Codex
Si ya tienes Codex CLI instalado, ejecuta:
codex mcp add adereso --url https://mcp.adereso.ai/mcp --oauth-client-id adereso-client-codex
codex mcp login aderesoEl segundo comando abre el navegador para autorizar la conexión.
Autoriza la conexión en Adereso
Este paso es común a Claude y Codex.
- En la página de Adereso, pega la API key que preparaste y selecciona Continuar.
- Revisa el nombre de la API key, los permisos y el alcance de bots.
- Si el alcance coincide con lo que necesitas, selecciona Autorizar conexión.
- Regresa al asistente y comprueba que el conector figure conectado.
Tu API key debe permanecer privada. No la pegues en el chat, en la URL del servidor ni en el campo de secreto de cliente de tu asistente. Ingrésala solo en la página de autorización de Adereso.
Comprueba la conexión
Abre una conversación nueva. En Claude, habilita el conector Adereso desde + → Conectores si no está seleccionado. En Codex, usa una conversación con el servidor conectado.
Elige un ejemplo según los permisos de tu API key. Si el ejemplo incluye un número de ticket o un nombre de bot, usa uno de tu organización.
Consultar un ticket de Desk
Permisos en Desk: Consultar establecimiento, Consultar tickets y Consultar mensajes. Reemplaza 12345 por el número de un ticket de tu organización.
Consulta el ticket 12345 y resume sus últimos mensajes. Indica qué necesita el cliente y qué quedó pendiente, sin modificar el ticket.Listar los bots autorizados
Permiso en Studio: Consultar bots y versiones.
Lista los bots de Studio a los que tengo acceso e indica el nombre y tipo de cada uno.Revisar la configuración de un bot
Permiso en Studio: Consultar bots y versiones y acceso al bot elegido. Reemplaza Asistente de soporte por su nombre.
Revisa el borrador del bot «Asistente de soporte» y resume su configuración y las acciones que puede realizar, sin cambiar nada.Explorar opciones para configurar un bot
Necesitas un permiso de consulta, edición o creación de bots que permita consultar el catálogo de Studio.
Consulta el catálogo de Studio y explícame qué herramientas y componentes puedo configurar en un agente de atención.Consultar secretos disponibles
Permiso en Studio: Consultar secretos. Esta consulta muestra nombres y descripciones; no revela los valores de los secretos.
Lista los nombres y las descripciones de los secretos de Studio a los que tengo acceso, sin mostrar sus valores.El asistente puede pedirte permiso antes de usar Adereso. Revisa la acción y el recurso antes de aceptarla.
Comprueba la conexión con una consulta. Tu asistente debe utilizar Adereso y devolver información de un recurso al que tenga acceso. Los ejemplos anteriores son de consulta y no requieren modificar bots ni tickets.
Cambia permisos o retira el acceso
- Editar permisos o bots: abre los tres puntos de la API key, selecciona Editar y guarda los cambios.
- Detener solo el acceso por MCP: desactiva el interruptor MCP de esa API key en Desk.
- Usar otra API key: vuelve a autorizar la conexión desde tu asistente e ingresa la nueva clave en Adereso.
Revocar una API key afecta a todas las integraciones que la usan. Si la revocas, también dejará de funcionar en MCP. Si solo quieres detener la conexión del asistente, desactiva su interruptor MCP.
Solución de problemas
¿Puedo conectar una API key que ya tengo?
Sí, si sigue activa, tiene los permisos que necesitas y está habilitada para MCP. Debes tener guardado su valor completo. Si ya no lo tienes, pide a tu administrador que prepare otra; Desk no vuelve a mostrarlo después de crearla.
¿Tengo que reconectar si cambio los permisos o los bots?
No. Los cambios de una misma API key se aplican a su conexión existente. Si agregaste permisos y no aparecen las herramientas nuevas, abre una conversación nueva o actualiza su lista en el asistente. Si cambias la API key, tendrás que volver a autorizar con la nueva.
¿Por qué no puedo crear o editar API keys?
Necesitas acceso de Administrador en Desk. Pide a un administrador de tu organización que cree o configure la API key para ti.
¿Por qué se rechaza mi API key al conectar?
Comprueba que copiaste el valor completo, que la API key siga activa y que tenga MCP habilitado. Si el problema continúa, contacta a soporte sin enviar el valor de la clave.
¿Qué reviso si falta una herramienta o aparece «Acceso denegado»?
Revisa los permisos de la API key y, en Studio, la selección de bots. El asistente solo puede usar recursos autorizados de tu organización. Si acabas de ampliar permisos, prueba en una conversación nueva o actualiza la lista de herramientas.
¿Qué hago si la página de autorización dice que la conexión expiró?
Regresa al asistente e inicia de nuevo la conexión. Se abrirá una página de autorización nueva. Evita reutilizar un enlace de autorización anterior.
¿Qué significa que alcancé el límite de solicitudes?
La API key o tu organización alcanzaron su límite de solicitudes por minuto. Espera antes de reintentar. Si ocurre con frecuencia, pide a tu administrador que revise el límite de la API key y el de la organización.
¿Qué hago si Claude Desktop no completa la conexión en el navegador?
Abre Claude web con la misma cuenta y conecta Adereso desde Conectores. Después vuelve a Desktop y comprueba el estado. Si usas varios perfiles, verifica que el navegador y la app correspondan a la misma cuenta.
Documentación relacionada
- Configuración MCP en Codex: consulta las opciones de conexión y configuración de Codex.
- Conectores personalizados de Claude: revisa cómo administrar el conector desde la cuenta de Claude.
- Conexión MCP en Claude Code: consulta la instalación y autenticación desde CLI.
Conversemos
¿Necesitas ayuda para elegir los permisos o conectar tu asistente? Conversemos sobre lo que quieres hacer y el acceso adecuado para tu equipo.