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

# API Key MCP

> Buat dan kelola API key khusus untuk integrasi Model Context Protocol.

API key MCP menggunakan awalan `nsk_mcp_` serta memiliki kuota dan batasan keamanan terpisah dari API key gateway standar.

## Format API Key

Setiap API key MCP Neosantara mengikuti struktur berikut:

```text theme={"theme":{"light":"ayu-dark","dark":"catppuccin-latte"}}
nsk_mcp_32karakteruuidheksadesimal
```

Contoh: `nsk_mcp_4f8b9e2a1c3d4e5f6a7b8c9d0e1f2a3b`

## Header Autentikasi yang Didukung

Endpoint MCP (`https://api.neosantara.xyz/v1/mcp`) menerima API key melalui salah satu header berikut:

```http theme={"theme":{"light":"ayu-dark","dark":"catppuccin-latte"}}
x-api-key: nsk_mcp_your_key_here
```

atau

```http theme={"theme":{"light":"ayu-dark","dark":"catppuccin-latte"}}
Authorization: Bearer nsk_mcp_your_key_here
```

## Membuat API Key melalui Dashboard

1. Buka [Dashboard Neosantara](https://app.neosantara.xyz/api-keys).
2. Klik tombol **Buat API Key MCP**.
3. Beri nama API key (misal: `[MCP] Cursor IDE`).
4. Salin API key dan simpan di tempat aman karena API key hanya ditampilkan satu kali.

## Membuat API Key melalui API

```bash theme={"theme":{"light":"ayu-dark","dark":"catppuccin-latte"}}
curl -X POST "https://api.neosantara.xyz/v1/mcp/keys" \
  -H "Authorization: Bearer $USER_SESSION_OR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"name": "[MCP] Asisten Koding"}'
```

## Kuota dan Batas Tier

Sistem MCP menerapkan pembatasan rate berbasis sliding counter Redis untuk melindungi performa server:

1. **Batas RPM**: Batas jumlah permintaan per menit untuk setiap API key MCP.
2. **Batas Permintaan Harian**: Batas akumulasi pemanggilan API key MCP dalam rentang 24 jam.
3. **Maksimum Key Aktif**: Setiap akun dapat membuat maksimal **5 API key MCP aktif**.
4. **Batas Token Ringkasan**: Output token maksimum saat menjalankan tool ringkasan audit (`mcp_summary_max_tokens`).

| Tier Akun      | Batas RPM   | Permintaan Harian | Max Summary Tokens |
| :------------- | :---------- | :---------------- | :----------------- |
| **Free**       | 20 RPM      | 500 req/hari      | 900 token          |
| **Basic**      | 40 RPM      | 1.500 req/hari    | 1.200 token        |
| **Standard**   | 60 RPM      | 3.000 req/hari    | 1.600 token        |
| **Pro**        | 120 RPM     | 8.000 req/hari    | 2.200 token        |
| **Enterprise** | 240 RPM     | 20.000 req/hari   | 3.200 token        |
| **Admin**      | Tanpa batas | Tanpa batas       | 6.400 token        |

## Langkah Selanjutnya

| Kebutuhan                | Panduan                                               |
| :----------------------- | :---------------------------------------------------- |
| Arsitektur MCP           | [Ringkasan MCP](/id/agents/overview)                  |
| Hubungkan Cursor         | [Integrasi Cursor](/id/agents/cursor)                 |
| Hubungkan Claude Desktop | [Integrasi Claude Desktop](/id/agents/claude-desktop) |


## Related topics

- [MCP Connector](/id/agents/mcp-connector.md)
- [Integrasi Cursor](/id/agents/cursor.md)
- [Batas Rate & Throughput](/id/guides/rate-limits.md)
