Initial project import

docs/runbooks/adapter-1c-mcp.md

@@ -52,7 +52,7 @@ MCP server configuration.
 The MCP proxy does not hard-code the 1C adapter address. Pass it with:
 
 ```text
-ONEC_ADAPTER_URL=http://docker-gpu.cin.su:8011
+ONEC_ADAPTER_URL=http://docker.cin.su:8011
 ```
 
 Optional adapter bearer token:
@@ -75,6 +75,37 @@ core/deploy/docker/adapter-1c-mcp/.env.example
 
 For real deployment, create a non-committed `.env` next to the compose file and set the actual adapter URL/token there.
 
+## REST adapter on docker.cin.su
+
+The REST SQL adapter is deployed from:
+
+```text
+core/deploy/docker/adapter-1c/compose.yaml
+```
+
+Its published port is set in a non-committed REST environment file:
+
+```text
+ADAPTER_1C_HOST_PORT=8011
+```
+
+SQL-base administration is available in the REST adapter at:
+
+```text
+http://docker.cin.su:<ADAPTER_1C_HOST_PORT>/admin
+```
+
+With the default port this is `http://docker.cin.su:8011/admin`. The page is
+used to add or update SQL connections for named bases. Do not put connection
+passwords in Git or documentation. If the port changes, use the new port both
+for this page and in `ONEC_ADAPTER_URL`.
+
+If that port is occupied, select a free port there and set the MCP URL to the
+same value, for example `ONEC_ADAPTER_URL=http://docker.cin.su:18011`.
+Keep `ONEC_SQL_BASES_JSON` (or the mounted `/data/onec-sql-bases.json`) only
+in that external runtime configuration; never place SQL passwords in this
+repository.
+
 ## Deploy
 
 Deploy both REST adapter and MCP proxy, then run live verification when a test
@@ -83,6 +114,8 @@ base is available:
 ```powershell
 powershell -NoProfile -ExecutionPolicy Bypass `
   -File scripts\deploy_1c_adapter_stack.ps1 `
+  -RestEnvFile <path-to-non-committed-rest-env> `
+  -McpEnvFile <path-to-non-committed-mcp-env> `
   -BaseId <base-id-from-project-context>
 ```
 
@@ -692,7 +725,7 @@ Saved-state BSL write smoke:
 
 ```powershell
 python scripts\smoke_1c_code_write_saved_state.py `
-  --adapter-url http://docker-gpu.cin.su:8011 `
+  --adapter-url http://docker.cin.su:8011 `
   --base-id <base-id-from-project-context> `
   --extension <extension-name> `
   --object-type CommonForm `
@@ -712,7 +745,7 @@ Agent working-view report:
 
 ```powershell
 python scripts\report_1c_agent_working_view.py `
-  --adapter-url http://docker-gpu.cin.su:8011 `
+  --adapter-url http://docker.cin.su:8011 `
   --base-id <base-id-from-project-context> `
   --extension <extension-name> `
   --object-type CommonForm `
@@ -738,7 +771,7 @@ Optional live selector-chain smoke against a real adapter/base:
 python scripts\smoke_1c_mcp_selector_chain.py `
   --live `
   --transport rest `
-  --adapter-url http://docker-gpu.cin.su:8011 `
+  --adapter-url http://docker.cin.su:8011 `
   --base-id <base-id-from-project-context> `
   --json `
   --no-report