Conecte o Workspace MCP ao Codex para revisar as informações do espaço de trabalho e executar ações compatíveis com o Workspace MCP a partir da CLI do Codex ou da extensão IDE.
Notiondesk funciona como um servidor MCP remoto e usa OAuth para autenticar sua conta Notiondesk.
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 Codex está instalado e funcionando no seu computador.
Se o Workspace MCP ainda não estiver ativado, consulte Ativar Workspace MCP em Notiondesk .
Adicionar Notiondesk MCP ao Codex
Correr:
Isso adiciona o servidor MCP do Workspace Notiondesk à sua configuração do Codex.
Autenticar com Notiondesk
Após adicionar o servidor, execute:
Seu navegador abre a página de autorização OAuth Notiondesk.
Então:
codex mcp add notiondesk --url https://mcp.notiondesk.so/mcpcodex mcp login notiondesk- 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ódice.
Você não precisa adicionar manualmente uma chave de API, senha ou token Notiondesk.
A autenticação é feita através do OAuth.
Verifique a conexão
Verifique seus servidores MCP configurados:
Confirme se notiondesk aparece e está ativado.
Em seguida, você pode iniciar o Codex:
Comece com uma solicitação somente leitura:
Confirme se os centros de ajuda esperados aparecem.
Então tente:
Começar com solicitações somente leitura facilita a confirmação de que o Codex está conectado ao espaço de trabalho Notiondesk correto antes de executar ações.
Utilize o Workspace MCP do Codex
Uma vez conectado, o Codex pode usar as ferramentas Notiondesk disponíveis quando forem relevantes para sua tarefa.
Por exemplo:
Ou:
Se a sua função Notiondesk permitir alterações compatíveis, você também pode solicitar que o Codex execute ações:
As ações disponíveis dependem da sua função Notiondesk e dos centros de ajuda aos quais você tem acesso.
Use Notiondesk MCP da extensão Codex IDE
O Codex compartilha sua configuração MCP entre a CLI e as integrações de IDE suportadas.
Após configurar Notiondesk com:
O mesmo servidor MCP pode ser acessado pela extensão Codex IDE.
codex mcp listcodexList the Notiondesk help centers I can access.Show the sync status for my main help center.Review the last 30 days of article feedback and analytics. Show me which documentation needs attention first.Review recent chatbot conversations and identify repeated customer questions that are not covered well by our documentation.Trigger a sync for the onboarding collection.codex mcp add notiondesk --url https://mcp.notiondesk.so/mcpSe a extensão já estava aberta quando você adicionou o servidor, recarregue-a caso Notiondesk não apareça.
Cada conexão autenticada Notiondesk continua a seguir as permissões do seu próprio espaço de trabalho.
Configure Notiondesk manualmente
O Codex armazena sua configuração MCP em:
Você pode configurar Notiondesk manualmente com:
Após salvar a configuração, autentique-se com:
Usar codex mcp add geralmente é mais simples do que editar a configuração manualmente.
Trabalhe com vários centros de ajuda.
Uma única conexão Codex pode acessar vários centros de ajuda Notiondesk.
Um centro de ajuda está disponível quando:
~/.codex/config.toml[mcp_servers.notiondesk]
url = "https://mcp.notiondesk.so/mcp"codex mcp login notiondesk- O Workspace MCP está habilitado para ele.
- 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 com qual delas o Codex deve trabalhar:
Permissões
O Workspace MCP segue as permissões da conta Notiondesk usada durante a autorização OAuth.
Por exemplo:
Check the French translation status for the Developer Docs help center.- Os visualizadores podem acessar informações somente leitura compatíveis.
- Os editores podem executar ações de gerenciamento com suporte.
- Administradores e proprietários de espaços de trabalho podem acessar ações administrativas adicionais.
Conectar Notiondesk ao Codex não concede à sua conta permissões adicionais de Notiondesk.
Solução de problemas
Notiondesk não aparece no Codex
Correr:
Confirme se notiondesk aparece.
Caso contrário, adicione o servidor novamente:
codex mcp listcodex mcp add notiondesk --url https://mcp.notiondesk.so/mcp Notiondesk está configurado, mas não autenticado.
Correr:
Adicionar o servidor MCP e concluir a autenticação OAuth são etapas separadas.
codex mcp login notiondesk A autenticação OAuth não abre.
Confirme se a URL do Workspace MCP é:
Em seguida, tente novamente:
Não adicione /sse ao URL do Workspace MCP.
https://mcp.notiondesk.so/mcpcodex mcp login notiondesk 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 Codex não consegue acessar uma central de ajuda que não está disponível para a conta Notiondesk usada durante a autorização OAuth.
Algumas ferramentas Notiondesk estão indisponíveis
O Workspace MCP segue sua função Notiondesk.
Se o Codex consegue ler as informações do espaço de trabalho, mas não consegue executar uma 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.
O servidor aparece em codex mcp list, mas não está disponível em uma sessão.
codex mcp list, mas não está disponível em uma sessão.Inicie uma nova sessão do Codex após configurar o servidor MCP.
Se você utiliza a extensão IDE, recarregue-a após alterar a configuração do seu MCP.
Remover Notiondesk MCP
Para remover a conexão do Codex, utilize os comandos de gerenciamento MCP disponíveis na versão do Codex instalada em sua instalação.
Você também pode remover a entrada notiondesk de:
Remover a conexão Codex não desativa o Workspace MCP em Notiondesk e não afeta outros clientes de IA ou colegas de equipe.
~/.codex/config.toml