Conectar el espacio de trabajo MCP Notiondesk con Claude Code

Conecta Notiondesk Workspace MCP a Claude Code desde tu terminal, autentícate con OAuth y usa las herramientas Notiondesk directamente desde Claude Code.

5 min de lectura

Conecte el MCP del espacio de trabajo Notiondesk a Claude Code para revisar la información del espacio de trabajo y realizar las acciones compatibles con Notiondesk directamente desde su terminal.

Claude Code se conecta a Notiondesk como un servidor MCP HTTP remoto y se autentica a través de OAuth.

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.
  • Claude Code 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 código de Claude

Correr:

Esto agrega el servidor MCP del espacio de trabajo Notiondesk a Claude Code.

Hacer que Notiondesk esté disponible en todos los proyectos.

Si desea utilizar Notiondesk MCP desde todos los proyectos de Claude Code, agréguelo con ámbito de usuario:

Si solo desea que la conexión esté disponible en un entorno de desarrollo específico, utilice el ámbito del proyecto o el ámbito local.

Autentícate con Notiondesk

Después de agregar el servidor, inicie Claude Code:

Luego ingrese:

Seleccione el servidor notiondesk e inicie el flujo de autenticación.

Claude Code abre Notiondesk en tu navegador.

Entonces:

claude mcp add --transport http notiondesk https://mcp.notiondesk.so/mcp
claude mcp add --transport http --scope user notiondesk https://mcp.notiondesk.so/mcp
claude
/mcp
  1. Inicie sesión en Notiondesk si es necesario.
  1. Confirme que se muestra el espacio de trabajo correcto.
  1. Revise los permisos solicitados.
  1. Aprueba la conexión.
  1. Regresar a Claude Code.

Claude Code almacena la autenticación OAuth para la conexión y puede actualizarla cuando sea necesario.

Verifique el servidor MCP

Puedes comprobar los servidores MCP configurados desde tu terminal:

También puede inspeccionar el servidor Notiondesk:

Luego, inicie Claude Code y pruebe la conexión con:

Confirma que aparecen los centros de ayuda esperados.

A continuación, prueba lo siguiente:

Comenzar con solicitudes de solo lectura ayuda a confirmar que Claude Code está conectado al espacio de trabajo Notiondesk correcto.

Utilice Notiondesk del código de Claude

Una vez conectado, Claude Code puede utilizar las herramientas disponibles de Notiondesk cuando sean relevantes para su solicitud.

Por ejemplo:

O:

Si tu rol Notiondesk permite cambios, también puedes pedirle a Claude Code que realice las acciones admitidas:

Las acciones disponibles para Claude Code dependen de los permisos de su espacio de trabajo Notiondesk.

Trabaje con varios centros de ayuda.

La misma conexión de Claude Code puede acceder a múltiples centros de ayuda Notiondesk.

Un centro de ayuda está disponible cuando:

claude mcp list
claude mcp get notiondesk
List the Notiondesk help centers I can access.
Show the sync status for my main help center.
Review recent article feedback and search analytics. Show me which documentation needs attention first.
Review recent chatbot conversations and identify repeated questions that are not covered well by our help center.
Trigger a sync for the onboarding collection.
  • Workspace MCP 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 cuál desea que utilice Claude Code.

Por ejemplo:

Elija el alcance correcto del código Claude

Claude Code admite diferentes ámbitos para los servidores MCP.

Alcance local

El ámbito local es el predeterminado.

Úselo cuando solo necesite Notiondesk MCP en el proyecto actual.

Alcance del proyecto

Utilice el ámbito del proyecto cuando la configuración de MCP deba compartirse con los compañeros de equipo a través de la configuración .mcp.json del proyecto.

Cada miembro del equipo sigue autenticándose con su propia cuenta Notiondesk.

No compartas las credenciales de OAuth entre tus compañeros de equipo.

Ámbito de usuario

Utilice el ámbito de usuario cuando desee que Notiondesk esté disponible en todos los proyectos de Claude Code de su ordenador:

Para la mayoría de las personas que administran regularmente Notiondesk desde Claude Code, el ámbito de usuario es la opción más conveniente.

Permisos

El MCP del espacio de trabajo sigue los permisos del compañero de equipo Notiondesk que completa la autorización OAuth.

Por ejemplo:

Check the French translation status for the Developer Docs help center.
claude mcp add --transport http notiondesk https://mcp.notiondesk.so/mcp
claude mcp add --transport http --scope project notiondesk https://mcp.notiondesk.so/mcp
claude mcp add --transport http --scope user notiondesk https://mcp.notiondesk.so/mcp
  • Un visor puede utilizar herramientas de solo lectura compatibles.
  • Un editor puede acceder a las acciones de administración compatibles.
  • Un administrador o propietario del espacio de trabajo puede acceder a acciones administrativas adicionales.

Agregar Notiondesk MCP a un proyecto compartido no comparte los permisos Notiondesk de un compañero de equipo con todos los demás.

Cada miembro del equipo se autentica por separado.

Solución de problemas

Claude Code no puede encontrar el servidor MCP Notiondesk

Correr:

Confirma que aparece notiondesk.

Si no es así, agréguelo de nuevo:

claude mcp list
claude mcp add --transport http notiondesk https://mcp.notiondesk.so/mcp

La autenticación OAuth no se inicia.

Abre Claude Code e introduce:

Seleccione el servidor Notiondesk e inicie la autenticación.

Si su navegador no se abre automáticamente, Claude Code puede proporcionarle una URL que puede abrir manualmente.

/mcp

El servidor Notiondesk se ha añadido pero no se ha autenticado.

Usar:

Luego, seleccione el servidor Notiondesk y complete el flujo de OAuth.

Agregar el servidor MCP y autenticar su cuenta Notiondesk son pasos separados.

/mcp

Falta un centro de ayuda

Confirma que:

  • Workspace MCP está habilitado para ese centro de ayuda.
  • Tu cuenta Notiondesk tiene acceso a ella.

Claude Code no puede acceder a un centro de ayuda que no está disponible para la cuenta utilizada durante la autorización OAuth.

Algunas acciones no están disponibles.

El MCP del espacio de trabajo sigue su rol Notiondesk.

Si Claude Code puede leer información pero no puede realizar una acción específica, es posible que su cuenta no tenga el permiso necesario.

Consulte la sección sobre roles, permisos y seguridad de Workspace MCP para obtener más detalles.

La autenticación deja de funcionar.

Abierto:

Seleccione el servidor Notiondesk y autentíquese de nuevo.

También puede borrar la autenticación existente desde el menú MCP antes de volver a conectarse.

/mcp

Eliminar Notiondesk MCP

Para eliminar el servidor de Claude Code:

Eliminar el servidor de Claude Code no desactiva Workspace MCP en Notiondesk y no afecta las conexiones de otros clientes de IA.

claude mcp remove notiondesk

Artículos relacionados

¿Fue útil esta página?