Подключите рабочую область MCP Notiondesk к Codex

Подключите Notiondesk Workspace MCP к Codex, пройдите аутентификацию с помощью OAuth и получите доступ к инструментам Notiondesk из интерфейса командной строки Codex или расширения IDE.

2 мин чтения

Подключите Notiondesk Workspace MCP к Codex, чтобы просмотреть информацию о рабочем пространстве и выполнить поддерживаемые действия Notiondesk из интерфейса командной строки Codex или расширения IDE.

Notiondesk работает как удалённый MCP-сервер и использует OAuth для аутентификации вашей учётной записи Notiondesk.

Прежде чем начать

Убеждаться:

  • Для как минимум одного центра поддержки Notiondesk включена функция Workspace MCP.
  • Вы можете войти в рабочую область Notiondesk, к которой хотите подключиться.
  • Codex установлен и работает на вашем компьютере.

Если Workspace MCP еще не включен, см. раздел «Включение Workspace MCP» в Notiondesk .

Добавить Notiondesk MCP в Кодекс

Бегать:

Это добавит сервер MCP рабочей области Notiondesk в вашу конфигурацию Codex.

Аутентификация с помощью Notiondesk

После добавления сервера выполните следующую команду:

Ваш браузер откроет страницу авторизации OAuth Notiondesk.

Затем:

codex mcp add notiondesk --url https://mcp.notiondesk.so/mcp
codex mcp login notiondesk
  1. При необходимости войдите в систему Notiondesk.
  1. Убедитесь, что отображается правильное рабочее пространство.
  1. Проверьте запрошенные разрешения.
  1. Подтвердите подключение.
  1. Вернуться к Кодексу.

Вам не нужно вручную добавлять ключ API Notiondesk, пароль или токен.

Аутентификация осуществляется с помощью OAuth.

Проверьте соединение.

Проверьте настроенные серверы MCP:

Убедитесь, что notiondesk отображается и включен.

После этого вы можете запустить Кодекс:

Начните с запроса только для чтения:

Убедитесь, что ожидаемые центры поддержки отображаются.

Затем попробуйте:

Начиная с запросов только для чтения, проще убедиться, что Codex подключен к правильному рабочему пространству Notiondesk, прежде чем выполнять какие-либо действия.

Используйте Workspace MCP из Codex.

После подключения Codex сможет использовать доступные инструменты Notiondesk, если они актуальны для вашей задачи.

Например:

Или:

Если ваша роль Notiondesk разрешает поддерживаемые изменения, вы также можете запросить у Codex выполнение действий:

Доступные действия зависят от вашей роли в Notiondesk и доступных вам центров поддержки.

Используйте Notiondesk MCP из расширения Codex IDE.

Codex использует общую конфигурацию MCP как для интерфейса командной строки, так и для поддерживаемых IDE-интеграций.

После настройки Notiondesk следующим образом:

Тот же самый сервер MCP может быть доступен через расширение Codex IDE.

codex mcp list
codex
List 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/mcp

Если расширение уже было открыто на момент добавления сервера, перезагрузите его, если Notiondesk не отображается.

Каждое аутентифицированное соединение Notiondesk продолжает использовать права доступа, установленные в вашей рабочей области.

Настройте Notiondesk вручную

Codex хранит свою конфигурацию MCP в следующем месте:

Вы можете настроить Notiondesk вручную с помощью:

После сохранения конфигурации выполните аутентификацию с помощью:

Использовать codex mcp add обычно проще, чем редактировать конфигурацию вручную.

Взаимодействие с несколькими центрами помощи

Одно подключение к Codex может обеспечить доступ к нескольким центрам поддержки Notiondesk.

Центр поддержки доступен в следующих случаях:

~/.codex/config.toml
[mcp_servers.notiondesk]
url = "https://mcp.notiondesk.so/mcp"
codex mcp login notiondesk
  • Для этого включена функция Workspace MCP.
  • Ваш аккаунт Notiondesk имеет к нему доступ.

Для каждого центра поддержки нет необходимости настраивать отдельный сервер MCP.

Если доступно несколько центров поддержки, укажите, с каким из них должен работать Codex:

Разрешения

Workspace MCP использует права доступа учетной записи Notiondesk, применяемой при авторизации OAuth.

Например:

Check the French translation status for the Developer Docs help center.
  • Пользователи могут получить доступ к поддерживаемой информации только для чтения.
  • Редакторы могут выполнять поддерживаемые ими действия по управлению.
  • Администраторы и владельцы рабочих пространств могут получить доступ к дополнительным административным действиям.

Подключение Notiondesk к Codex не предоставляет вашей учетной записи дополнительных прав доступа к Notiondesk.

Поиск неисправностей

Notiondesk не встречается в Кодексе

Бегать:

Убедитесь, что отображается notiondesk.

Если это не поможет, добавьте сервер снова:

codex mcp list
codex mcp add notiondesk --url https://mcp.notiondesk.so/mcp

Notiondesk настроен, но не аутентифицирован.

Бегать:

Добавление сервера MCP и завершение аутентификации OAuth — это отдельные шаги.

codex mcp login notiondesk

Аутентификация OAuth не открывается.

Убедитесь, что URL-адрес рабочей области MCP следующий:

Затем попробуйте еще раз:

Не добавляйте /sse к URL-адресу рабочей области MCP.

https://mcp.notiondesk.so/mcp
codex mcp login notiondesk

Центр поддержки отсутствует.

Подтвердите, что:

  • Для этого справочного центра включена функция Workspace MCP.
  • Ваш аккаунт Notiondesk имеет к нему доступ.

Codex не может получить доступ к центру поддержки, недоступному для учетной записи Notiondesk, использованной во время авторизации OAuth.

Некоторые инструменты Notiondesk недоступны

Рабочая область MCP соответствует вашей роли Notiondesk.

Если Codex может считывать информацию о рабочем пространстве, но не может выполнить действие, возможно, у вашей учетной записи нет необходимых разрешений.

Подробную информацию см. в разделе «Роли, разрешения и безопасность Workspace MCP» .

Сервер отображается в codex mcp list, но недоступен в сессии.

После настройки сервера MCP начните новую сессию Codex.

Если вы используете расширение IDE, перезагрузите его после изменения конфигурации MCP.

Удалить Notiondesk MCP

Для удаления соединения из Codex используйте команды управления MCP, доступные в установленной версии Codex.

Вы также можете удалить запись notiondesk из:

Удаление соединения с Codex не отключает Workspace MCP в Notiondesk и не влияет на другие клиенты ИИ или членов команды.

~/.codex/config.toml

Связанные статьи

Эта страница была полезной?