Conecte o Workspace MCP Notiondesk ao VS Code

Conecte o MCP do Workspace Notiondesk ao Visual Studio Code para acessar seu workspace Notiondesk a partir das ferramentas de IA do VS Code.

Você pode instalar a conexão diretamente a partir de Notiondesk ou configurar o servidor MCP remoto manualmente.

O Workspace MCP usa OAuth e segue as permissões do membro da equipe Notiondesk que autoriza a conexão.

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.

• Você está usando uma versão do VS Code com suporte a MCP.

Se o Workspace MCP ainda não estiver ativado, consulte Ativar Workspace MCP em Notiondesk .

Conecte Notiondesk a partir do painel de controle

A configuração mais fácil começa em Notiondesk.

1. Abra seu painel de controle Notiondesk

2. Selecione uma central de ajuda onde o Workspace MCP esteja habilitado.

3. Acesse Ajustes → Geral

4. Encontre a seção Workspace MCP

5. Abra o instalador no seu cliente.

6. Selecione VS Code

7. Clique em Adicionar ao VS Code

O VS Code abre os detalhes do servidor MCP Notiondesk.

1. Verifique o nome do servidor e o URL.

2. Clique em Instalar

3. Inicie o servidor se o VS Code solicitar.

4. Conclua a autorização OAuth Notiondesk no seu navegador.

Após a conclusão da autorização, as ferramentas Notiondesk ficam disponíveis no VS Code.

Configure o MCP Notiondesk manualmente

Você também pode configurar o Workspace MCP com o arquivo mcp.json do VS Code.

Para uma conexão específica do projeto, crie ou abra:

Adicionar:

Salve o arquivo.

O VS Code deverá detectar o novo servidor MCP.

Disponibilizar Notiondesk em todos os projetos.

Se você usa o Notiondesk regularmente em diferentes projetos, pode adicionar o servidor ao seu perfil de usuário do VS Code em vez de um único espaço de trabalho.

Abra a Paleta de Comandos e execute:

Adicione o servidor HTTP remoto:

Selecione seu perfil de usuário como destino da configuração.

Um servidor MCP em nível de usuário está disponível em todos os seus espaços de trabalho do VS Code.

Inicie o servidor MCP Notiondesk

Abra a Paleta de Comandos e execute:

Selecione notiondesk .

A partir daí, você pode iniciar, parar, reiniciar ou inspecionar o servidor.

Ao iniciar a conexão pela primeira vez, o VS Code pode solicitar que você confirme que confia no servidor MCP.

Revise a configuração e aprove-a para continuar.

Autenticar com Notiondesk

Quando o VS Code se conecta ao Workspace MCP Notiondesk, ele inicia o fluxo de autorização OAuth.

.vscode/mcp.json

{
  "servers": {
    "notiondesk": {
      "type": "http",
      "url": "https://mcp.notiondesk.so/mcp"
    }
  }
}

MCP: Add Server

https://mcp.notiondesk.so/mcp

MCP: List Servers

Notiondesk abre no seu navegador.

Então:

1. Faça login em Notiondesk se necessário

2. Confirme se o espaço de trabalho correto está sendo exibido.

3. Analise as permissões solicitadas.

4. Aprovar a conexão

5. Voltar ao VS Code

Verifique a conexão

Comece com uma solicitação somente leitura no VS Code:

Confirme se os centros de ajuda esperados foram devolvidos.

Então tente:

Você também pode perguntar:

Ou:

Comece com solicitações somente leitura antes de pedir ao VS Code para realizar alterações.

Use o Workspace MCP do VS Code

Uma vez conectado, o VS Code pode usar as ferramentas Notiondesk disponíveis quando forem relevantes para sua solicitação.

Por exemplo:

Se a sua função Notiondesk permitir ações compatíveis, você também pode perguntar:

As ferramentas disponíveis dependem da sua função Notiondesk e dos centros de ajuda aos quais você tem acesso.

Trabalhe com vários centros de ajuda.

A mesma conexão do VS Code pode acessar várias centrais de ajuda Notiondesk.

Um centro de ajuda está disponível quando:

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 recent chatbot conversations and identify repeated customer questions.

Review article feedback and help center analytics from the last 30 days. Show me which articles need attention first.

Trigger a sync for the onboarding collection.

• O Workspace MCP está habilitado para ele.

• Sua conta Notiondesk tem permissão para acessá-lo.

Você não precisa de uma configuração MCP separada para cada central de ajuda.

Ao utilizar vários centros de ajuda, especifique qual deles você está usando:

Configuração de espaço de trabalho versus configuração de usuário

Utilize uma configuração de espaço de trabalho quando o MCP Notiondesk deve ser configurado apenas para um projeto:

Utilize uma configuração de usuário quando desejar que o MCP Notiondesk esteja disponível em todos os seus espaços de trabalho do VS Code.

Se uma configuração de espaço de trabalho for confirmada no controle de versão, outros membros da equipe poderão receber a mesma definição de servidor MCP, mas cada membro da equipe ainda deverá se autenticar com sua própria conta Notiondesk.

Não compartilhe credenciais OAuth entre membros da equipe.

Solução de problemas

Check the translation status for the Developer Docs help center.

.vscode/mcp.json

MCP: List Servers

{
  "servers": {
    "notiondesk": {
      "type": "http",
      "url": "https://mcp.notiondesk.so/mcp"
    }
  }
}

MCP: List Servers

https://mcp.notiondesk.so/mcp

Desconecte Notiondesk do VS Code

Você pode desativar ou remover o servidor MCP Notiondesk do VS Code quando não quiser mais que ele esteja disponível.

Correr:

Selecione o servidor Notiondesk e desative-o ou remova-o.

Se você configurou manualmente, também pode remover a entrada notiondesk do seu mcp.json.

Remover a conexão do VS Code não desativa o Workspace MCP em Notiondesk e não afeta outros clientes de IA ou colegas de equipe.

MCP: List Servers