Conecte o Workspace MCP Notiondesk ao Claude Code para revisar as informações do espaço de trabalho e executar ações compatíveis com Notiondesk diretamente do seu terminal.
Claude Code se conecta a Notiondesk como um servidor HTTP MCP remoto e se autentica por meio do OAuth.
Antes de começar
Certificar-se:
- O Workspace MCP está habilitado para pelo menos um centro de ajuda Notiondesk
- Você pode entrar no espaço de trabalho Notiondesk ao qual deseja se conectar.
- O Claude Code está instalado e funcionando no seu computador.
Se o Workspace MCP ainda não estiver ativado, consulte Ativar Workspace MCP em Notiondesk .
Adicione Notiondesk MCP ao código Claude
Correr:
Isso adiciona o servidor MCP do Workspace Notiondesk ao Claude Code.
Disponibilizar Notiondesk em todos os projetos.
Se você deseja usar o MCP Notiondesk em todos os projetos do Claude Code, adicione-o com escopo de usuário:
Use o escopo de projeto ou local se desejar que a conexão esteja disponível apenas em um ambiente de desenvolvimento específico.
Autenticar com Notiondesk
Após adicionar o servidor, inicie o Claude Code:
Em seguida, digite:
Selecione o servidor notiondesk e inicie o fluxo de autenticação.
Claude Code abre Notiondesk no seu navegador.
Então:
claude mcp add --transport http notiondesk https://mcp.notiondesk.so/mcpclaude mcp add --transport http --scope user notiondesk https://mcp.notiondesk.so/mcpclaude/mcp- Faça login em Notiondesk se necessário.
- Confirme se o espaço de trabalho correto está sendo exibido.
- Analise as permissões solicitadas.
- Aprovar a conexão.
- Voltar ao Código Claude.
Claude Code armazena a autenticação OAuth da conexão e pode atualizá-la quando necessário.
Verifique o servidor MCP
Você pode verificar os servidores MCP configurados a partir do seu terminal:
Você também pode inspecionar o servidor Notiondesk:
Em seguida, inicie o Claude Code e teste a conexão com:
Confirme se os centros de ajuda esperados aparecem.
Em seguida, tente:
Começar com solicitações somente leitura ajuda a confirmar se o Claude Code está conectado ao espaço de trabalho Notiondesk correto.
Use Notiondesk do código Claude
Uma vez conectado, o Claude Code pode usar as ferramentas Notiondesk disponíveis quando forem relevantes para sua solicitação.
Por exemplo:
Ou:
Se a sua função Notiondesk permitir alterações, você também pode solicitar que Claude Code execute as ações compatíveis:
As ações disponíveis para Claude Code dependem das permissões do seu espaço de trabalho Notiondesk.
Trabalhe com vários centros de ajuda.
A mesma conexão do código Claude pode acessar vários centros de ajuda Notiondesk.
Um centro de ajuda está disponível quando:
claude mcp listclaude mcp get notiondeskList 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.- O Workspace MCP está habilitado para isso.
- Sua conta Notiondesk tem acesso a isso.
Não é necessário configurar um servidor MCP separado para cada central de ajuda.
Quando houver várias centrais de ajuda disponíveis, especifique aquela que você deseja que Claude Code utilize.
Por exemplo:
Escolha o escopo correto do Código Claude.
O Claude Code suporta diferentes escopos para servidores MCP.
Escopo local
O escopo local é o padrão.
Use-o quando precisar apenas do MCP Notiondesk no projeto atual.
Escopo do projeto
Use o escopo do projeto quando a configuração do MCP precisar ser compartilhada com os membros da equipe por meio da configuração .mcp.json do projeto.
Cada membro da equipe ainda se autentica com sua própria conta Notiondesk.
Não compartilhe credenciais OAuth entre membros da equipe.
Escopo do usuário
Use o escopo de usuário quando quiser que Notiondesk esteja disponível em todos os projetos do Claude Code no seu computador:
Para a maioria das pessoas que gerenciam regularmente o Notiondesk a partir do Claude Code, o escopo de usuário é a opção mais conveniente.
Permissões
O Workspace MCP segue as permissões do membro da equipe Notiondesk que conclui a autorização OAuth.
Por exemplo:
Check the French translation status for the Developer Docs help center.claude mcp add --transport http notiondesk https://mcp.notiondesk.so/mcpclaude mcp add --transport http --scope project notiondesk https://mcp.notiondesk.so/mcpclaude mcp add --transport http --scope user notiondesk https://mcp.notiondesk.so/mcp- Um visualizador pode usar ferramentas somente leitura compatíveis.
- Um editor pode acessar ações de gerenciamento compatíveis.
- Um administrador ou proprietário do espaço de trabalho pode acessar ações administrativas adicionais.
Adicionar o MCP Notiondesk a um projeto compartilhado não compartilha as permissões Notiondesk de um membro da equipe com todos os outros.
Cada membro da equipe se autentica separadamente.
Solução de problemas
Claude Code não consegue encontrar o servidor MCP Notiondesk
Correr:
Confirme se notiondesk aparece.
Caso contrário, adicione novamente:
claude mcp listclaude mcp add --transport http notiondesk https://mcp.notiondesk.so/mcp A autenticação OAuth não inicia.
Abra o código Claude e digite:
Selecione o servidor Notiondesk e inicie a autenticação.
Caso seu navegador não abra automaticamente, Claude Code poderá fornecer um URL que você poderá abrir manualmente.
/mcp O servidor Notiondesk foi adicionado, mas não autenticado.
Usar:
Em seguida, selecione o servidor Notiondesk e conclua o fluxo OAuth.
Adicionar o servidor MCP e autenticar sua conta Notiondesk são etapas separadas.
/mcp Falta um centro de ajuda.
Confirme que:
- O Workspace MCP está habilitado para essa central de ajuda.
- Sua conta Notiondesk tem acesso a isso.
Claude Code não consegue acessar uma central de ajuda que não está disponível para a conta usada durante a autorização OAuth.
Algumas ações não estão disponíveis.
O Workspace MCP segue sua função Notiondesk.
Se Claude Code consegue ler informações, mas não consegue executar uma determinada ação, sua conta pode não ter a permissão necessária.
Consulte Funções, permissões e segurança do Workspace MCP para obter detalhes.
A autenticação parou de funcionar.
Abrir:
Selecione o servidor Notiondesk e autentique-se novamente.
Você também pode limpar a autenticação existente no menu MCP antes de se reconectar.
/mcpRemover Notiondesk MCP
Para remover o servidor do Claude Code:
Remover o servidor do Claude Code não desativa o Workspace MCP em Notiondesk e não afeta as conexões de outros clientes de IA.
claude mcp remove notiondesk