Postman API

resmi

Postman API ile etkileşim için bir MCP sunucusu olup, bir API anahtarı gerektirir.

GitHub

317

Bu MCP'yi deneyinSponsorlu

Postman API MCP ile neler yapabilirsiniz?

Koleksiyonları yönetin — Asistanınızdan, doğrudan editörünüzden Postman koleksiyonları ve dokümantasyonları oluşturmasını, etiketlemesini veya güncellemesini isteyin.
İstemci kodu oluşturun — API tanımlarınızdan, en iyi uygulamaları ve proje kurallarını takip eden, üretime hazır istemci kodu talep edin.
Koddan spesifikasyonlar oluşturun — Asistanınızın, kod tabanınızdan API spesifikasyonları üretmesini ve bunları Postman koleksiyonlarına dönüştürmesini sağlayın.
Ortamları yönetin — IDE'nizden ayrılmadan çalışma alanları ve ortamlar oluşturması ve ortam değişkenlerini yönetmesi için asistanınıza talimat verin.
API testlerini çalıştırın — Yerel sunucuyu kullanarak API'lerinizi, yerel uç noktalar dahil, Postman koleksiyonlarınıza karşı sürekli olarak test edin.

Barındırılan MCP Sunucusu

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

Claude Code, Codex, Cursor ve daha fazlasına kurulur

Dokümantasyon

Postman MCP Sunucusu

Postman MCP Sunucusu, Model Context Protocol (MCP) uygulayarak AI ajanlarını ve kodlama asistanlarını — Claude Code, Cursor, VS Code Copilot, GitHub Copilot CLI ve Gemini CLI dahil — doğrudan Postman çalışma alanlarınıza, koleksiyonlarınıza, spesifikasyonlarınıza ve ortamlarınıza bağlar.

Postman ayrıca sunucuyu bir npm paketi olarak da sunar.

Ajanlara özel kurulum içeren tam kurulum kılavuzu için Postman'ın MCP Sunucusu ürün sayfasına bakın.

Postman MCP Sunucusu koleksiyonu

Postman MCP Sunucusu koleksiyonu, Postman MCP Sunucusunu keşfetmenin, test etmenin ve bağlanmanın en hızlı yoludur. Şunlar için kullanın:

Tüm yapılandırmalarda mevcut araçların tam listesine göz atın.
Uzak sunucuya bağlanın ve test edin — Full ve Minimal.
Yerel sunucuya bağlanın ve test edin.

Araç yapılandırmaları

Minimal — (Varsayılan) Temel Postman işlemleri için yalnızca gerekli araçları içerir. Koleksiyonlar, çalışma alanları veya ortamlar gibi tek bir Postman öğesini değiştirmek isteyen kullanıcılar için idealdir.
Code — Genel ve dahili API tanımlarından yüksek kaliteli, iyi organize edilmiş istemci kodu üretmek için araçlar içerir. API'leri tüketmesi veya ajanlarına API bağlamı alması gereken kullanıcılar için idealdir.
Full — Mevcut tüm Postman API araçlarını (100+ araç) içerir. Gelişmiş iş birliği ve Postman'ın Kurumsal özellikleriyle ilgilenen kullanıcılar için idealdir.
Learn — Kılavuzlar, eğitimler ve referans içerikleri için Postman Dokümanlarında arama yapar. Postman özelliklerini keşfetmesi, API kavramlarını araştırması veya öğrenme kaynakları bulması gereken ajanlar için idealdir.

Kimlik doğrulama

En iyi geliştirici deneyimi ve en hızlı kurulum için uzak sunucuda OAuth kullanın (https://mcp.postman.com). OAuth, MCP Yetkilendirme spesifikasyonuyla tamamen uyumludur ve manuel API anahtarı yapılandırması gerektirmez.

AB uzak sunucusu ve yerel sunucu yalnızca Postman API anahtarı kimlik doğrulamasını destekler.

Hızlı başlangıç

Uzak (OAuth uyumlu herhangi bir MCP ana bilgisayarı):

Bu URL'yi MCP ana bilgisayarınızın yapılandırmasına ekleyin:

https://mcp.postman.com/minimal

Code veya Full modu için /minimal değerini /code veya /mcp olarak değiştirin. AB veya API anahtarı kimlik doğrulaması için Authorization: Bearer <POSTMAN_API_KEY> değerini bir başlık olarak iletin.

Yerel:

npx @postman/postman-mcp-server

Code veya Full modu için --code veya --full ekleyin. POSTMAN_API_KEY değerini bir ortam değişkeni olarak ayarlayın.

IDE'ye özel kurulum talimatları için aşağıdaki tabloya bakın. Daha fazla bilgi için Postman MCP Sunucusu dokümanlarına bakın.

Desteklenen ajanlar ve IDE'ler

Ajan / IDE	Uzak	Yerel
Claude Code	Dokümanlar	Dokümanlar
Claude Desktop	Dokümanlar	Dokümanlar
Cursor	Dokümanlar	Dokümanlar
VS Code	Dokümanlar	Dokümanlar
Codex	Dokümanlar	Dokümanlar
Antigravity CLI	Dokümanlar	Dokümanlar
GitHub Copilot CLI	Dokümanlar	Dokümanlar
Kiro	Dokümanlar	Dokümanlar
Docker	—	Dokümanlar

AB desteği

Postman MCP Sunucusu, uzak ve yerel sunucular için AB bölgesini destekler:

Streamable HTTP için uzak sunucu https://mcp.eu.postman.com/mcp (Full), https://mcp.eu.postman.com/code ve https://mcp.eu.postman.com/minimal adreslerinde mevcuttur.
STDIO genel paketi için --region eu bayrağını kullanın veya POSTMAN_API_BASE_URL ortam değişkenini doğrudan ayarlayın.
OAuth, AB sunucusu için desteklenmez. AB uzak sunucusu yalnızca API anahtarı kimlik doğrulamasını destekler.

Kullanım senaryoları

API Testi — Postman koleksiyonunuzu kullanarak API'nizi sürekli test edin. Uzak sunucu iş istasyonunuza ağ erişimine sahip olmayacağından, yerel API'leri test etmek için yerel sunucuyu kullanın.
Kod senkronizasyonu — Kodunuzu Postman Koleksiyonlarınızla ve spesifikasyonlarınızla senkronize tutun.
Koleksiyon yönetimi — Düzenleyicinizden ayrılmadan koleksiyonlar oluşturun ve etiketleyin, dokümantasyonu güncelleyin, yorum ekleyin veya birden çok koleksiyonda işlemler gerçekleştirin.
Çalışma alanı ve ortam yönetimi — Çalışma alanları ve ortamlar oluşturun, ayrıca ortam değişkenlerini yönetin.
Otomatik spesifikasyon oluşturma — Kodunuzdan spesifikasyonlar oluşturun ve bunları koleksiyonlar üretmek için kullanın.
İstemci kodu üretimi — En iyi uygulamaları ve proje kurallarını takip ederek API'leri tüketen üretime hazır istemci kodu üretin.

Docker

Docker kurulumu ve yüklemesi için DOCKER.md dosyasına bakın.

Katkıda bulunma

Hata raporları, araç istekleri ve dokümantasyon düzeltmeleri memnuniyetle karşılanır — CONTRIBUTING.md dosyasına bakın.

Buradaki MCP araç tanımları ve sunucu uygulaması, Postman'ın dahili kaynağından senkronize edilir; bu nedenle src/ altındaki dosyalarda yapılan değişiklikler bu depoda birleştirilemez — ancak bu değişikliklerin yapılma yolu sorunlardır ve gönderilen katkıları kredilendiririz. Dokümantasyon ve depo araçları doğrudan pull request kabul eder.

Bir güvenlik sorunu mu buldunuz? SECURITY.md dosyasına bakın — lütfen herkese açık bir sorun açmayın.

Sorular ve destek

MCP isteklerini gerçekleştirmek için Postman'ı nasıl kullanacağınızı öğrenmek için MCP isteklerinizi koleksiyonlarınıza ekleyin bölümüne bakın.
Ne oluşturduğunuzu paylaşmak, soru sormak ve yardım almak için Postman Topluluğunu ziyaret edin.
Postman MCP Sunucusu koleksiyonunu kullanarak hem uzak hem de yerel sunuculara bağlanabilir ve test edebilirsiniz.
Hataları bildirin ve araçları GitHub Sorunlarında talep edin. Sorunuz için hangi kanalın uygun olduğunu görmek için SUPPORT.md dosyasına bakın.

Anahtar kelimeler

Model Context Protocol · MCP Sunucusu · Postman · AI Ajanları · Claude Code · Cursor · VS Code · Spesifikasyonlar · REST API · API Testi · TypeScript · OpenAPI