Usare Claude o Codex

Collega un agente di programmazione AI alla documentazione ed esegui il deployment di Ayakaleaf Pro.

Usa Claude Code o Codex per pianificare ed eseguire un deployment di Ayakaleaf Pro. Durante il lavoro, l’agente può effettuare ricerche in questa documentazione tramite MCP.

L’agente ti assiste nel deployment. Resti comunque responsabile della revisione dei comandi e della protezione delle credenziali.

​

Prima di iniziare

Prepara un server Linux supportato con accesso SSH. Consulta i requisiti prima di continuare.

Non incollare password, chiavi private, token o chiavi di licenza nei prompt dell’agente. Controlla ogni comando prima di eseguirlo, in particolare i comandi che modificano file, reti o container.

​

Collegare la documentazione

Aggiungi l’endpoint MCP della documentazione al tuo agente locale.

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

Dopo aver aggiunto il server, avvia una nuova sessione. Chiedi all’agente di confermare che può effettuare ricerche nella documentazione di Ayakaleaf Pro.

​

Eseguire il deployment di Ayakaleaf Pro

Apri un terminale sul server di deployment e avvia lì Claude Code o Codex. Poi invia questo prompt:

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.

L’agente dovrebbe guidarti attraverso la configurazione di Docker, la configurazione del Toolkit, il download dell’immagine e l’avvio. Segui la guida using-the-toolkit per il flusso di lavoro di riferimento.

​

Scegliere le funzionalità opzionali

Chiedi all’agente di consigliarti solo le funzionalità adatte al tuo ambiente. Le scelte tipiche includono:

• Accesso e sicurezza: TLS, compilazioni in sandbox e SSO tramite OIDC, SAML o LDAP.
• Servizi esterni: MongoDB, Redis, storage S3 e invio di email.
• Collaborazione: integrazione Git, GitHub Synchronisation e Zotero.

L’agente dovrebbe spiegare le dipendenze prima di modificare la configurazione. Consulta toolkit-settings.md e authentication prima di abilitare integrazioni in produzione.

​

Verificare il deployment

Dopo che l’agente ha completato i passaggi:

1. Verifica che ogni comando sia stato completato senza errori.
2. Apri nel browser l’URL di Ayakaleaf Pro configurato.
3. Completa le 6.-post-installation-tasks.md.

Per un’installazione esistente di Community Edition, usa la guida migrate-from-existing.md invece di un nuovo deployment.