querypie · jk-kim0 · Mar 19, 2026 · Mar 18, 2026 · Mar 19, 2026
@@ -162,9 +162,10 @@ DB_MAX_CONNECTION_SIZE 최적화 | Optimizing DB_MAX_CONNECTION_SIZE
 Public Cloud 운영서버 요구사항 | Public Cloud Production Server Requirements
 On-Premise VM 요구사항 | On-Premise VM Requirements
 서버구성 요구사항 요약표 | Server Configuration Requirements Summary
-MCP 설정 가이드 | MCP Configuration Guide
+QueryPie ACP Community Edition 초기 구성 가이드 | QueryPie ACP Community Edition Initial Configuration Guide
 QueryPie ACP Community Edition 업그레이드 방법 | How to Upgrade QueryPie ACP Community Edition
 QueryPie ACP Community Edition 제거 방법 | How to Remove QueryPie ACP Community Edition
+MCP 설정 가이드 | MCP Configuration Guide
 
 # Support
 지원 | Support

@@ -4754,21 +4754,21 @@
   "path":
   - "installation"
   - "querypie-acp-community-edition"
-- "page_id": "1735589937"
-  "title": "MCP 설정 가이드"
-  "title_orig": "MCP 설정 가이드"
+- "page_id": "1805516819"
+  "title": "QueryPie ACP Community Edition 초기 구성 가이드"
+  "title_orig": "QueryPie ACP Community Edition 초기 구성 가이드"
   "breadcrumbs":
   - "제품 설치"
   - "QueryPie ACP Community Edition"
-  - "MCP 설정 가이드"
+  - "QueryPie ACP Community Edition 초기 구성 가이드"
   "breadcrumbs_en":
   - "Installation"
   - "QueryPie ACP Community Edition"
-  - "MCP Configuration Guide"
+  - "QueryPie ACP Community Edition 초기 구성 가이드"
   "path":
   - "installation"
   - "querypie-acp-community-edition"
-  - "mcp-configuration-guide"
+  - "querypie-acp-community-edition"
 - "page_id": "1990000673"
   "title": "QueryPie ACP Community Edition 업그레이드 방법"
   "title_orig": "QueryPie ACP Community Edition 업그레이드 방법"
@@ -4799,6 +4799,21 @@
   - "installation"
   - "querypie-acp-community-edition"
   - "how-to-remove-querypie-acp-community-edition"
+- "page_id": "1735589937"
+  "title": "MCP 설정 가이드"
+  "title_orig": "MCP 설정 가이드"
+  "breadcrumbs":
+  - "제품 설치"
+  - "QueryPie ACP Community Edition"
+  - "MCP 설정 가이드"
+  "breadcrumbs_en":
+  - "Installation"
+  - "QueryPie ACP Community Edition"
+  - "MCP Configuration Guide"
+  "path":
+  - "installation"
+  - "querypie-acp-community-edition"
+  - "mcp-configuration-guide"
 - "page_id": "1844969501"
   "title": "지원"
   "title_orig": "지원"

@@ -1,5 +1,6 @@
 export default {
-  'mcp-configuration-guide': 'MCP Configuration Guide',
+  'querypie-acp-community-edition': 'QueryPie ACP Community Edition Initial Configuration Guide',
   'how-to-upgrade-querypie-acp-community-edition': 'How to Upgrade QueryPie ACP Community Edition',
   'how-to-remove-querypie-acp-community-edition': 'How to Remove QueryPie ACP Community Edition',
+  'mcp-configuration-guide': 'MCP Configuration Guide',
 };
@@ -0,0 +1,100 @@
+---
+title: 'QueryPie ACP Community Edition Initial Configuration Guide'
+confluenceUrl: 'https://querypie.atlassian.net/wiki/spaces/QM/pages/1805516819/QueryPie+ACP+Community+Edition'
+---
+
+import { Callout } from 'nextra/components'
+
+# QueryPie ACP Community Edition Initial Configuration Guide
+
+## Overview
+
+Learn about the settings that must be configured after completing the Community Edition installation.
+
+### Web Base URL Configuration
+
+You must enter the address related to external access in the Web Base URL field on the `General > Company Management > General` settings page of the admin console.
+
+<Callout type="info">
+Features that use the value entered in Web Base URL
+
+* OAuth / SAML redirect URI, SCIM endpoint
+* Link URL generation in Email / Slack
+* Server Agent configuration and download URL
+* User Agent download link
+* Audit log export / Report download link
+* [DAC] DB OAuth redirect URI
+* [KAC] Session recording download
+
+For more details on other uses, please refer to [QUERYPIE_WEB_URL](../container-environment-variables/querypieweburl).
+</Callout>
+
+This URL must not end with `/`. Be careful not to add `/` at the end of the URL, as in `https://querypie.customer.com/`.
+For Community Edition, the default port is 8000, so please include the port as well.
+
+<figure data-layout="center" data-align="center">
+<img src="/installation/querypie-acp-community-edition/querypie-acp-community-edition/image-20260317-141403.png" alt="Web Base URL" width="842" />
+<figcaption>
+Web Base URL
+</figcaption>
+</figure>
+
+
+### Proxy Configuration per Service
+
+Proxy configuration is required to connect to targets using 3rd party tools.
+
+Navigate to the directory where QueryPie is installed and run the configure-proxy.sh script.
+
+<Callout type="info">
+Use the -h or --help option to view the script help.
+```
+bash configure-proxy.sh -h
+Usage: configure-proxy.sh [OPTIONS] [PROXY_ADDRESS]
+
+Configure QueryPie ACP proxy settings for DAC/SAC and KAC in one step.
+
+ARGUMENTS:
+  PROXY_ADDRESS  FQDN or IPv4 address of this host.
+                 e.g. 192.168.1.100, querypie.example.com
+                 If omitted, the host IP is auto-detected.
+
+OPTIONS:
+  -y, --yes      Assume yes to all prompts; run non-interactively.
+  -h, --help     Show this help message
+```
+</Callout>
+```bash
+cd ~/querypie/current #### This is an example when installed under the home directory.
+bash configure-proxy.sh ## run proxy configuration script
+```
+
+When you run the script, enter the Proxy Address to use.
+By default, the host IP is auto-detected. If needed (e.g., to enter an FQDN), you can modify and enter it.
+```
+Proxy address [10.11.20.87]:
+```
+
+The proxy settings for DAC / SAC / KAC are applied all at once.
+```
+Apply the above proxy settings?
+Do you agree? [y/N] : y
+```
+
+Press y to continue.
+
+A restart is required to apply the settings.
+```
+Restart services to apply changes?
+Do you agree? [y/N] : y
+```
+
+Press y to continue.
+When the services have restarted successfully, the output will appear as shown below.
+
+<figure data-layout="center" data-align="center">
+<img src="/installation/querypie-acp-community-edition/querypie-acp-community-edition/image-20260318-060925.png" alt="Proxy configuration script completed successfully." width="509" />
+<figcaption>
+Proxy configuration script completed successfully.
+</figcaption>
+</figure>
@@ -1,5 +1,6 @@
 export default {
-  'mcp-configuration-guide': 'MCP設定ガイド',
+  'querypie-acp-community-edition': 'QueryPie ACP Community Edition 初期設定ガイド',
   'how-to-upgrade-querypie-acp-community-edition': 'QueryPie ACP Community Editionのアップグレード方法',
   'how-to-remove-querypie-acp-community-edition': 'QueryPie ACP Community Editionの削除方法',
+  'mcp-configuration-guide': 'MCP設定ガイド',
 };
@@ -0,0 +1,100 @@
+---
+title: 'QueryPie ACP Community Edition 初期設定ガイド'
+confluenceUrl: 'https://querypie.atlassian.net/wiki/spaces/QM/pages/1805516819/QueryPie+ACP+Community+Edition'
+---
+
+import { Callout } from 'nextra/components'
+
+# QueryPie ACP Community Edition 初期設定ガイド
+
+## Overview
+
+Community Editionのインストール完了後に必ず設定する必要がある内容について説明します。
+
+### Web Base URL設定
+
+管理者ページの`General > Company Management > General`設定ページのWeb Base URL設定項目に、外部アクセスに関連するアドレスを必ず入力してください。
+
+<Callout type="info">
+Web Base URLに入力した値を使用する機能
+
+* OAuth / SAML redirect URI、SCIMエンドポイント
+* メール / Slack内のリンクURL生成
+* Server Agentの設定およびダウンロードURL
+* User Agentのダウンロードリンク
+* 監査ログのエクスポート / レポートダウンロードリンク
+* [DAC] DB OAuth redirect URI
+* [KAC] セッションレコーディングのダウンロード
+
+その他の詳細な用途については、[QUERYPIE_WEB_URL](../container-environment-variables/querypieweburl)を参照してください。
+</Callout>
+
+このURLは`/`で終わってはいけません。`https://querypie.customer.com/`のように、URLの末尾に`/`を付けないよう注意してください。
+Community Editionの場合、デフォルトのポートが8000に設定されているため、ポートも合わせて入力します。
+
+<figure data-layout="center" data-align="center">
+<img src="/installation/querypie-acp-community-edition/querypie-acp-community-edition/image-20260317-141403.png" alt="Web Base URL" width="842" />
+<figcaption>
+Web Base URL
+</figcaption>
+</figure>
+
+
+### サービス別Proxy設定
+
+サードパーティツールを使用して対象に接続するには、Proxy設定が必須です。
+
+QueryPieがインストールされているディレクトリに移動し、configure-proxy.shスクリプトを実行します。
+
+<Callout type="info">
+-hまたは--helpオプションを使用すると、スクリプトのヘルプを表示できます。
+```
+bash configure-proxy.sh -h
+Usage: configure-proxy.sh [OPTIONS] [PROXY_ADDRESS]
+
+Configure QueryPie ACP proxy settings for DAC/SAC and KAC in one step.
+
+ARGUMENTS:
+  PROXY_ADDRESS  FQDN or IPv4 address of this host.
+                 e.g. 192.168.1.100, querypie.example.com
+                 If omitted, the host IP is auto-detected.
+
+OPTIONS:
+  -y, --yes      Assume yes to all prompts; run non-interactively.
+  -h, --help     Show this help message
+```
+</Callout>
+```bash
+cd ~/querypie/current #### This is an example when installed under the home directory.
+bash configure-proxy.sh ## run proxy configuration script
+```
+
+スクリプトを実行すると、使用するProxy Addressを入力します。
+デフォルトではホストIPが自動検出されますが、必要に応じて（FQDNの入力など）修正して入力します。
+```
+Proxy address [10.11.20.87]:
+```
+
+DAC / SAC / KACのProxy設定が一度に適用されます。
+```
+Apply the above proxy settings?
+Do you agree? [y/N] : y
+```
+
+yを押して続行します。
+
+設定を適用するにはサービスの再起動が必要です。
+```
+Restart services to apply changes?
+Do you agree? [y/N] : y
+```
+
+yを押して続行します。
+サービスが正常に再起動されると、以下の図のように出力されます。
+
+<figure data-layout="center" data-align="center">
+<img src="/installation/querypie-acp-community-edition/querypie-acp-community-edition/image-20260318-060925.png" alt="Proxy設定スクリプトが正常終了。" width="509" />
+<figcaption>
+Proxy設定スクリプトが正常終了。
+</figcaption>
+</figure>
@@ -1,5 +1,6 @@
 export default {
-  'mcp-configuration-guide': 'MCP 설정 가이드',
+  'querypie-acp-community-edition': 'QueryPie ACP Community Edition 초기 구성 가이드',
   'how-to-upgrade-querypie-acp-community-edition': 'QueryPie ACP Community Edition 업그레이드 방법',
   'how-to-remove-querypie-acp-community-edition': 'QueryPie ACP Community Edition 제거 방법',
+  'mcp-configuration-guide': 'MCP 설정 가이드',
 };
@@ -0,0 +1,102 @@
+---
+title: 'QueryPie ACP Community Edition 초기 구성 가이드'
+confluenceUrl: 'https://querypie.atlassian.net/wiki/spaces/QM/pages/1805516819/QueryPie+ACP+Community+Edition'
+---
+
+import { Callout } from 'nextra/components'
+
+# QueryPie ACP Community Edition 초기 구성 가이드
+
+## Overview
+
+Community Edition 설치가 완료된 후 반드시 설정해야할 내용에 대해 알아봅니다.
+
+### Web Base URL 설정
+
+관리자 페이지의 `General > Company Management > General` 설정 페이지의 Web Base URL 설정항목에 반드시 외부 접속과 관련된 주소를 입력해야합니다.
+
+<Callout type="info">
+Web Base URL 에 입력된 값을 사용하는 기능
+
+* OAuth /. SAML redirect URI, SCIM 엔드포인트
+* 이메일 / Slack 내 링크 URL 생성
+* Server Agent 설정 및 다운로드 URL
+* User Agent 다운로드 링크
+* 감사 로그. 내보내기 / 리포트 다운로드. 링크
+* [DAC] DB OAuth redirect URI
+* [KAC] 세션 레코딩 다운로드
+
+그 외 자세한 용도는, [QUERYPIE_WEB_URL](../container-environment-variables/querypieweburl)를 참조하시기 바랍니다.
+</Callout>
+
+이 URL 은 `/` 로 끝나지 않아야 합니다. `https://querypie.customer.com/` 와 같이 URL 의 마지막에 `/` 를 붙이지 않도록 주의해주세요.
+community edition의 경우 기본 port가 8000으로 되어 있으므로 port 도 같이 입력합니다.
+
+<figure data-layout="center" data-align="center">
+<img src="/installation/querypie-acp-community-edition/querypie-acp-community-edition/image-20260317-141403.png" alt="Web Base URL" width="842" />
+<figcaption>
+Web Base URL
+</figcaption>
+</figure>
+
+
+### 서비스 별 Proxy 설정
+
+3rd party tool을 사용해서 대상에 접속하기 위해서는 Proxy 설정이 반드시 필요합니다.
+
+쿼리파이가 설치된 위치로 이동 후 configure-prosy.sh 스크립트를 수행합니다.
+
+<Callout type="info">
+-h 또는 --help 옵션을 사용하면 스크립트 도움말을 볼 수 있습니다.
+```
+bash configure-proxy.sh -h
+Usage: configure-proxy.sh [OPTIONS] [PROXY_ADDRESS]
+
+Configure QueryPie ACP proxy settings for DAC/SAC and KAC in one step.
+
+ARGUMENTS:
+  PROXY_ADDRESS  FQDN or IPv4 address of this host.
+                 e.g. 192.168.1.100, querypie.example.com
+                 If omitted, the host IP is auto-detected.
+
+OPTIONS:
+  -y, --yes      Assume yes to all prompts; run non-interactively.
+  -h, --help     Show this help message
+```
+</Callout>
+```bash
+cd ~/querypie/current #### This is an example when installed under the home directory.
+bash configure-proxy.sh ## run proxy configuration script
+```
+
+스크립트를 실행하면 사용할 Proxy Address 를 입력합니다.
+기본적으로 host IP가 자동 검출되는데 필요한 경우(FQDN 입력 등) 수정해서 입력합니다.
+```
+Proxy address [10.11.20.87]:
+```
+
+DAC / SAC / KAC 의 proxy 설정이 한번에 수행됩니다.
+```
+Apply the above proxy settings?
+Do you agree? [y/N] : y
+```
+
+y를 눌러 계속 진행합니다.
+
+설정이 적용되면 재시작이 필요합니다.
+```
+Restart services to apply changes?
+Do you agree? [y/N] : y
+```
+
+y를 눌러 계속 진행합니다.
+정상적으로 서비스가 재시작이 완료되면 아래 그림과 같이 출력됩니다.
+
+<figure data-layout="center" data-align="center">
+<img src="/installation/querypie-acp-community-edition/querypie-acp-community-edition/image-20260318-060925.png" alt="proxy 설정 스크립트 정상 종료." width="509" />
+<figcaption>
+proxy 설정 스크립트 정상 종료.
+</figcaption>
+</figure>
+
+