Підключення Course Creator MCP у Codex

Ця інструкція призначена для співробітника, який працює у Codex і має створювати уроки MebliPoint через Course Creator MCP. Repository MebliPoint, Node.js, Supabase keys і ручне редагування серверного коду не потрібні.

Що потрібно до початку

встановлений та авторизований Codex;
MebliPoint account з роллю super_admin для поточного pilot;
дані входу, отримані від адміністратора через окремий безпечний канал.

Не вставляйте пароль MebliPoint у prompt, config.toml, повідомлення чату або MCP arguments.

Найпростіший спосіб: доручити налаштування агенту

Відкрийте будь-який робочий чат Codex і передайте агенту цей prompt:

Підключи до мого Codex remote MebliPoint Course Creator MCP через OAuth.

Endpoint:
https://meblipoint.com.ua/api/mcp/course-creator

Працюй тільки з моїм user-level Codex config.toml. Спочатку прочитай поточний файл і збережи всі наявні налаштування та MCP servers. Додай або онови тільки цю секцію:

[mcp_servers.meblipoint_course_creator_remote]
url = "https://meblipoint.com.ua/api/mcp/course-creator"
oauth_resource = "https://meblipoint.com.ua/api/mcp/course-creator"
scopes = ["openid", "email", "profile"]
required = false
default_tools_approval_mode = "writes"
startup_timeout_sec = 30
tool_timeout_sec = 300

Не додавай PAT, bearer_token_env_var, Authorization header, пароль MebliPoint, Supabase keys або service-role credentials. Не змінюй repository MebliPoint. Після запису покажи, який server додано, і нагадай мені повністю перезапустити Codex та відкрити новий чат. Не викликай write tools.

Якщо Codex попросить дозвіл на зміну user-level config.toml, підтвердьте саме цю вузьку операцію. Агент повинен доповнити наявний файл, а не замінити його.

required = false не вимикає Course Creator. Справний server залишається доступним, але його OAuth-помилка не блокує unrelated чати Codex. Для задачі зі створення курсу це не дозвіл працювати без MCP: агент спочатку перевіряє tools і виконує read-only smoke, а за їх відсутності зупиняється з ясним повідомленням. Scopes, роль super_admin і write approvals залишаються обов'язковими.

Що зробити після запису конфігурації

Повністю закрийте Codex і запустіть його знову.
Після перезапуску створіть новий чат. Чати, відкриті до додавання MCP, можуть зберігати старий список інструментів.
Відкрийте Settings → Plugins → MCP.
Знайдіть meblipoint_course_creator_remote.
Натисніть Authenticate.
Якщо кнопка Authenticate одразу не з'явилася, закрийте Settings і відкрийте цей розділ ще раз. Якщо це не допомогло, ще раз повністю перезапустіть Codex.
У вікні авторизації увійдіть до MebliPoint під account з роллю super_admin і підтвердьте доступ.
Після успішної авторизації відкрийте ще один новий чат, щоб він гарантовано отримав актуальний MCP tool snapshot.

Обов'язковий fail-visible контракт задачі

required = false захищає загальні чати, але не дозволяє задачі Course Creator непомітно працювати без MCP. Перше повідомлення кожної окремої задачі створення курсу або уроку має вимагати preflight до аналізу, пошуку джерел, планування або авторингу:

Перевірити presence server/namespace і course_creator_get_instructions.
Викликати тільки цей read-only tool.
Якщо namespace/tool відсутній або call failed, показати точний deterministic status:

⛔ Course Creator MCP недоступний — курс не створюється

Після цього зупинитися. Silent fallback, fabricated answer, local substitute і будь-які Academy effects до MCP PREFLIGHT PASS заборонені.

Copy-paste starter prompt для Дениса

Це окрема задача Course Creator. До будь-якого аналізу, планування або створення уроку виконай обов'язковий MCP preflight.

1. Перевір, що доступний MCP namespace/server meblipoint_course_creator_remote і tool course_creator_get_instructions.
2. Нічого не створюй і не змінюй. Виклич тільки course_creator_get_instructions.
3. Якщо namespace/tool відсутній або виклик завершився помилкою, виведи окремим рядком точно:
⛔ Course Creator MCP недоступний — курс не створюється
Після цього зупинися. Не використовуй silent fallback, локальну підміну, вигадані дані або Academy tools.
4. Якщо виклик успішний, виведи MCP PREFLIGHT PASS, версії remote MCP, contract bundle і block catalog, кількість доступних tools та authentication method. Зупинися й дочекайся мого опису курсу.

Перша безпечна перевірка

У новому чаті передайте:

Використай тільки MCP server meblipoint_course_creator_remote.
Нічого не створюй і не змінюй.
Покажи кількість і назви доступних інструментів.
Виклич course_creator_get_instructions.
Повідом exact версії remote MCP, contract bundle та block catalog.
Підтвердь, що автентифікація пройшла через OAuth, а не через PAT.
Обмеження «тільки MCP» діє лише в цьому read-only preflight і завершується
після відповіді. Воно не забороняє дозволені client tools у подальшій роботі.

Очікуваний результат:

prominent MCP PREFLIGHT PASS;
21 MCP tools;
remote_course_creator_mcp_v1_8;
course_creator_contract_bundle_v0_12;
course_creator_execution_protocol_v0_4;
native_lesson_block_catalog_v0_1;
authentication method: OAuth.

Якщо щось не видно

Server є у config.toml, але його немає в Plugins/MCP: повністю перезапустіть Codex і відкрийте новий чат.
Server видно, але немає Authenticate: закрийте Settings і відкрийте його повторно.
Авторизація завершилась, але старий чат не бачить tools: створіть новий чат.
Відповідь 401: OAuth flow не завершений або credential застарів.
Відповідь 403: account не має дозволеної ролі MebliPoint.

До успішної read-only перевірки не просіть агента створювати, завантажувати або публікувати урок.

Глобальний optional і окремий strict project

У глобальному ~/.codex/config.toml залишайте required = false: збій Course Creator не повинен блокувати звичайні задачі.
Для окремої trusted folder/project, призначеної тільки для створення курсів, допустимо додати повну OAuth configuration до .codex/config.toml цієї folder з required = true. Strict failure тоді обмежений цим project.
Не додавайте strict override до загального MebliPoint repository або shared user config.
Codex CLI підтримує окремі config profiles через --profile, але для звичайного Desktop workflow цей спосіб не є основною інструкцією й тут не налаштовується.

Якщо OAuth credential застарів

Помилка refresh token, invalid_grant або повторний failure під час resume може означати, що стара задача Codex утримує stale credential. Простий toggle server не завжди оновлює цей стан. Виконайте:

codex mcp logout meblipoint_course_creator_remote
codex mcp login meblipoint_course_creator_remote

Після browser consent повністю перезапустіть Codex і відкрийте нову задачу. Спочатку повторіть read-only перевірку з попереднього розділу. Якщо MCP tools все ще недоступні, зупиніть створення курсу й повідомте адміністратору exact помилку без token value або інших credentials.

Пов'язані статті

Підключення агента до Course Creator