Для розробників

Developers — build apps on VTC

Clone VTC Cursor rules, sign in and create an app in your Space, scaffold locally, and deploy to apps.vtc.com with push-to-publish.

Перегляньте пакет правил на GitHub → Відкрийте програму →

Пакет правил курсору

Загальнодоступне сховище — лише правила створення програм. Скопіюйте у свій проект як .cursor/rules/ (ніколи не використовуйте символічні посилання; ніколи не фіксуйте .cursor/ у сховищі програми).

HTTPS 
git clone https://github.com/vtcdotcom/vtc-app-rules.git ~/vtc-app-rules
SSH 
git clone [email protected]:vtcdotcom/vtc-app-rules.git ~/vtc-app-rules
Встановіть у свій додаток 
~/vtc-app-rules/scripts/copy-cursor-rules.sh /path/to/your-app
  • Відкрийте курсор у корені папки програми — по одній програмі на робочу область.
  • Попросіть курсор слідувати scaffold-checklist.mdc під час риштування.
  • Спільні програми ізолюють дані на простір; Спеціальні програми використовують одну базу даних видавця.
  • Періодично витягуйте оновлення правил і повторно запускайте copy-cursor-rules.sh.

Як це працює

Ви створюєте програму локально за допомогою Cursor. VTC розміщує його, впроваджує авторизацію та env платформи під час розгортання та обслуговує його з вашого каталогу Space.

  1. 1

    Клонуйте правила курсору

    Скопіюйте публічний репозиторій vtc-app-rules (вище). Це стандарти, яких очікує наш штучний інтелект і конвеєр — автентифікація, файли env, оболонка програми, i18n і макет розгортання.

  2. 2

    Увійдіть на VTC

    Використовуйте обліковий запис із доступом адміністратора до простору, де розміщуватиметься програма.

    https://app.vtc.com
  3. 3

    Створіть додаток у своєму Space

    На інформаційній панелі програми відкрийте Space → Apps → Create. Установіть назву програми, коротку назву, розгортання «Спільне чи виділене» та видимість каталогу (простір, мережа або платформа).

  4. 4

    Скопіюйте віддалений Git

    Після створення програми відкрийте її налаштування розробника та скопіюйте URL-адресу Git (SSH або HTTPS). На цьому віддаленому пристрої ви натискаєте код — платформа створюється та розгортається під час кожного натискання.

  5. 5

    Скаффолд локально в Cursor

    Скопіюйте правила в папку проекту, відкрийте цю папку в Cursor (а не в батьківському каталозі з багатьма репозиторіями) і створіть шаблон за допомогою scaffold-checklist.mdc. Направте своє локальне репо на віддалений Git з кроку 4.

  6. 6

    Натисніть, щоб опублікувати

    Зафіксуйте та надішліть на віддалений додаток. Служба збірки створює ваш образ або статичний комплект і обслуговує його на імені хосту видавця — жодного етапу розгортання вручну.

    Шаблон активної URL-адреси: https://myapp.apps.vtc.com

Статичні застосунки Vite можна надіслати й опублікувати одразу. Застосунки Next.js виконують серверний код, тому розгортаються лише після схвалення вашого Space як довіреного розробника. Щоб подати запит, напишіть на [email protected].

Space MCP у Cursor

Підключіть Cursor (або Claude / VS Code) до Простору, до якого ви вже належите. MCP прив’язаний до простору — це не спосіб підключити зовнішню продуктову базу даних до VTC.

  1. 1

    Підключити

    Додайте https://mcp.vtc.com/mcp у Cursor Settings → MCP (конфіг нижче). Натисніть Connect — відкриється браузер для входу у VTC.

  2. 2

    Увійдіть і виберіть Простір

    Завершіть OTP у спливному вікні, виберіть Простір і поверніться до Cursor. Клієнт зберігає й оновлює токени автоматично.

  3. 3

    Запитуйте в цьому Просторі

    Переглядайте дані Shared-програм (list_collections → sample/find), каталог і маніфести, дії Guide (list_available_actions → execute_action) або пропонуйте/запускайте робочі процеси. Мутації та реальні запуски потребують confirmation_token, який спочатку показується вам.

Конфіг Cursor MCP 
{
  "mcpServers": {
    "vtc-space-db": {
      "type": "http",
      "url": "https://mcp.vtc.com/mcp"
    }
  }
}

Інтерактивні клієнти використовують OAuth Connect (вхід у браузері + вибір Простору). Безголові агенти можуть передати admin JWT з Developer Help як Bearer.

  • Ті самі рольові обмеження та шлях білінгу, що й у вбудованого Guide, де це застосовно.
  • CI / безголовий режим: згенеруйте admin JWT у Developer Help і задайте Authorization: Bearer <jwt> у заголовках MCP.
  • Ніколи не вигадуйте інший group_id для інструментів БД — сило лише JWT-Простір.

Що охоплюють правила

Auth & Spaces

JWT через ?token= з оболонки, завантажувальний файл localStorage і визначення group_id для спільних програм.

Інтерфейс користувача та i18n

Стандартна оболонка програми, Tailwind v4, акцентні кольори під час виконання та файли локалі з першого дня.

API та дані

Маршрути CRUD, м’яке видалення, URL-адреси, керовані env, і @posif/sdk для доступу до робочої бази даних орендаря.

Розгорнути

Закріплений .env.production лише для ключів, що належать програмі; платформа вводить URL-адреси API, MongoDB та ідентифікацію під час створення.

VTC Ledger

Дозволений безгазовий EVM для незмінних записів, перевірок у ланцюжку та підписання гаманця — інтегруйте з додатків, коли вам потрібен захист від несанкціонованого доступу.

Готові будувати?

Клонуйте правила, створіть програму у своєму просторі та натисніть, коли будете готові.

Дізнайтеся правила Перейдіть до програми Сервіси платформи