Claude または Codex を使う

AI コーディングエージェントをドキュメントに接続し、Ayakaleaf Pro をデプロイします。

Claude Code または Codex を使用して、Ayakaleaf Pro のデプロイを計画・実行できます。エージェントは作業中に MCP を通じてこのドキュメントを検索できます。

エージェントはデプロイを支援するものです。コマンドの確認と認証情報の保護は、引き続きあなたの責任です。

​

始める前に

SSH でアクセスできる、サポート対象の Linux サーバーを用意してください。続行する前に要件を確認してください。

パスワード、秘密鍵、トークン、ライセンスキーをエージェントのプロンプトに貼り付けないでください。すべてのコマンドは実行前に確認してください。特に、ファイル、ネットワーク、コンテナを変更するコマンドには注意してください。

​

ドキュメントを接続する

ローカルのエージェントにドキュメントの 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、サンドボックスコンパイル、OIDC・SAML・LDAP による SSO。
• 外部サービス: MongoDB、Redis、S3 ストレージ、メール配信。
• コラボレーション: Git 連携、GitHub Synchronisation、Zotero。

エージェントは、設定を編集する前に依存関係を説明する必要があります。本番環境で連携機能を有効にする前に、toolkit-settings.md と authentication を確認してください。

​

デプロイを確認する

エージェントが手順を完了したら:

1. すべてのコマンドがエラーなく完了したことを確認します。
2. 設定した Ayakaleaf Pro の URL をブラウザで開きます。
3. 6.-post-installation-tasks.md を完了します。

既存の Community Edition のインストール環境がある場合は、新規デプロイではなく migrate-from-existing.md ガイドを使用してください。