Você pode conectar o Workspace MCP Notiondesk a qualquer cliente AI compatível que suporte servidores MCP remotos e autenticação OAuth .
Use este guia quando o seu cliente MCP não tiver um guia de instalação Notiondesk dedicado.
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.
- Seu cliente MCP oferece suporte a servidores MCP HTTP remotos.
- Seu cliente MCP oferece suporte à autenticação OAuth.
Se o Workspace MCP ainda não estiver ativado, consulte Ativar Workspace MCP em Notiondesk .
Detalhes da conexão
Utilize estas informações ao adicionar Notiondesk ao seu cliente MCP:
Não adicione /sse ao URL.
O endpoint do Workspace MCP é:
Adicione o servidor MCP
Abra as configurações do MCP ou do conector do seu cliente de IA.
A interface exata depende do cliente, mas normalmente você precisará:
Name: Notiondesk MCP
URL: https://mcp.notiondesk.so/mcp
Authentication: OAuthhttps://mcp.notiondesk.so/mcp- Adicionar um novo servidor MCP remoto
- Digite Notiondesk MCP como nome
- Insira
https://mcp.notiondesk.so/mcpcomo URL do servidor
- Selecione a autenticação OAuth se o seu cliente solicitar um método de autenticação.
- Salvar ou conectar ao servidor
Se o seu cliente MCP utiliza um arquivo de configuração em vez de uma interface de configurações, adicione Notiondesk como um servidor MCP HTTP remoto usando a mesma URL.
Consulte a documentação do MCP do seu cliente para obter o formato de configuração exato.
Autenticar com Notiondesk
Após adicionar o servidor, inicie o fluxo de conexão ou autenticação.
Seu cliente deve abrir Notiondesk no seu navegador.
Então:
- 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
- Retorne ao seu cliente MCP
O Workspace MCP usa OAuth, portanto, você não deve precisar copiar manualmente uma senha Notiondesk ou chave de API para o seu cliente MCP.
Verifique a conexão
Comece com uma solicitação somente leitura:
Confirme se os centros de ajuda esperados aparecem.
Então tente:
Você também pode perguntar:
Começar com solicitações somente leitura ajuda a confirmar se o cliente está conectado ao espaço de trabalho Notiondesk correto antes de executar ações.
Use o Workspace MCP
Uma vez conectado, seu cliente MCP poderá usar as ferramentas Notiondesk disponíveis em sua conta.
Por exemplo:
Ou:
Se a sua função Notiondesk permitir alterações suportadas, você também poderá solicitar ações como:
A forma exata como seu cliente descobre ou invoca as ferramentas MCP depende do cliente.
Permissões
O Workspace MCP segue as permissões do membro da equipe Notiondesk que conclui a autorização OAuth.
Conectar-se por meio de outro cliente MCP não altera suas permissões Notiondesk.
Por exemplo:
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.- O visualizador recebe acesso somente leitura com suporte.
- Um editor pode executar ações de gerenciamento suportadas.
- Um administrador ou proprietário do espaço de trabalho pode acessar ações administrativas adicionais.
O cliente MCP não pode obter mais acesso do que sua conta Notiondesk já possui.
Trabalhe com vários centros de ajuda.
Uma única conexão Workspace MCP pode fornecer acesso a vários centros de ajuda.
Um centro de ajuda está disponível quando:
- O Workspace MCP está habilitado para ele.
- Sua conta Notiondesk tem acesso a isso.
Você não precisa de um URL do Workspace MCP diferente para cada central de ajuda.
O mesmo ponto final é utilizado:
Quando houver várias centrais de ajuda disponíveis, especifique aquela que você deseja que seu assistente utilize.
Por exemplo:
Solução de problemas
https://mcp.notiondesk.so/mcpReview article feedback for the Developer Docs help center. Meu cliente não consegue se conectar ao servidor.
Confirme se o URL do servidor é exatamente o seguinte:
Não utilize:
ou adicione /sse ao ponto de extremidade.
Seu cliente deve oferecer suporte a servidores MCP remotos.
https://mcp.notiondesk.so/mcphttps://mcp.notiondesk.so/mcp/sse A autenticação OAuth não inicia.
Seu cliente MCP deve suportar autenticação OAuth para servidores MCP remotos.
Se o cliente suportar apenas servidores MCP locais, chaves de API ou cabeçalhos estáticos, poderá não ser compatível com o Workspace MCP.
Verifique a documentação do MCP do seu cliente.
Falta um centro de ajuda.
Confirme que:
- O Workspace MCP está habilitado para essa central de ajuda.
- Sua conta Notiondesk tem acesso a isso.
O Workspace MCP não pode disponibilizar uma central de ajuda à qual sua conta não tenha acesso.
Algumas ferramentas não estão disponíveis.
As ferramentas MCP disponíveis no Workspace dependem da sua função Notiondesk.
Seu cliente MCP também pode aplicar suas próprias restrições quanto às ferramentas que podem ser usadas.
Consulte Funções, permissões e segurança do Workspace MCP para obter detalhes.
A conexão funciona, mas as ferramentas não são usadas automaticamente.
A seleção das ferramentas MCP depende do cliente de IA.
Alguns clientes exigem que você:
- Habilite o servidor MCP para uma conversa.
- Selecione o conector manualmente
- Habilitar o uso da ferramenta
- Aprovar ações individuais
Verifique as configurações do MCP do seu cliente se a conexão Notiondesk estiver ativa, mas as ferramentas não estiverem disponíveis nas conversas.