# Pakai dengan AI agent

> Sambungkan Claude Code, Cursor, VS Code, Codex, atau Gemini CLI ke design system lewat MCP server, llms.txt, registry, dan cuplikan AGENTS.md.

AI agent bisa membaca seluruh design system dalam format terbuka, jadi agent apa pun, Claude atau bukan, membangun UI dengan token, komponen, dan pola yang sama dengan dokumentasi ini.

## Yang bisa dibaca agent

| Sumber | Kegunaan |
| --- | --- |
| URL halaman + `.md`, misalnya [/id/components/button.md](https://design.sosialoka.tech/id/components/button.md) | Satu halaman dalam Markdown. Setiap halaman juga punya tombol **Salin sebagai Markdown** dan **Unduh .md**. |
| [/id/llms.txt](https://design.sosialoka.tech/id/llms.txt) dan [/llms.txt](https://design.sosialoka.tech/llms.txt) | Indeks semua halaman beserta ringkasan satu kalimat ([llmstxt.org](https://llmstxt.org)). |
| [/id/llms-full.txt](https://design.sosialoka.tech/id/llms-full.txt) dan [/llms-full.txt](https://design.sosialoka.tech/llms-full.txt) | Semua halaman dalam satu file. |
| [/tokens.json](https://design.sosialoka.tech/tokens.json) dan `/tokens/<theme>.json` | Semua token dalam format DTCG, dan nilai jadi satu tema. |
| [/r/react/registry.json](https://design.sosialoka.tech/r/react/registry.json) dan [/r/vue/registry.json](https://design.sosialoka.tech/r/vue/registry.json) | Registry shadcn untuk komponen React dan Vue. |
| [/sosialoka-design-system-docs.zip](https://design.sosialoka.tech/sosialoka-design-system-docs.zip) | Semua yang di atas dalam satu unduhan. |
| `https://design.sosialoka.tech/mcp` | MCP server: pencarian, halaman, komponen, pola, dan token sebagai tool. |

## Sambungkan MCP server

Server ini memakai MCP lewat Streamable HTTP di `https://design.sosialoka.tech/mcp`. Tidak perlu login, karena semua isinya publik. Beri nama `sosialoka-design` supaya cuplikan AGENTS.md di bawah bisa menemukannya.

### Claude Code

```bash
claude mcp add --transport http sosialoka-design https://design.sosialoka.tech/mcp
```

Tambahkan `--scope project` supaya tersimpan di `.mcp.json` repositori dan dipakai seluruh tim.

### Cursor

Di `.cursor/mcp.json` proyek, atau `~/.cursor/mcp.json` untuk semua proyek:

```json
{
  "mcpServers": {
    "sosialoka-design": { "url": "https://design.sosialoka.tech/mcp" }
  }
}
```

### VS Code

Di `.vscode/mcp.json`:

```json
{
  "servers": {
    "sosialoka-design": { "type": "http", "url": "https://design.sosialoka.tech/mcp" }
  }
}
```

### Codex

Di `~/.codex/config.toml`:

```toml
[mcp_servers.sosialoka-design]
url = "https://design.sosialoka.tech/mcp"
```

### Gemini CLI

Di `~/.gemini/settings.json`, atau `.gemini/settings.json` proyek:

```json
{
  "mcpServers": {
    "sosialoka-design": { "httpUrl": "https://design.sosialoka.tech/mcp" }
  }
}
```

## Tool

Setiap tool mengembalikan Markdown. Tool yang menerima `locale` memakai `en` (bawaan) atau `id`.

| Tool | Argumen | Hasil |
| --- | --- | --- |
| `search_docs` | `query`, `locale`, `limit` | Halaman yang cocok, beserta path untuk `get_page`. |
| `get_page` | `path`, `locale` | Satu halaman. Path bisa berupa `foundations/color`, `/id/content/`, atau URL halaman lengkap. |
| `list_components` | tidak ada | Semua komponen beserta framework-nya, dan semua pola halaman. |
| `get_component` | `name`, `platform`, `locale` | Panduan komponen beserta perintah pasang dan kodenya. `platform` (`react`, `vue`, atau `flutter`) menyisakan kode satu platform saja. |
| `get_tokens` | `theme` | Nilai jadi satu tema. Tanpa `theme`, hasilnya daftar tema dan tautan ke file DTCG lengkap. |
| `list_themes` | tidak ada | Daftar tema dan cara menggantinya. |
| `get_pattern` | `name`, `locale` | Satu pola halaman, misalnya `login`, `dashboard`, `list`, atau `form`, beserta kodenya. |

## Pasang komponen lewat MCP shadcn

Registry React juga bisa dipakai lewat MCP server resmi shadcn, jadi agent bisa mencari komponen Sosialoka dan memasangnya berdasarkan nama. Tambahkan registry-nya ke `components.json`:

```json
{
  "registries": {
    "@sosialoka": "https://design.sosialoka.tech/r/react/{name}.json"
  }
}
```

Lalu siapkan MCP server shadcn untuk agent-mu (`claude`, `cursor`, atau `vscode`):

```bash
npx shadcn@latest mcp init --client claude
```

`mcp init` belum bisa menulis konfigurasi Codex. Untuk Codex, tambahkan ini ke `~/.codex/config.toml`:

```toml
[mcp_servers.shadcn]
command = "npx"
args = ["shadcn@latest", "mcp"]
```

Minta item berdasarkan nama registry-nya, misalnya "add @sosialoka/button". MCP shadcn melayani registry React. Di proyek Vue, agent mengambil perintah pasang `shadcn-vue` dari `get_component` atau dari halaman komponen.

## Tambahkan aturannya ke repo-mu

Tempel cuplikan ini ke file `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, atau `.cursor/rules` di repositori produk. File yang sama ada di [/AGENTS.md](https://design.sosialoka.tech/AGENTS.md).

````markdown
## Sosialoka Design System

This product uses the Sosialoka Design System (https://design.sosialoka.tech). Follow it for every UI change.

- **Read before you build.** Index: https://design.sosialoka.tech/llms.txt (Indonesian: https://design.sosialoka.tech/id/llms.txt). Every page is Markdown at its URL + `.md`.
- **Use the MCP server when it is connected** (`sosialoka-design`, https://design.sosialoka.tech/mcp): `search_docs`, `get_component` with `platform`, `get_pattern`, `get_tokens` with a theme.
- **Install components from the registry; don't rewrite them.**
  - React: `npx shadcn@latest add https://design.sosialoka.tech/r/react/<name>.json`
  - Vue: `npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/<name>.json`
  - Install your product's theme first: https://design.sosialoka.tech/web.md
  - Flutter: the `sosialoka_ui` package (https://design.sosialoka.tech/flutter.md).
- **Use tokens, never raw values:** `bg-primary`, `text-muted-foreground`, `border-input`, `rounded-md`. No hex colors, no pixel radius.
- **Set the theme on the root element:** `data-brand` = your product (`lokamusik`, `coverclearance`, `lokasign`, `mylokalink`), or `neutral` when the screen belongs to no product; `data-theme` = `light` or `dark`.
- **Icons:** Lucide. **UI font:** Plus Jakarta Sans.
- **Labels sit above inputs.** One primary action per screen.
- **Copy** (https://design.sosialoka.tech/content.md): Indonesian uses "kamu", never "Anda". Short, active sentences. Error messages come from the backend; the client only disables the button.
````

## Unduh semuanya

[sosialoka-design-system-docs.zip](https://design.sosialoka.tech/sosialoka-design-system-docs.zip) berisi setiap halaman dalam Markdown berbahasa Inggris dan Indonesia, file `llms.txt` dan `llms-full.txt`, `tokens.json`, satu file `tokens/<theme>.json` per tema, dan `AGENTS.md`. Paket ini dibangun ulang setiap kali situs dirilis.
