Puede conectar Notiondesk Workspace MCP a cualquier cliente de IA compatible que admita servidores MCP remotos y autenticación OAuth .
Utilice esta guía cuando su cliente MCP no tenga una guía de instalación dedicada 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.
- Su cliente MCP admite servidores MCP HTTP remotos.
- Su cliente MCP admite la autenticación OAuth.
Si Workspace MCP aún no está habilitado, consulte Habilitar Workspace MCP en Notiondesk .
Detalles de conexión
Utilice estos detalles al agregar Notiondesk a su cliente MCP:
No añada /sse a la URL.
El punto final de Workspace MCP es:
Agregue el servidor MCP
Abra el MCP o la configuración del conector de su cliente de IA.
La interfaz exacta depende del cliente, pero normalmente necesitará:
Name: Notiondesk MCP
URL: https://mcp.notiondesk.so/mcp
Authentication: OAuthhttps://mcp.notiondesk.so/mcp- Agregar un nuevo servidor MCP remoto
- Ingrese Notiondesk MCP como nombre
- Introduzca
https://mcp.notiondesk.so/mcpcomo URL del servidor.
- Seleccione la autenticación OAuth si su cliente solicita un método de autenticación.
- Guardar o conectar el servidor
Si su cliente MCP utiliza un archivo de configuración en lugar de una interfaz de configuración, agregue Notiondesk como un servidor MCP HTTP remoto utilizando la misma URL.
Consulte la documentación MCP de su cliente para conocer el formato de configuración exacto.
Autentícate con Notiondesk
Tras añadir el servidor, inicie el flujo de conexión o autenticación.
Su cliente debe abrir Notiondesk en su navegador.
Entonces:
- Inicie sesión en Notiondesk si es necesario.
- Confirme que se muestra el espacio de trabajo correcto.
- Revisar los permisos solicitados
- Aprobar la conexión
- Regrese a su cliente MCP
Workspace MCP utiliza OAuth, por lo que no debería ser necesario copiar manualmente una contraseña Notiondesk o una clave API en su cliente MCP.
Verificar la conexión
Comience con una solicitud de solo lectura:
Confirma que aparecen los centros de ayuda esperados.
Entonces intenta:
También puedes preguntar:
Comenzar con solicitudes de solo lectura ayuda a confirmar que el cliente está conectado al espacio de trabajo Notiondesk correcto antes de realizar acciones.
Utilice Workspace MCP
Una vez conectado, su cliente MCP puede utilizar las herramientas Notiondesk disponibles para su cuenta.
Por ejemplo:
O:
Si su rol Notiondesk permite cambios admitidos, también puede solicitar acciones como:
La forma exacta en que su cliente descubre o invoca las herramientas de MCP depende del cliente.
Permisos
El MCP del espacio de trabajo sigue los permisos del compañero de equipo Notiondesk que completa la autorización OAuth.
Conectarse a través de otro cliente MCP no cambia sus permisos Notiondesk.
Por ejemplo:
List the Notiondesk help centers I can access.Show the sync status for my main help center.Show me the latest negative article feedback.Review our article feedback and analytics from the last 30 days. Show me which articles need attention first.Check the translation status for my main help center.Trigger a sync for the onboarding collection.- El usuario recibe acceso de solo lectura.
- Un editor puede realizar acciones de gestión compatibles.
- Un administrador o el propietario del espacio de trabajo puede acceder a acciones administrativas adicionales.
El cliente MCP no puede obtener más acceso del que ya tiene su cuenta Notiondesk.
Trabaje con varios centros de ayuda.
Una única conexión a Workspace MCP puede proporcionar acceso a varios centros de ayuda.
Un centro de ayuda está disponible cuando:
- El MCP de Workspace está habilitado para ello.
- Tu cuenta Notiondesk tiene acceso a ella.
No necesita una URL de MCP de espacio de trabajo diferente para cada centro de ayuda.
Se utiliza el mismo punto final:
Cuando haya varios centros de ayuda disponibles, especifique cuál desea que utilice su asistente.
Por ejemplo:
Solución de problemas
https://mcp.notiondesk.so/mcpReview article feedback for the Developer Docs help center. Mi cliente no puede conectarse al servidor.
Confirme que la URL del servidor sea exactamente:
No utilizar:
o agregar /sse al punto final.
Su cliente debe ser compatible con servidores MCP remotos.
https://mcp.notiondesk.so/mcphttps://mcp.notiondesk.so/mcp/sse La autenticación OAuth no se inicia.
Su cliente MCP debe ser compatible con la autenticación OAuth para servidores MCP remotos.
Si el cliente solo admite servidores MCP locales, claves API o encabezados estáticos, es posible que no sea compatible con Workspace MCP.
Consulte la documentación MCP de su cliente.
Falta un centro de ayuda
Confirma que:
- Workspace MCP está habilitado para ese centro de ayuda.
- Tu cuenta Notiondesk tiene acceso a ella.
Workspace MCP no puede mostrar un centro de ayuda al que su cuenta no pueda acceder.
Algunas herramientas no están disponibles
Las herramientas de MCP de Workspace disponibles dependen de su rol Notiondesk.
Su cliente MCP también puede aplicar sus propias restricciones sobre las herramientas que se pueden utilizar.
Consulte la sección sobre roles, permisos y seguridad de Workspace MCP para obtener más detalles.
La conexión funciona, pero las herramientas no se utilizan automáticamente.
La selección de las herramientas MCP depende del cliente de IA.
Algunos clientes requieren que usted:
- Habilitar el servidor MCP para una conversación
- Seleccione el conector manualmente
- Habilitar el uso de la herramienta
- Aprobar acciones individuales
Compruebe la configuración de MCP de su cliente si la conexión Notiondesk está activa pero sus herramientas no están disponibles en las conversaciones.