Postman API

npx add-mcp 'https://mcp.postman.com/minimal'

Server MCP Postman

Server MCP Postman mengimplementasikan Model Context Protocol (MCP) untuk menghubungkan agen AI dan asisten coding — termasuk Claude Code, Cursor, VS Code Copilot, GitHub Copilot CLI, dan Gemini CLI — langsung ke workspace, koleksi, spesifikasi, dan environment Postman Anda.

Postman juga menawarkan server ini sebagai paket npm.

Untuk panduan instalasi lengkap dengan pengaturan khusus agen, lihat halaman produk Server MCP Postman.

---

Koleksi Server MCP Postman

Koleksi Server MCP Postman adalah cara tercepat untuk menjelajahi, menguji, dan terhubung ke Server MCP Postman. Gunakan untuk:

• Menelusuri daftar lengkap alat yang tersedia di semua konfigurasi.
• Terhubung dan menguji server jarak jauh — Full dan Minimal.
• Terhubung dan menguji server lokal.

---

Konfigurasi alat

• Minimal — (Default) Hanya menyertakan alat penting untuk operasi Postman dasar. Ideal untuk pengguna yang ingin memodifikasi satu elemen Postman, seperti koleksi, workspace, atau environment.
• Code — Menyertakan alat untuk menghasilkan kode klien berkualitas tinggi dan terorganisir dari definisi API publik dan internal. Ideal untuk pengguna yang perlu mengonsumsi API atau memberikan konteks API ke agen mereka.
• Full — Menyertakan semua alat API Postman yang tersedia (100+ alat). Ideal untuk pengguna yang terlibat dalam kolaborasi tingkat lanjut dan fitur Enterprise Postman.
• Learn — Mencari Dokumentasi Postman untuk panduan, tutorial, dan konten referensi. Ideal untuk agen yang perlu menemukan fitur Postman, mencari konsep API, atau menemukan sumber belajar.

---

Autentikasi

Untuk pengalaman pengembang terbaik dan pengaturan tercepat, gunakan OAuth di server jarak jauh (https://mcp.postman.com). OAuth sepenuhnya sesuai dengan spesifikasi Otorisasi MCP dan tidak memerlukan konfigurasi kunci API manual.

Server jarak jauh EU dan server lokal hanya mendukung autentikasi kunci API Postman.

---

Mulai cepat

Jarak jauh (host MCP apa pun yang kompatibel dengan OAuth):

Tambahkan URL ini ke konfigurasi host MCP Anda:

https://mcp.postman.com/minimal

Ubah /minimal menjadi /code atau /mcp untuk mode Code atau Full. Untuk EU atau autentikasi kunci API, teruskan Authorization: Bearer <POSTMAN_API_KEY> sebagai header.

Lokal:

npx @postman/postman-mcp-server

Tambahkan --code atau --full untuk mode Code atau Full. Tetapkan POSTMAN_API_KEY sebagai variabel lingkungan.

Untuk petunjuk pengaturan khusus IDE, lihat tabel berikut. Untuk informasi lebih lanjut, lihat dokumentasi Server MCP Postman.

---

Agen dan IDE yang didukung

Agen / IDE	Jarak Jauh	Lokal
Claude Code	Dokumentasi	Dokumentasi
Claude Desktop	Dokumentasi	Dokumentasi
Cursor	Dokumentasi	Dokumentasi
VS Code	Dokumentasi	Dokumentasi
Codex	Dokumentasi	Dokumentasi
Antigravity CLI	Dokumentasi	Dokumentasi
GitHub Copilot CLI	Dokumentasi	Dokumentasi
Kiro	Dokumentasi	Dokumentasi
Docker	—	Dokumentasi

---

Dukungan EU

Server MCP Postman mendukung wilayah EU untuk server jarak jauh dan lokal:

• Untuk streamable HTTP, server jarak jauh tersedia di https://mcp.eu.postman.com/mcp (Full), https://mcp.eu.postman.com/code, dan https://mcp.eu.postman.com/minimal.
• Untuk paket publik STDIO, gunakan flag --region eu, atau tetapkan variabel lingkungan POSTMAN_API_BASE_URL secara langsung.
• OAuth tidak didukung untuk server EU. Server jarak jauh EU hanya mendukung autentikasi kunci API.

---

Kasus penggunaan

• Pengujian API — Uji API Anda secara berkelanjutan menggunakan koleksi Postman Anda. Gunakan server lokal untuk menguji API lokal, karena server jarak jauh tidak akan memiliki akses jaringan ke workstation Anda.
• Sinkronisasi kode — Jaga kode Anda tetap sinkron dengan Koleksi Postman dan spesifikasi Anda.
• Manajemen koleksi — Buat dan beri tag koleksi, perbarui dokumentasi, tambahkan komentar, atau lakukan tindakan di beberapa koleksi tanpa meninggalkan editor Anda.
• Manajemen workspace dan environment — Buat workspace dan environment, serta kelola variabel lingkungan.
• Pembuatan spesifikasi otomatis — Buat spesifikasi dari kode Anda dan gunakan untuk menghasilkan koleksi.
• Generasi kode klien — Hasilkan kode klien siap produksi yang mengonsumsi API mengikuti praktik terbaik dan konvensi proyek.

---

Docker

Untuk pengaturan dan instalasi Docker, lihat DOCKER.md.

---

Kontribusi

Laporan bug, permintaan alat, dan perbaikan dokumentasi semuanya diterima — lihat CONTRIBUTING.md.

• Laporkan bug
• Minta alat, atau perubahan pada alat
• Laporkan masalah dokumentasi

Definisi alat MCP dan implementasi server di sini disinkronkan dari sumber kebenaran internal Postman, sehingga perubahan pada file di bawah src/ tidak dapat digabungkan di repositori ini — tetapi masalah adalah cara perubahan tersebut dibuat, dan kami memberikan kredit atas kontribusi yang dirilis. Dokumentasi dan peralatan repositori menerima pull request secara langsung.

Menemukan masalah keamanan? Lihat SECURITY.md — mohon jangan buka masalah publik.

---

Pertanyaan dan dukungan

• Lihat Tambahkan permintaan MCP Anda ke koleksi Anda untuk mempelajari cara menggunakan Postman untuk melakukan permintaan MCP.
• Kunjungi Komunitas Postman untuk berbagi apa yang telah Anda buat, mengajukan pertanyaan, dan mendapatkan bantuan.
• Anda dapat terhubung ke server jarak jauh dan lokal serta mengujinya menggunakan Koleksi Server MCP Postman.
• Laporkan bug dan minta alat di GitHub Issues. Lihat SUPPORT.md untuk saluran mana yang sesuai dengan pertanyaan Anda.

---

Kata kunci

Model Context Protocol · Server MCP · Postman · Agen AI · Claude Code · Cursor · VS Code · Spesifikasi · REST API · Pengujian API · TypeScript · OpenAPI