Usando Claude ou Codex

Conecte um agente de programação com IA à documentação e implante o Ayakaleaf Pro.

Use o Claude Code ou o Codex para planejar e executar uma implantação do Ayakaleaf Pro. O agente pode pesquisar esta documentação via MCP enquanto trabalha.

O agente auxilia na implantação. Você continua responsável por revisar os comandos e proteger as credenciais.

​

Antes de começar

Prepare um servidor Linux compatível com acesso SSH. Revise os requisitos antes de continuar.

Não cole senhas, chaves privadas, tokens ou chaves de licença nos prompts do agente. Revise cada comando antes de executá-lo, especialmente comandos que modificam arquivos, redes ou contêineres.

​

Conectar a documentação

Adicione o endpoint MCP da documentação ao seu agente local.

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

Inicie uma nova sessão depois de adicionar o servidor. Peça ao agente para confirmar que consegue pesquisar a documentação do Ayakaleaf Pro.

​

Implantar o Ayakaleaf Pro

Abra um terminal no seu servidor de implantação. Inicie o Claude Code ou o Codex ali. Em seguida, envie este 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.

O agente deve guiá-lo pela configuração do Docker, configuração do Toolkit, obtenção da imagem e inicialização. Siga o guia using-the-toolkit para o fluxo de trabalho canônico.

​

Escolher recursos opcionais

Peça ao agente para recomendar apenas recursos adequados ao seu ambiente. As escolhas típicas incluem:

• Acesso e segurança: TLS, compilações em sandbox e SSO via OIDC, SAML ou LDAP.
• Serviços externos: MongoDB, Redis, armazenamento S3 e envio de e-mails.
• Colaboração: integração com Git, GitHub Synchronisation e Zotero.

O agente deve explicar as dependências antes de editar a configuração. Revise toolkit-settings.md e authentication antes de habilitar integrações em produção.

​

Verificar a implantação

Depois que o agente concluir as etapas:

1. Confirme que todos os comandos foram concluídos sem erros.
2. Abra a URL configurada do Ayakaleaf Pro no navegador.
3. Conclua as 6.-post-installation-tasks.md.

Para uma instalação existente do Community Edition, use o guia migrate-from-existing.md em vez de uma implantação nova.