Team Setup

Team Setup

Extend Aperio to be your Shared Memory

Aperio is personal by default, but the architecture supports team shared memory out of the box.

---

Concept

Aperio stores all data in a single database (SQLite or Postgres). When multiple people connect to the same database, they share the same memory, wiki, and knowledge.

Person A ───┐
Person B ───┼──> Same MCP Server ──> Same Database
Person C ───┘

---

Quick setup

1. Use Postgres

SQLite works for single-user. For a team, use Postgres:

DB_BACKEND=postgres
DATABASE_URL=postgresql://aperio:password@your-server:5432/aperio

2. Run the MCP server on a shared host

Start Aperio on a machine accessible to your team (a server, a cloud VM, or a local machine on your network):

npm run start:cloud   # starts on port 1701

3. Everyone connects to the same MCP server

Each team member configures their MCP host (Cursor, Windsurf, Claude Desktop, etc.):

{
  "mcpServers": {
    "aperio-team": {
      "command": "node",
      "args": ["/path/to/aperio/mcp/index.js"],
      "env": {
        "DATABASE_URL": "postgresql://aperio:password@your-server:5432/aperio"
      }
    }
  }
}

4. Seed team knowledge

remember: "Project Atlas uses Next.js frontend, PlanetScale DB. PM is Sara." type=project
remember: "Sara is PM for Atlas and Beacon. Prefers Slack over email." type=person
remember: "We chose Fly.io over Railway. Revisit if team grows past 10." type=decision

---

Team use cases

Use case	Example query
Onboarding	"What do I need to know to start contributing?"
Project context	"What's the stack for Project Atlas?"
Decision history	"Why did we choose Fly.io?"
People finder	"Who handles DevOps?"
Runbooks	"What do we do when the DB goes down?"
Cross-project	"Which projects use Stripe?"

---

Future

• Per-user memory spaces — personal context alongside shared team context
• Memory ownership — tag memories by who created them
• Access control — read-only vs read-write roles
• Audit log — see who saved or changed what and when

---

See also

• Build On Top — more on extending Aperio
• Custom Tools — adding your own MCP tools