> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sunra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Server MCP

> Pelajari cara mengintegrasikan server MCP SUNRA dengan Cursor, VS Code, Cline, Windsurf, dan lingkungan pengembangan lainnya untuk akses model AI yang mulus.

# Menyiapkan Server MCP SUNRA

Server SUNRA Model Context Protocol (MCP) menyediakan integrasi yang mulus dengan lingkungan pengembangan populer, memungkinkan Anda mengakses model AI SUNRA langsung dari editor atau IDE Anda. Panduan ini akan memandu Anda dalam menyiapkan server MCP dengan berbagai alat.

## Apa itu MCP?

Model Context Protocol (MCP) adalah cara standar bagi asisten AI untuk mengakses sumber daya dan alat eksternal dengan aman. Server MCP SUNRA memungkinkan Anda untuk:

* **Mendaftar dan mencari model AI** yang tersedia di SUNRA
* **Mengirim permintaan** ke titik akhir model mana pun
* **Memeriksa status** dan mengambil hasil dari sistem antrian
* **Mengunggah file** dan mengelola skema model
* **Mengelola otentikasi API** dengan mulus

## Prasyarat

Sebelum menyiapkan server MCP, pastikan Anda memiliki:

1. **Node.js** terinstal (versi 18 atau lebih tinggi)
2. **Kunci API SUNRA** dari [dasbor Anda](https://sunra.ai/dashboard/api-tokens)
3. Editor/IDE pilihan Anda terinstal

## Instalasi

Server MCP SUNRA tersedia sebagai paket npm:

```bash theme={null}
npm install -g @sunra/mcp-server
```

Atau gunakan langsung dengan npx (disarankan):

```bash theme={null}
npx @sunra/mcp-server
```

## Konfigurasi berdasarkan Editor

### Kursor

Kursor mendukung MCP melalui file konfigurasinya. Buat atau perbarui `.cursor/mcp.json` di root proyek Anda:

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"]
    }
  }
}
```

**Konfigurasi global alternatif** di pengaturan pengguna Anda:

1. Buka Pengaturan Kursor
2. Navigasi ke "Server MCP"
3. Tambahkan server baru dengan:
   * **Nama**: `sunra-mcp-server`
   * **Perintah**: `npx`
   * **Argumen**: `@sunra/mcp-server`

### VS Code

Untuk VS Code dengan dukungan MCP (memerlukan ekstensi yang kompatibel):

Buat `.vscode/mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "env": {
        "SUNRA_KEY": "kunci-api-anda-di-sini"
      }
    }
  }
}
```

### Cline

Cline mendukung server MCP melalui pengaturannya. Tambahkan ke konfigurasi Cline Anda:

```json theme={null}
{
  "mcpServers": {
    "sunra": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "description": "Akses model AI SUNRA"
    }
  }
}
```

### Selancar Angin

Untuk Windsurf IDE, konfigurasikan MCP di pengaturan ruang kerja:

```json theme={null}
{
  "mcp": {
    "servers": {
      "sunra-mcp-server": {
        "command": "npx",
        "args": ["@sunra/mcp-server"],
        "timeout": 30000
      }
    }
  }
}
```

### Desktop Claude

Tambahkan ke file konfigurasi Desktop Claude Anda:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"]
    }
  }
}
```

### Alat Lain yang Kompatibel dengan MCP

Untuk alat lain yang mendukung MCP, gunakan pola konfigurasi umum ini:

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "env": {
        "SUNRA_KEY": "${SUNRA_KEY}"
      }
    }
  }
}
```

## Pengaturan Lingkungan

### Mengatur Kunci API Anda

Anda dapat mengonfigurasi kunci API SUNRA Anda dengan beberapa cara:

#### Opsi 1: Variabel Lingkungan (Disarankan)

```bash theme={null}
export SUNRA_KEY="kunci-api-anda-di-sini"
```

Untuk Windows:

```cmd theme={null}
set SUNRA_KEY=kunci-api-anda-di-sini
```

#### Opsi 2: File Konfigurasi

Beberapa editor memungkinkan Anda untuk mengatur variabel lingkungan langsung di konfigurasi MCP:

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "env": {
        "SUNRA_KEY": "kunci-api-anda-di-sini"
      }
    }
  }
}
```

#### Opsi 3: Konfigurasi Runtime

Server MCP juga mendukung pengaturan kunci API saat runtime menggunakan alat `set-sunra-key`.

## Alat MCP yang Tersedia

Setelah dikonfigurasi, Anda akan memiliki akses ke alat-alat ini melalui asisten AI Anda:

### Manajemen Model

* `list-models` - Jelajahi semua model AI yang tersedia
* `search-models` - Temukan model berdasarkan kata kunci
* `model-schema` - Dapatkan skema input/output untuk model tertentu

### Manajemen Permintaan

* `submit` - Kirim permintaan ke titik akhir model
* `status` - Periksa status permintaan dan log
* `result` - Ambil hasil yang sudah selesai
* `cancel` - Batalkan permintaan yang sedang berjalan
* `subscribe` - Kirim dan tunggu penyelesaian

### Manajemen File

* `upload` - Unggah file ke penyimpanan SUNRA

## Contoh Penggunaan

### Mendaftar Model yang Tersedia

```
Gunakan alat list-models untuk menunjukkan model AI apa yang tersedia.
```

### Menghasilkan Gambar

```
Gunakan alat submit untuk menghasilkan gambar dengan titik akhir black-forest-labs/flux-1.1-pro/text-to-image. 
Gunakan prompt: "Pemandangan gunung yang tenang saat matahari terbenam"
```

### Memeriksa Status Permintaan

```
Periksa status ID permintaan: pd_xxxxxx
```

## Pemecahan Masalah

### Masalah Umum

**Server MCP Tidak Ditemukan**

* Pastikan Node.js terinstal dan dapat diakses
* Coba instal secara global: `npm install -g @sunra/mcp-server`
* Verifikasi bahwa path perintah sudah benar

**Kesalahan Otentikasi**

* Periksa apakah variabel lingkungan SUNRA\_KEY Anda telah diatur
* Verifikasi kunci API Anda valid di [Dasbor SUNRA](https://sunra.ai/dashboard/api-tokens)
* Coba atur kunci menggunakan alat `set-sunra-key`

**Waktu Koneksi Habis**

* Tingkatkan nilai waktu habis dalam konfigurasi Anda
* Periksa koneksi internet Anda
* Verifikasi status API SUNRA

**Kesalahan Izin**

* Pastikan izin file yang tepat untuk file konfigurasi
* Coba jalankan dengan izin pengguna yang sesuai

### Mendapatkan Bantuan

Jika Anda mengalami masalah:

1. Periksa [Dokumentasi SUNRA](https://docs.sunra.ai)
2. Tinjau dokumentasi MCP editor Anda
3. Ajukan masalah di [GitHub](https://github.com/sunra-ai/sunra-clients/issues)

## Langkah Berikutnya

Setelah server MCP Anda dikonfigurasi:

1. **Jelajahi Model**: Gunakan `list-models` untuk melihat semua kemampuan AI yang tersedia
2. **Coba Contoh**: Mulailah dengan pembuatan teks-ke-gambar atau teks-ke-video sederhana
3. **Bangun Alur Kerja**: Gabungkan beberapa model untuk alur kerja AI yang kompleks
4. **Pantau Penggunaan**: Lacak penggunaan API Anda di [Dasbor SUNRA](https://sunra.ai/dashboard/)

Integrasi MCP memudahkan untuk menggabungkan model AI yang kuat langsung ke dalam alur kerja pengembangan Anda, memungkinkan pembuatan prototipe yang cepat dan fitur bertenaga AI yang mulus di aplikasi Anda.