Conecte Notiondesk Workspace MCP a Codex para revisar la información del espacio de trabajo y realizar las acciones Notiondesk compatibles desde la CLI o la extensión IDE de Codex.
Notiondesk se ejecuta como un servidor MCP remoto y utiliza OAuth para autenticar su cuenta Notiondesk.
Antes de empezar
Cerciorarse:
- MCP de espacio de trabajo está habilitado para al menos un centro de ayuda Notiondesk
- Puedes iniciar sesión en el espacio de trabajo Notiondesk al que deseas conectarte.
- Codex está instalado y funcionando en su ordenador.
Si Workspace MCP aún no está habilitado, consulte Habilitar Workspace MCP en Notiondesk .
Agregar Notiondesk MCP al Codex
Correr:
Esto agrega el servidor MCP de espacio de trabajo Notiondesk a su configuración de Codex.
Autentícate con Notiondesk
Después de agregar el servidor, ejecute:
Su navegador abre la página de autorización OAuth Notiondesk.
Entonces:
codex mcp add notiondesk --url https://mcp.notiondesk.so/mcpcodex mcp login notiondesk- Inicie sesión en Notiondesk si es necesario.
- Confirme que se muestra el espacio de trabajo correcto.
- Revise los permisos solicitados.
- Aprueba la conexión.
- Regresar al Códice.
No es necesario agregar manualmente una clave API, contraseña o token Notiondesk.
La autenticación se realiza mediante OAuth.
Verificar la conexión
Compruebe sus servidores MCP configurados:
Confirme que notiondesk aparece y está habilitado.
A continuación, puedes iniciar Codex:
Comience con una solicitud de solo lectura:
Confirma que aparecen los centros de ayuda esperados.
Entonces intenta:
Comenzar con solicitudes de solo lectura facilita confirmar que Codex está conectado al espacio de trabajo Notiondesk correcto antes de realizar acciones.
Utilice Workspace MCP de Codex
Una vez conectado, Codex puede utilizar las herramientas disponibles cuando sean relevantes para su tarea.
Por ejemplo:
O:
Si tu rol Notiondesk permite cambios admitidos, también puedes solicitar al Codex que realice las siguientes acciones:
Las acciones disponibles dependen de tu rol Notiondesk y de los centros de ayuda a los que puedes acceder.
Utilice Notiondesk MCP de la extensión Codex IDE.
Codex comparte su configuración MCP entre la CLI y las integraciones IDE compatibles.
Después de configurar Notiondesk con:
El mismo servidor MCP puede estar disponible desde la extensión Codex IDE.
codex mcp listcodexList the Notiondesk help centers I can access.Show the sync status for my main help center.Review the last 30 days of article feedback and analytics. Show me which documentation needs attention first.Review recent chatbot conversations and identify repeated customer questions that are not covered well by our documentation.Trigger a sync for the onboarding collection.codex mcp add notiondesk --url https://mcp.notiondesk.so/mcpSi la extensión ya estaba abierta cuando agregó el servidor, recárguela si no aparece Notiondesk.
Cada conexión Notiondesk autenticada continúa respetando los permisos de su propio espacio de trabajo.
Configure Notiondesk manualmente
Codex almacena su configuración MCP en:
Puede configurar Notiondesk manualmente con:
Tras guardar la configuración, autentíquese con:
Usar codex mcp add suele ser más sencillo que editar la configuración manualmente.
Trabaje con varios centros de ayuda.
Una conexión Codex puede acceder a varios centros de ayuda Notiondesk.
Un centro de ayuda está disponible cuando:
~/.codex/config.toml[mcp_servers.notiondesk]
url = "https://mcp.notiondesk.so/mcp"codex mcp login notiondesk- El MCP de Workspace está habilitado para ello.
- Tu cuenta Notiondesk tiene acceso a ella.
No es necesario configurar un servidor MCP independiente para cada centro de ayuda.
Cuando haya varios centros de ayuda disponibles, especifique con cuál de los Codex debe trabajar:
Permisos
Workspace MCP respeta los permisos de la cuenta Notiondesk utilizada durante la autorización OAuth.
Por ejemplo:
Check the French translation status for the Developer Docs help center.- Los espectadores pueden acceder a la información de solo lectura compatible.
- Los editores pueden realizar acciones de gestión compatibles.
- Los administradores y los propietarios de espacios de trabajo pueden acceder a acciones administrativas adicionales.
Conectar Notiondesk a Codex no otorga a su cuenta permisos adicionales de Notiondesk.
Solución de problemas
Notiondesk no aparece en el Códice
Correr:
Confirma que aparece notiondesk.
Si no funciona, vuelva a agregar el servidor:
codex mcp listcodex mcp add notiondesk --url https://mcp.notiondesk.so/mcp Notiondesk está configurado pero no autenticado.
Correr:
Agregar el servidor MCP y completar la autenticación OAuth son pasos separados.
codex mcp login notiondesk La autenticación OAuth no se abre
Confirme que la URL de Workspace MCP sea:
Entonces, inténtalo de nuevo:
No añada /sse a la URL de MCP del espacio de trabajo.
https://mcp.notiondesk.so/mcpcodex mcp login notiondesk Falta un centro de ayuda
Confirma que:
- Workspace MCP está habilitado para ese centro de ayuda.
- Tu cuenta Notiondesk tiene acceso a ella.
Codex no puede acceder a un centro de ayuda que no está disponible para la cuenta Notiondesk utilizada durante la autorización OAuth.
Algunas herramientas Notiondesk no están disponibles
El MCP del espacio de trabajo sigue su rol Notiondesk.
Si Codex puede leer la información del espacio de trabajo pero no puede realizar ninguna acción, es posible que su cuenta no tenga los permisos necesarios.
Consulte la sección sobre roles, permisos y seguridad de Workspace MCP para obtener más detalles.
El servidor aparece en codex mcp list pero no está disponible en una sesión.
codex mcp list pero no está disponible en una sesión.Inicie una nueva sesión de Codex después de configurar el servidor MCP.
Si utiliza la extensión IDE, vuelva a cargarla después de cambiar la configuración de MCP.
Eliminar Notiondesk MCP
Para eliminar la conexión de Codex, utilice los comandos de administración de MCP disponibles en la versión de Codex que tenga instalada.
También puede eliminar la entrada notiondesk de:
Eliminar la conexión de Codex no desactiva Workspace MCP en Notiondesk y no afecta a otros clientes de IA ni a los compañeros de equipo.
~/.codex/config.toml