Share a vault with a team
Run aether-mcp as an authenticated gateway, give each agent its own scoped key, and keep a shared Git vault in sync.
For the Rust API behind these steps, see Part 5 of the learning series.
Start an authenticated server
export AETHER_BOOTSTRAP_ADMIN_KEY="aek_$(openssl rand -hex 32)"
aether-mcp \
--vault /path/to/team-vault \
--http-addr 0.0.0.0:4771 \
--http-only \
--require-auth \
--bootstrap-admin-key "$AETHER_BOOTSTRAP_ADMIN_KEY"
--require-auth allows non-loopback binds and requires Authorization: Bearer aek_<hex> on every route.
Run the server behind HTTPS in production.
The Docker image in Install aether-mcp runs the same configuration.
Issue a key per agent
Roles are ordered Reader, Contributor, Admin.
Create a Contributor key limited to the engineering scope:
curl -sS -X POST http://127.0.0.1:4771/v1/auth/keys \
-H "Authorization: Bearer $AETHER_BOOTSTRAP_ADMIN_KEY" \
-H 'Content-Type: application/json' \
-d '{"agent_id":"coding-agent","role":"contributor","scopes":["engineering"]}'
The response includes a one-time secret (aek_<64-hex>).
Store it, because the server keeps only a hash.
List or revoke keys with GET /v1/auth/keys and POST /v1/auth/keys/revoke (Admin only).
Under a scoped key:
aether_recallreturns only notes in the key's scopes, plusglobalnotes.aether_stage_memoryneedsContributororAdminand stamps the proposal with the agent id.aether_inspect_sourcedenies notes outside the key's scopes.
Connect AMC and agents
In Settings, AMC, set Aether control-plane URL to your https:// gateway and paste a key into API key.
The connection card confirms the key works.
For stdio clients, add "--api-key" and the token to args, as described in Connect an AI agent.
AMC keeps the key in .obsidian/plugins/aether-memory/data.json, which Git sync keeps out of history.
Turn on Run Dream consolidation on push only with an Admin key.
Sync the vault through Git
Run Git sync team vault in Obsidian, or call the endpoint as an Admin:
curl -sS -X POST http://127.0.0.1:4771/v1/git/sync \
-H "Authorization: Bearer $AETHER_BOOTSTRAP_ADMIN_KEY" \
-H 'Content-Type: application/json' \
-d '{"remote":"origin","branch":"main","push":true}'
The sync ignores .aether/ and plugin data.json, fetches and merges, resolves conflicts in Aether/Inbox.md and Aether/Compiled/Approved.md automatically (approved wins over rejected, rejected over pending), skips notes that still contain conflict markers, then commits and optionally pushes.
Your vault needs to be a Git repository with a remote such as origin.
Optional: warm a GPU KV cache
If you run vLLM or SGLang, start aether-mcp with --kv-endpoint and --kv-model, turn on Enable GPU KV-cache warming in AMC, and run Warm GPU KV cache.
See Part 5, step 5 for the request and response fields.