Как сделать мини-приложение в ChatGPT? Инструкция для новичков

Зарегистрируйтесь или войдите в свой аккаунт на сайте OpenAI → platform.openai.com

В панели управления (Dashboard) найдите раздел API Keys (Ключи API) — обычно в меню слева или через страницу аккаунта.

Нажмите кнопку Create new secret key (Создать новый секретный ключ)

Дайте ключу имя, по которому вы потом вспомните, для чего он был создан (например, “MyChatGPTAppKey”)

Система покажет вам сам ключ — длинную строку символов. Скопируйте его и сохраните в безопасном месте (т.к. позже вы его уже не увидите).

Коротко: сервер — это ваш «исполнитель», к которому ChatGPT шлёт задания. Ниже самый простой путь: локально поднять сервер на Node.js, проверить его руками, выдать ему публичный адрес через ngrok и подключить в ChatGPT. Всё простыми шагами и с готовым кодом.

1) Что поставить заранее

Node.js LTS: установите с nodejs.org.

Git (удобно, но не обязательно).

Ngrok: создаёт публичный HTTPS-адрес к вашему локальному серверу.

Проверка:

node -v
npm -v
ngrok version

2) Создаём минимальный сервер

Это «болванка», которая принимает команду и что-то делает. Начнём без сложного протокола — просто HTTP JSON. Так вы увидите механику. Позже это место займёт реализация под ChatGPT Apps SDK/MCP.

mkdir my-chatgpt-app && cd my-chatgpt-app
npm init -y
npm i express cors

Создайте файл server.js:

// server.js
const express = require(‘express’);
const cors = require(‘cors’);
const app = express();

app.use(cors());
app.use(express.json());

// «Каталог инструментов» — список того, что умеет ваш сервер.
// ChatGPT (или вы) можете спросить: какие есть действия?
app.get(‘/tools’, (req, res) => {
res.json({
tools: [
{
name: ‘createTask’,
description: ‘Создаёт задачу с названием и сроком’,
inputSchema: { type: ‘object’, required: [‘title’, ‘dueDate’] }
},
{
name: ‘listTasks’,
description: ‘Возвращает список задач’,
inputSchema: { type: ‘object’, required: [] }
}
]
});
});

// Пространство для «инструментов».
// 1) createTask — принимает данные и «создаёт» задачу (демо-логика).
const tasks = []; // простая память в ОЗУ

app.post(‘/tool/createTask’, (req, res) => {
const { title, dueDate } = req.body || {};
if (!title || !dueDate) {
return res.status(400).json({ error: ‘Нужны title и dueDate’ });
}
const task = { id: String(Date.now()), title, dueDate, status: ‘open’ };
tasks.push(task);
res.json({ ok: true, task });
});

// 2) listTasks — отдаёт список задач
app.post(‘/tool/listTasks’, (req, res) => {
res.json({ ok: true, tasks });
});

// Технический пинг-поинт — удобно для мониторинга/проверок
app.get(‘/health’, (_req, res) => res.json({ status: ‘ok’ }));

// Запуск сервера
const PORT = process.env.PORT || 8000;
app.listen(PORT, () => {
console.log(Server on http://localhost:${PORT});
});

Запуск:

node server.js

Проверьте в браузере:

http://localhost:8000/health → должен вернуть { status: «ok» }

http://localhost:8000/tools → должен вернуть список «инструментов»

Проверьте руками запросы (например, через curl или Postman):

Создать задачу:

curl -X POST http://localhost:8000/tool/createTask \
-H «Content-Type: application/json» \
-d ‘{«title»:»Подготовить отчёт»,»dueDate»:»2025-10-12″}’

Получить список задач:

curl -X POST http://localhost:8000/tool/listTasks

Если это сработало, у вас есть «исполнитель»: он принимает команду, делает действие и отдаёт результат.

Пояснение терминов на бытовом языке:

Эндпоинт — это «окошко» в вашем сервере по конкретному URL, куда можно постучаться с запросом.

Инструмент — одна конкретная способность (функция), например «создай задачу».

Тело запроса (JSON) — содержимое записки, которую вы кладёте в «окошко».

3) Даём серверу публичный адрес

ChatGPT не видит ваш локальный localhost. Ему нужен публичный HTTPS-адрес. Для разработки удобно использовать ngrok.

Откройте второй терминал:

ngrok http 8000

Ngrok выдаст URL вида https://abc123.ngrok.io.
Проверьте https://abc123.ngrok.io/health — должно отвечать.

Важно: URL меняется при каждом запуске ngrok. На продакшне нужен постоянный хостинг (см. ниже).

4) Подключаем в ChatGPT (Developer Mode)

Задача: сказать ChatGPT, куда слать команды.

В веб-интерфейсе ChatGPT откройте Настройки → Apps & Connectors.

Включите Developer Mode.

Создайте новое приложение, укажите:

имя приложения;

публичный URL (из ngrok), например https://abc123.ngrok.io;

пока без авторизации.

Сохраните.

Тест:

Откройте новый чат.

Подключите ваше приложение из списка.

Сформулируйте пользовательскую команду: «Создай задачу “Позвонить клиенту” на завтра».

На этапе «болванки» ChatGPT может не «догадаться», как именно дернуть ваш эндпоинт. Это нормально: сейчас мы проверяли механику. В рабочем варианте вы обернёте эти действия в формат, который понимает ChatGPT Apps SDK/MCP (ниже — как перейти к этому).

Ситуационное объяснение:

Сейчас вы научились «поднимать кухню» и готовить блюда по своим правилам.

Чтобы официант (ChatGPT) заказывал блюда автоматически и без ваших подсказок, кухня должна говорить на «официальном протоколе» — это и есть MCP/Apps SDK.

5) Как перейти от «болванки» к интеграции под ChatGPT Apps SDK/MCP

Чтобы ChatGPT автоматически вызывал ваши инструменты, нужно:

Описать инструменты формально (схемы входов/выходов), чтобы чат знал, что и когда можно вызывать.

Поднять MCP-совместимую обвязку (сервер выступает как MCP-server).

Зарегистрировать этот MCP-сервер при создании приложения в ChatGPT.

Практически:

Сохраняете логику «инструментов» как есть (createTask, listTasks).

Оборачиваете маршруты в формат, который ожидает MCP (обычно JSON-схемы + единый RPC-эндпоинт).

Добавляете «описание инструментов» для объявления в ChatGPT.

Если нужно — подготовлю готовый шаблон MCP-совместимого сервера поверх вашего кода и дам инструкции, куда «вставить» ваши инструменты.

6) Что делать для продакшна

Локальная разработка и ngrok — только для тестов. Для постоянной работы:

Хостинг: Vercel, Render, Fly.io, Railway или VPS (Ubuntu + Node.js + reverse-proxy Nginx).

Переменные окружения: OPENAI_API_KEY и прочие секреты храните в env/секрет-хранилищах, не в коде.

HTTPS: на PaaS он обычно «из коробки». На VPS — Let’s Encrypt.

Логи/мониторинг: включите сохранение логов ошибок и метрик.

Безопасность: валидация входных данных, таймауты запросов к внешним API, ограничение размеров входящих тел.

7) Частые проблемы и быстрые решения

400/500 на эндпоинте: проверьте JSON в запросе и обязательные поля.

«Не доходит запрос» из ChatGPT: проверьте, что URL в настройках актуальный (ngrok меняется), что сервер запущен, а фаервол не блокирует.

CORS/HTTPS: для разработки включите cors() в Express, и используйте только HTTPS-URL от ngrok/хостинга.

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