# Integrasi `product-mcp` (MCP) dengan Claude Code & AI Tools

Server ini adalah **MCP server** (Streamable HTTP) yang menyajikan aturan/pengetahuan `.md` secara **read-only** + mencatat log aktivitas. Hubungkan AI tool Anda ke endpoint MCP berikut, lalu tinggal **copy-paste**.

- **MCP endpoint:** `https://product-mcp.ikavia.com/mcp`
- **Transport:** Streamable HTTP

## Header yang dipakai

| Header | Wajib | Keterangan |
|---|---|---|
| `auth_basic` | ya | `username:password` (atau standar `Authorization: Basic <base64>`) |
| `tim` | opsional | Divalidasi terhadap file kredensial; mismatch → 401 |
| `path` | tergantung | Memilih workspace. User dengan ACL terbatas **wajib** mengirim path yang diizinkan |

## Claude Code (CLI)

```bash
claude mcp add --transport http product-mcp https://product-mcp.ikavia.com/mcp \
  --header "auth_basic: <username>:<password>" \
  --header "tim: <tim-anda>" \
  --header "path: /<workspace>"
```

Cek koneksi:

```bash
claude mcp list
```

## Claude Desktop / client MCP generik (JSON)

Tambahkan ke konfigurasi MCP client Anda:

```json
{
  "mcpServers": {
    "product-mcp": {
      "type": "http",
      "url": "https://product-mcp.ikavia.com/mcp",
      "headers": {
        "auth_basic": "<username>:<password>",
        "tim": "<tim-anda>",
        "path": "/<workspace>"
      }
    }
  }
}
```

## Tools yang tersedia

Setelah terhubung, AI tool dapat memakai:

- `whoami`, `list_workspaces` — identitas & workspace yang boleh diakses.
- `list_files`, `get_file` — daftar & isi file aturan.
- `search_rules`, `get_rule` — cari & ambil rule (mis. `R-ORDER.01`).
- `log_implementation`, `log_feedback`, `log_deviation`, `get_activity` — log aktivitas.

Semua tool scoped ke workspace aktif (header `path`); server tidak pernah mengubah file aturan.

## Membuat file aturan baru lewat AI agent

Server menyediakan **panduan menulis** publik di endpoint berikut (berisi `text/markdown` murni, tanpa auth):

```
https://product-mcp.ikavia.com/context-guide.md
```

Panduan itu sudah merefleksikan **pola heading aktif** server ini, jadi file yang dihasilkan langsung ter-index. Cara memakainya:

1. **Ambil panduan** untuk dibaca/diverifikasi:

   ```bash
   curl https://product-mcp.ikavia.com/context-guide.md
   ```

2. **Serahkan URL-nya ke AI agent** (mis. Claude Code) sebagai instruksi, contoh prompt:

   ```
   Baca panduan di https://product-mcp.ikavia.com/context-guide.md lalu buatkan file aturan .md
   untuk domain <DOMAIN-ANDA> sesuai format di panduan itu.
   ```

3. **Letakkan file `.md`** hasilnya di folder workspace yang sesuai. Server meng-**hot-reload** otomatis (tanpa restart); rule baru langsung bisa diakses lewat tool `list_files`, `get_rule`, `search_rules`.