> ## 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.

# Arsitektur MCP & Agen

> Pahami perbedaan MCP Gateway (Server) dan MCP Connector (Client) di Neosantara.

Neosantara mengimplementasikan Model Context Protocol (MCP) dalam dua peran terpisah: sebagai **MCP Gateway (Server)** untuk menyediakan tools ke IDE dan agen lokal, serta sebagai **MCP Connector (Client)** untuk menghubungkan model AI ke server MCP eksternal milik Anda.

```mermaid theme={"theme":{"light":"ayu-dark","dark":"catppuccin-latte"}}
flowchart TD
    subgraph Mode1["1. MCP Gateway (Neosantara sebagai Server)"]
        direction TB
        C1["IDE & Klien Koding<br/>(Cursor, Claude Code, Cline, Claude Desktop)"]
        G1["Neosantara MCP Gateway<br/>/v1/mcp"]
        subgraph Tools1["Tools Bawaan Neosantara"]
            direction LR
            T1["chat<br/>(Responses API)"]
            T2["list-models<br/>(Katalog Model)"]
            T3["generate-image<br/>(Generasi Gambar)"]
            T4["list-image-models"]
        end
        C1 -->|"SSE / HTTP<br/>Header: x-api-key: nsk_mcp_..."| G1
        G1 --> T1
        G1 --> T2
        G1 --> T3
        G1 --> T4
    end

    subgraph Mode2["2. MCP Connector (Neosantara sebagai Client)"]
        direction TB
        App2["Aplikasi atau Agen Anda"]
        G2["Neosantara Gateway<br/>/v1/chat/completions<br/>(SSRF Protected)"]
        Remote2["Server MCP Eksternal Anda<br/>(GitHub, Database, Slack, CRM)"]
        App2 -->|"Payload Chat<br/>mcp_servers: [...]"| G2
        G2 <-->|"Outbound HTTPS / SSE"| Remote2
    end
```

## Perbandingan Dua Peran MCP

| Kriteria               | MCP Gateway (Server)                              | MCP Connector (Client)                                 |
| :--------------------- | :------------------------------------------------ | :----------------------------------------------------- |
| **Peran Neosantara**   | Menyediakan tools (Server)                        | Mengonsumsi tools (Client)                             |
| **Endpoint**           | `https://api.neosantara.xyz/v1/mcp`               | `https://api.neosantara.xyz/v1/chat/completions`       |
| **Format Autentikasi** | API key MCP khusus (`nsk_mcp_...`)                | API key Gateway standar (`nsk_...`)                    |
| **Pengguna Utama**     | IDE koding, CLI agent, Claude Desktop             | Aplikasi backend, bot otonom, pipeline agent           |
| **Cara Kerja**         | Klien eksternal memanggil tools bawaan Neosantara | Gateway memanggil server MCP Anda saat inferensi model |
| **Protokol**           | SSE atau Streamable HTTP JSON-RPC                 | Streamable HTTP dan SSE outbound dengan proteksi SSRF  |

## Kapan Menggunakan Setiap Mode

### Gunakan MCP Gateway Saat:

* Anda ingin menghubungkan IDE koding (Cursor, Windsurf) atau Claude Desktop ke kapabilitas AI Neosantara.
* Anda memerlukan tools seperti pembuatan gambar atau katalog model langsung dari jendela percakapan IDE.
* Anda mengonfigurasi agen CLI seperti Claude Code untuk memanggil tools Neosantara.

### Gunakan MCP Connector Saat:

* Anda membangun aplikasi yang membutuhkan model LLM untuk mengakses database pribadi, API internal, atau layanan pihak ketiga melalui server MCP Anda sendiri.
* Anda tidak ingin menulis kode orkestrasi tool-calling manual di sisi klien. Cukup berikan URL server MCP Anda, dan Neosantara akan mengelola penemuan tools, pemanggilan fungsi, dan penanganan respons secara otomatis.

## Panduan Terkait

<CardGroup cols={2}>
  <Card title="MCP Connector" icon="network" href="/id/agents/mcp-connector">
    Hubungkan model chat ke server MCP eksternal milik Anda secara otomatis.
  </Card>

  <Card title="API Key MCP" icon="key" href="/id/agents/mcp-keys">
    Format key nsk\_mcp\_, batas rate per tier, dan cara pembuatannya.
  </Card>

  <Card title="Asisten Koding & IDE" icon="laptop" href="/id/agents/claude-code">
    Panduan konfigurasi untuk Claude Code, OpenCode, Cursor, dan Cline.
  </Card>

  <Card title="Claude Desktop" icon="https://mintcdn.com/neosantara/uq2XlSQ_dSPDIOXL/images/integrations/claude.svg?fit=max&auto=format&n=uq2XlSQ_dSPDIOXL&q=85&s=5f0be7b8eabc64ce5a9097ebc400b6b2" href="/id/agents/claude-desktop" width="24" height="24" data-path="images/integrations/claude.svg">
    Konfigurasikan aplikasi desktop Claude dengan transport SSE Neosantara.
  </Card>
</CardGroup>


## Related topics

- [Integrasi Cursor](/id/agents/cursor.md)
- [Integrasi Claude Code](/id/agents/claude-code.md)
- [Agen Cloud (Hosted)](/id/agents/cloud-agents.md)
- [MCP Connector](/id/agents/mcp-connector.md)