# Panduan ChatGPT Plugins (Apps SDK): Bangun Plugin ERP di MCP

> Connectors menjadi apps, apps menjadi plugins, dan URL Apps SDK kini redirect ke dokumentasi plugins. Inilah wujud ChatGPT plugin di 2026, dan cara membangunnya untuk lookup status order ERP.

URL: https://www.matthewswong.com/id/blog/chatgpt-plugins-apps-sdk-mcp-guide/

- Author: Matthews Wong (https://www.matthewswong.com/id/about/)
- Published: 2026-10-01
- Updated: 2026-10-01
- Category: AI

> **Key takeaway:** ChatGPT plugin di 2026 adalah Apps SDK yang berganti nama dan diperluas: remote MCP server untuk tools, skill SKILL.md opsional untuk workflow, dan UI MCP Apps opsional yang dikembalikan tool lewat resource ui://. Bangun server-nya dulu, uji di developer mode, lalu submit lewat platform dashboard setelah verifikasi organisasi.

Saya kembali membuka dokumentasi Apps SDK untuk membangun integrasi ChatGPT kecil bagi sebuah ERP, yaitu tool yang menjawab posisi sebuah sales order, dan URL-nya justru mendarat di halaman berjudul Plugins. Tutorial yang saya bookmark menyebut apps, pengaturan ChatGPT menyebut plugins, dan jawaban lama masih menyebut connectors. Ketiganya lini produk yang sama dengan tiga nama, dan kode di bawahnya nyaris tidak berubah.

Tulisan ini mengurai nama-nama itu lengkap dengan tanggalnya, lalu membangun produknya: MCP server read-only dengan satu tool ERP, kartu status order yang dirender sebagai MCP App, skill yang membungkus tool itu dalam workflow follow-up, pengujian lokal, dan apa saja yang diminta saat submission ke directory. Setiap nama API berasal dari dokumentasi plugin OpenAI atau repository resmi ext-apps, dengan sumber di akhir tulisan.

## Connectors, apps, plugins: satu lini produk, tiga nama

Kalau Anda mencari ChatGPT plugins Apps SDK dan menemukan halaman yang saling bertentangan, itu karena penamaannya berpindah tiga kali dalam kurang dari setahun. Tidak satu pun perpindahan itu merusak kontrak dasarnya: ChatGPT terhubung ke remote MCP server dan memanggil tools-nya.

| Kapan | Namanya | Yang berubah bagi developer |
| --- | --- | --- |
| 6 Oktober 2025 | Apps di ChatGPT, dibangun dengan Apps SDK (preview) | SDK dibangun di atas MCP dan memperluasnya sehingga satu server mendefinisikan logic sekaligus interface |
| 2025 | Connectors, lalu dilebur ke dalam apps | Integrasi sumber data seperti Google Drive dan SharePoint tidak lagi menjadi konsep terpisah |
| 9 Juli 2026 | Plugins, tercantum di Plugin Directory | Apps yang sudah ada dikemas menjadi plugins, yang bisa membundel apps, skills, dan app templates |
| Sekarang | developers.openai.com/apps-sdk redirect ke /plugins | Dokumentasinya menjelaskan cara membangun plugins dengan skills, MCP server, dan UI opsional |

Konsekuensi praktisnya: tutorial Apps SDK dari akhir 2025 sebagian besar masih benar soal MCP server, tetapi sebagian besar keliru soal packaging dan distribusi. Pertahankan kode server-nya, baca ulang semua hal tentang tempat publikasinya. Perlu dicatat juga bahwa plugins ini tidak berhubungan dengan plugin beta 2023, yang dimatikan pada April 2024. Kata yang sama, sistem yang berbeda.

## Apa sebenarnya ChatGPT plugin di 2026

Halaman arsitektur plugin OpenAI mendaftar bagian-bagiannya, dan hanya sebagian yang wajib. Mulailah dari bentuk terkecil yang mencakup use case Anda; dokumentasinya secara eksplisit mengizinkan MCP server atau UI ditambahkan belakangan.

- MCP server, yang memberi plugin tools dan akses ke sistem eksternal. Server ini wajib memakai transport streamable HTTP di URL publik yang stabil, biasanya berakhiran /mcp.
- Skills, yaitu folder berisi file SKILL.md. ChatGPT membaca name dan description tiap skill lebih dulu, lalu memuat instruksi lengkapnya hanya ketika memutuskan skill itu relevan.
- UI opsional, komponen yang dirender di dalam ChatGPT ketika tool tertentu mengembalikan hasil. UI ini dibangun di atas standar terbuka MCP Apps, bukan format khusus ChatGPT.

Manifest-nya berupa plugin.json portabel di root, dengan field khusus OpenAI di bawah blok extensions.com.openai. Pemisahan ini penting kalau Anda juga menargetkan Codex: menurut OpenAI, satu plugin yang dipublikasikan masuk ke directory yang dipakai bersama oleh ChatGPT dan Codex, dan Codex membaca .codex-plugin/plugin.json sebagai fallback.

## Membangun MCP server status order ERP

Tool ini hanya menjawab satu pertanyaan: berdasarkan nomor sales order, kembalikan stage, tanggal janji kirim, dan jumlah terkirim per baris. Datanya dibaca dari read model di atas ERP, tidak pernah dari endpoint yang bisa memposting dokumen. Registrasi di bawah mengikuti bentuk contoh resmi ext-apps, yang memakai registerAppTool supaya tool bisa membawa tautan ke UI-nya.

Nilai kembaliannya punya tiga kanal, dan bagian inilah yang paling mudah salah. structuredContent adalah data ringkas yang dibaca model sekaligus UI, dan tetap tersedia bagi model di giliran berikutnya, jadi isinya fakta, bukan berhalaman-halaman baris. content adalah teks yang dinarasikan model. _meta adalah data khusus client yang disembunyikan dari model, berguna untuk label yang hanya untuk tampilan.

Description dan annotations bekerja lebih keras daripada handler-nya. Description adalah cara ChatGPT memutuskan kapan memanggil tool, jadi isinya kapan tool dipakai dan apa yang tidak bisa dilakukannya. Ketiga annotations wajib berupa boolean eksplisit: readOnlyHint true untuk retrieval, destructiveHint false karena tidak ada yang ditimpa, openWorldHint false karena datanya terbatas pada satu tenant ERP privat.

## Mengembalikan UI dari tool dengan MCP Apps

UI-nya adalah resource HTML dengan URI ui:// dan MIME type text/html;profile=mcp-app. Tool menunjuk ke resource itu lewat _meta.ui.resourceUri; ChatGPT juga menerima key lama openai/outputTemplate sebagai alias. Saat tool berjalan, host mengambil resource tersebut, merendernya di frame yang di-sandbox, lalu meneruskan hasil tool lewat postMessage. Class App dari package ext-apps membungkus jembatan itu.

Dua aturan dari dokumentasi membentuk kode ini. Perlakukan structuredContent sebagai input yang tidak tepercaya, jadi kartu menulis textContent dan tidak pernah innerHTML. Lalu deklarasikan Content Security Policy pada resource: connectDomains untuk apa pun yang di-fetch kartu, resourceDomains untuk script, font, atau gambar yang dimuatnya. Kartu order yang hanya merender hasil tool tidak butuh keduanya, jadi kedua daftar dibiarkan kosong.

> Kaitkan resource ui:// hanya dengan tools yang memang perlu merendernya. Di plugin ERP, sebagian besar tool seperti pencarian atau total lebih baik dijawab dengan teks; kartu di setiap pemanggilan mengubah percakapan menjadi dashboard yang tidak diminta siapa pun. Saya memberi versi pada URI, seperti contoh di dokumentasinya sendiri, supaya kartu yang didesain ulang menjadi resource baru, bukan perubahan diam-diam.

## Menulis skill yang membungkus tool

Tool menyatakan apa yang bisa dijawab ERP; skill menyatakan bagaimana tugas seorang sales seharusnya berjalan. Skill di bawah mengubah tool status order menjadi rutinitas follow-up order terlambat. Isinya dua field wajib, name dan description yang memberi tahu model kapan mempertimbangkannya, lalu instruksi bernomor yang sederhana.

Nilai terbesarnya ada pada larangan. Langkah empat melarang menjanjikan tanggal kirim baru, karena tool tidak pernah mengembalikannya dan model yang percaya diri akan mengarang tanggal yang terdengar masuk akal untuk customer sungguhan. Langkah lima mencegahnya retry dengan nomor order tebakan. Inilah failure mode yang patut diantisipasi dari model mana pun yang terhubung ke data ERP, dan skill adalah tempat termurah untuk menutupnya.

## Menguji secara lokal dan di developer mode ChatGPT

Jalankan server secara stateless: server dan transport baru untuk tiap request, tanpa session ID. Begitulah contoh ext-apps ditulis, dan artinya replica mana pun di belakang load balancer bisa menjawab panggilan apa pun. Sebelum ChatGPT melihatnya, hubungkan MCP Inspector ke endpoint /mcp lokal dan panggil tool secara manual dengan nomor yang valid, nomor yang tidak dikenal, dan nomor yang formatnya salah.

1. Ekspos server di URL HTTPS publik. ChatGPT hanya terhubung ke remote server yang bisa dijangkau publik lewat HTTPS, jadi localhost butuh tunnel atau deployment staging.
2. Di ChatGPT, buka Settings, lalu Security and login, dan aktifkan developer mode.
3. Di ChatGPT Plugins, pilih tombol plus, masukkan URL MCP server, dan lengkapi detail koneksi untuk membuat plugin pribadi.
4. Install dari daftar personal plugins, lalu ketik @ di chat untuk memanggilnya langsung dan pastikan kartunya tampil serta narasinya sesuai data.

> Akses developer mode tidak sama di setiap paket. Gradually.ai melaporkan bahwa custom MCP apps di Pro hanya berjalan di web dan terbatas pada aksi read dan fetch, sementara dukungan MCP penuh termasuk aksi write sedang digulirkan dalam beta di Business, Enterprise, dan Edu. Rancang plugin ERP dengan prinsip read-first, dan pastikan batas terbaru untuk paket Anda sebelum menjanjikan write tool kepada siapa pun.

## Lolos submission ke Plugin Directory

Submission dilakukan di platform dashboard OpenAI pada menu Plugins, lewat Upload new or existing plugin. Pemeriksaan otomatis dijalankan terhadap package lebih dulu; Anda meninjau temuannya, melengkapi yang dibutuhkan tim review, lalu men-submit draft-nya. Siapkan hal-hal berikut sebelum mulai, karena masing-masing akan memblokir form.

1. Verifikasi dan role: selesaikan verifikasi individu atau bisnis untuk organisasi. Owner bisa submit; anggota lain butuh role Apps Management Write.
2. URL listing: MCP app yang perlu review publik wajib mengisi keempatnya, yaitu websiteURL, supportURL, privacyPolicyURL, dan termsOfServiceURL.
3. Akses reviewer: akun test khusus, URL login, detail tenant, dan langkah sign-in. Untuk ERP, artinya perusahaan demo dengan order yang realistis, tidak pernah data produksi.
4. Test case dan demo: lima test case positif dan tiga negatif, ditambah video walkthrough yang bisa dibuka reviewer.
5. Aset: minimal ikon atau logo app.

Persetujuan tidak otomatis mempublikasikan apa pun. Anda membuka versi yang disetujui lalu memilih Publish plugin saat sudah siap. Guidelines-nya adalah bagian yang biasanya membuat plugin ERP perlu dikerjakan ulang: tools tidak boleh meminta seluruh riwayat percakapan atau field konteks sekadar berjaga-jaga, dan response tidak boleh membawa session ID, trace ID, request ID, atau metadata logging. API ERP mengembalikan semua itu secara default, jadi petakan response-nya ke bentuk yang sempit dengan sengaja.

> Lapisan UI-nya adalah standar terbuka MCP Apps, dipublikasikan sebagai @modelcontextprotocol/ext-apps dengan entry point /server dan /react. Repository-nya mencantumkan ChatGPT, Claude, VS Code, Goose, Postman, dan MCPJam sebagai host yang merendernya, jadi kartu order yang dibangun di sini tidak terkunci pada satu produk chat.

Namanya berganti tiga kali; kontraknya tidak. Bangun MCP server yang sempit dan read-only dengan annotations yang jujur, kembalikan UI hanya ketika gambar lebih jelas daripada kalimat, letakkan workflow beserta larangannya di skill, dan perlakukan checklist submission sebagai bagian dari build, bukan urusan administrasi di akhir.

## Sumber

- OpenAI Developers: dokumentasi Plugins, sebelumnya Apps SDK
- OpenAI: Introducing apps in ChatGPT and the new Apps SDK
- OpenAI Developers: Submit your plugin
- Model Context Protocol: ext-apps, SDK dan spesifikasi MCP Apps
- Gradually.ai: ChatGPT plugins baru, apps, skills, dan MCP dijelaskan

## Source links

- https://developers.openai.com/apps-sdk
- https://openai.com/index/introducing-apps-in-chatgpt/
- https://developers.openai.com/plugins/deploy/submission
- https://github.com/modelcontextprotocol/ext-apps
- https://www.gradually.ai/en/chatgpt-plugins/

## FAQ

### Apakah ChatGPT Apps SDK sama dengan ChatGPT plugins?

Ya, secara praktis. Apps SDK diluncurkan pada Oktober 2025 untuk membangun apps di ChatGPT, dan pada 9 Juli 2026 Plugin Directory menggantikan App Directory, dengan apps yang sudah ada dikemas menjadi plugins. Alamat developers.openai.com/apps-sdk kini redirect ke dokumentasi plugins, dan kode MCP server dari era Apps SDK tetap berlaku.

### Apa isi sebuah ChatGPT plugin di 2026?

Sebuah plugin bisa berisi MCP server yang mengekspos tools, skills yang didefinisikan di file SKILL.md, dan UI opsional yang dirender ketika tool mengembalikan hasil. Hanya bagian yang Anda perlukan yang wajib, dan dokumentasi OpenAI mengizinkan plugin yang isinya skills saja. Manifest-nya berupa plugin.json di root, dengan pengaturan khusus OpenAI di bawah extensions.com.openai.

### Apakah ChatGPT plugins yang baru berhubungan dengan ChatGPT plugins tahun 2023?

Tidak. Plugin beta tahun 2023 dimatikan pada April 2024. Plugins tahun 2026 memakai nama yang sama tetapi dibangun di atas Model Context Protocol, fondasi yang sama dengan Apps SDK, dan membundel apps, skills, serta app templates.

### Bagaimana cara menampilkan UI custom dari tool ChatGPT plugin?

Daftarkan resource HTML dengan URI ui:// dan MIME type text/html;profile=mcp-app, lalu tautkan tool ke resource itu lewat _meta.ui.resourceUri. ChatGPT merender resource tersebut di frame yang di-sandbox dan mengirim hasil tool lewat postMessage. Package @modelcontextprotocol/ext-apps menyediakan registerAppTool, registerAppResource, dan class App untuk view-nya.

### Apa yang perlu disiapkan sebelum submit plugin ke ChatGPT Plugin Directory?

Anda butuh verifikasi organisasi serta hak owner atau role Apps Management Write. MCP app yang direview publik juga butuh URL website, support, privacy policy, dan terms, akun test khusus, lima test case positif dan tiga negatif, video walkthrough, serta ikon. Setelah disetujui, Anda sendiri yang menentukan kapan memilih Publish plugin.

---

- HTML version: https://www.matthewswong.com/id/blog/chatgpt-plugins-apps-sdk-mcp-guide/
- English: https://www.matthewswong.com/en/blog/chatgpt-plugins-apps-sdk-mcp-guide/
- Site index for agents: https://www.matthewswong.com/llms.txt
- Sitemap: https://www.matthewswong.com/sitemap.xml
- API description (OpenAPI): https://www.matthewswong.com/openapi.json
