<p align="center">
  <img src="assets/coret-agent-kit-hero.png" alt="Coret Agent Kit — one MCP, every agent" width="100%">
</p>

# Coret Agent Kit

Satu skill dan satu MCP resmi untuk membuat, membaca, dan memperbarui mind map [coret.id](https://coret.id) dari agen AI. Perubahan muncul live di editor Coret.

## Sebelum memasang

1. Buat akun Coret dan buka halaman **API Keys** di workspace.
2. Buat key **Sandbox** (`crt_test_`) untuk percobaan awal.
3. Simpan key sebagai environment variable; jangan masukkan ke repo atau prompt.

```bash
export CORET_API_KEY="crt_test_..."
```

Tutorial interaktif dan konfigurasi lengkap: **[coret.id/integrations/ai](https://coret.id/integrations/ai)**

## Instalasi cepat

### Codex

```bash
codex plugin marketplace add Rama-Digital/coret-agent-kit
codex plugin add coret@coret-agent-kit
codex mcp list
```

### Claude Code

```bash
claude plugin marketplace add Rama-Digital/coret-agent-kit
claude plugin install coret@coret-agent-kit
claude mcp list
```

### OpenCode

```bash
npx skills add Rama-Digital/coret-agent-kit --full-depth -a opencode -s coret-mindmap -y
```

Tambahkan remote MCP dari contoh `opencode.json` di [panduan Coret](https://coret.id/integrations/ai).

### Pi

Pi membutuhkan adapter MCP komunitas. Tinjau sumber adapter sebelum memasang karena ekstensi Pi berjalan dengan akses pengguna.

```bash
pi install npm:pi-mcp-adapter
pi install git:github.com/Rama-Digital/coret-agent-kit
```

Adapter membaca `.mcp.json`; salin `plugins/coret/.mcp.json` ke project jika belum ada.

### OpenClaw

```bash
clawhub install coret-mindmap
```

Simpan endpoint `https://mcp.coret.id/mcp` lewat `openclaw mcp set`, lalu verifikasi dengan `openclaw mcp doctor coret --probe`. Contoh siap salin ada di [panduan](https://coret.id/integrations/ai). Jika ClawHub tidak tersedia, gunakan fallback GitHub: `npx skills add Rama-Digital/coret-agent-kit --full-depth -a openclaw -s coret-mindmap -y`.

### Hermes

```bash
hermes skills tap add Rama-Digital/coret-agent-kit
hermes skills install https://raw.githubusercontent.com/Rama-Digital/coret-agent-kit/main/plugins/coret/skills/coret-mindmap/SKILL.md -y
hermes mcp add coret --url https://mcp.coret.id/mcp --auth header
hermes mcp test coret
```

Saat diminta, tempel API key Coret. Hermes menyimpannya lokal sebagai `MCP_CORET_API_KEY`.

## Generic MCP

Transport: Streamable HTTP. Kirim API key sebagai Bearer token.

```json
{
  "mcpServers": {
    "coret": {
      "type": "http",
      "url": "https://mcp.coret.id/mcp",
      "headers": {
        "Authorization": "Bearer ${CORET_API_KEY}"
      }
    }
  }
}
```

Server menyediakan 18 tools untuk map, node, upload gambar, batch, Spidol pada canvas mind map, sketch whiteboard terpisah, share, export, dan dokumentasi kontrak.

## Keamanan

- Mulai dengan key Sandbox dan scope minimum yang dibutuhkan.
- Skill meminta konfirmasi sebelum menghapus map atau node, kecuali penghapusan sudah diminta secara eksplisit.
- Cabut key kapan saja dari workspace Coret.
- Jangan commit key, tempel ke URL, atau kirim lewat chat.

Lisensi: [MIT](LICENSE).