Використання Claude або Codex

Під’єднайте ШІ-агента для програмування до документації та розгорніть Ayakaleaf Pro.

Використовуйте Claude Code або Codex, щоб спланувати й виконати розгортання Ayakaleaf Pro. Під час роботи агент може шукати інформацію в цій документації через MCP.

Агент допомагає з розгортанням, але відповідальність за перевірку команд і захист облікових даних лишається на вас.

​

Перед початком

Підготуйте підтримуваний Linux-сервер із доступом через SSH. Перш ніж продовжити, ознайомтеся з вимогами.

Не вставляйте в запити до агента паролі, приватні ключі, токени чи ліцензійні ключі. Перевіряйте кожну команду перед її виконанням, особливо команди, які змінюють файли, мережі чи контейнери.

​

Під’єднання документації

Додайте MCP-ендпоінт документації до свого локального агента.

Claude Code

claude mcp add ayakaleaf-pro --scope user --transport http https://ayakaleaf-pro.ayaka.space/~gitbook/mcp

Codex

codex mcp add ayakaleaf-pro --url https://ayakaleaf-pro.ayaka.space/~gitbook/mcp

Після додавання сервера розпочніть новий сеанс. Попросіть агента підтвердити, що він може шукати в документації Ayakaleaf Pro.

​

Розгортання Ayakaleaf Pro

Відкрийте термінал на сервері, де виконуватиметься розгортання, і запустіть там Claude Code або Codex. Потім надішліть такий запит:

Use the Ayakaleaf Pro documentation MCP server to guide this deployment.
First, inspect the requirements and installation guides.
Ask me for missing deployment details before making changes.
Use the Ayakaleaf Toolkit unless the documentation requires another approach.
Before configuring the instance, summarize relevant optional features.
Ask which features and integrations I want to enable.
Include TLS, sandboxed compiles, Git integration, external MongoDB or Redis,
SSO (OIDC, SAML, or LDAP), GitHub Synchronisation, Zotero, S3 storage,
email delivery, branding, and localization when relevant.
Explain each selected option's prerequisites, security impact, and configuration steps.
Keep unselected optional features disabled.
Show each command before running it.
Do not expose, store, or request secrets in chat.
After deployment, verify that the service is healthy and summarize the changes.

Агент має провести вас через налаштування Docker, конфігурацію Toolkit, отримання образу та запуск. Еталонний порядок дій описано в посібнику using-the-toolkit.

​

Вибір додаткових функцій

Попросіть агента рекомендувати лише ті функції, які підходять для вашого середовища. Типові варіанти:

• Доступ і безпека: TLS, ізольована компіляція (sandboxed compiles) та SSO через OIDC, SAML або LDAP.
• Зовнішні сервіси: MongoDB, Redis, сховище S3 і надсилання електронної пошти.
• Спільна робота: інтеграція з Git, синхронізація з GitHub і Zotero.

Перш ніж змінювати конфігурацію, агент має пояснити залежності. Перед увімкненням інтеграцій у виробничому середовищі ознайомтеся з toolkit-settings.md і authentication.

​

Перевірка розгортання

Коли агент виконає всі кроки:

1. Переконайтеся, що кожна команда завершилася без помилок.
2. Відкрийте налаштовану URL-адресу Ayakaleaf Pro у браузері.
3. Виконайте 6.-post-installation-tasks.md.

Якщо у вас уже є інсталяція Community Edition, замість нового розгортання скористайтеся посібником migrate-from-existing.md.