Edit — Wiki & MCP Setup

Title

Tags (comma separated)

Content (Markdown)

# DeepBlue Wiki & MCP Setup

The DeepBlue LLM Wiki runs at https://wiki.deepbluebase.xyz.

## Services

| Service | Port | File | Purpose |
|---------|------|------|---------|
| `deepblue-wiki-web` | 3002 | `wiki/webui/main.py` | Web UI (FastAPI + dark theme) |
| `deepblue-wiki-api` | 4510 | `wiki/api/main.py` | REST API for Claude/bots |
| `deepblue-wiki-mcp` | 4511 | `wiki/mcp/server.py` | MCP server for Claude connections |

## Caddy Routing

```
wiki.deepbluebase.xyz {
    handle /mcp*   { reverse_proxy localhost:4511 }
    handle /api/*  { uri strip_prefix /api; reverse_proxy localhost:4510 }
    handle         { reverse_proxy localhost:3002 }
}
```

## Auth (No Supabase)

Supabase was stripped entirely. Auth uses a static API key:

- **Web UI**: No auth (local/team access only)
- **API**: `Authorization: Bearer <WIKI_API_KEY>` header
- **MCP**: `SUPAVAULT_USER_ID` env var for internal identity (no token verification)

API key is stored in `/home/ubuntu/wiki/.env` (never expose the value).

## Database

- PostgreSQL in Docker at port 5433
- Schema: standard supavault tables (documents, knowledge_bases, users)
- No Supabase RLS — simple `user_id` column scoping
- Connection: `postgresql://postgres:deepblue_wiki_2026@localhost:5433/supavault`

## MCP Connection

For Claude to connect to this wiki as an MCP server:

```json
{
  "mcpServers": {
    "deepblue-wiki": {
      "url": "https://wiki.deepbluebase.xyz/mcp",
      "headers": {
        "Authorization": "Bearer <WIKI_API_KEY>"
      }
    }
  }
}
```

## Adding Content

**Via web UI**: Visit https://wiki.deepbluebase.xyz → click "+ New Page"

**Via API**:
```bash
curl -X POST https://wiki.deepbluebase.xyz/api/v1/knowledge-bases/00000000-0000-0000-0000-000000000010/documents/note \
  -H "Authorization: Bearer <KEY>" \
  -H "Content-Type: application/json" \
  -d '{"filename": "my-page.md", "content": "# My Page\n\nContent here.", "path": "/"}'
```

**Via MCP tools** (from Claude): `guide` → `list_knowledge_bases` → `create_note`

Cancel