Postcept MCP sunucusu
✓ DoğrulandıAI agent eylemlerini Stripe veya Zendesk gibi kayıt sistemlerine karşı doğrulayarak imzalı tamamlanma makbuzları almanızı sağlar.
Ayrıca bilinen adı Postcept/mcp, @postcept/mcp
- Yıldızlar
- 1
- Araçlar
- 6
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.3.3
- Son commit
- 1 Ağu 2026
- Lisans
- MIT
Postcept MCP nedir?
AI agent eylemlerini Stripe veya Zendesk gibi kayıt sistemlerine karşı doğrulayarak imzalı tamamlanma makbuzları almanızı sağlar. 6 araç sunar; örneğin verify_refund, verify_cancellation, verify_ticket.
Özet, projenin README dosyasından oluşturuldu
Postcept MCP sunucusu hakkında
Yüksek riskli AI agent eylemlerinin Stripe veya Zendesk gibi sistemlerde gerçekten gerçekleştiğini doğrulamak, bu server'ın temel işlevidir. Agent'ların sadece tamamladıklarını iddia etmelerinin ötesine geçmelerini sağlayarak; bir iadenin, abonelik iptalinin veya destek talebi çözümünün başarılı olduğunu kanıtlayan imzalı makbuzlar sunar. Bu sayede sözlü bir onay, doğrulanabilir bir kanıta dönüşür.
Geliştiriciler bu server'ı Postcept HTTP API üzerinde ince bir sarmalayıcı (wrapper) olarak kullanırlar; verifications:write izinlerine sahip bir POSTCEPT_API_KEY gereklidir. Güvenliği sağlamak için kayıt sistemlerinize salt okunur (read-only) bir bağlantı olarak çalışır. Bir staging veya self-hosted ortam kullanıyorsanız POSTCEPT_BASE_URL üzerinden yapılandırabilirsiniz. Server, npx kullanılarak Claude Desktop veya Claude Code gibi istemciler içinde kullanılmak üzere tasarlanmıştır.
Belirli araçlar arasında, belirli sonuçları kontrol etmek için verify_refund, verify_cancellation ve verify_ticket bulunur. Test amaçlı olarak agent'lar, deterministik bir sandbox konektörüne karşı çalıştırmak için test: true bayrağını kullanabilirler. Server ayrıca geçmiş makbuzları getirmek için get_verification, canlı sistemleri yeniden kontrol etmek için reconcile_verification ve kurumsal performansı izlemek için verified_completion_rate özelliklerini sunar.
Neler yapabilirsiniz
- 1Agent iş akışlarını güvenli bir şekilde test etmeAgent'a, canlı bir üretim sistemi yerine bir sandbox üzerinde doğrulama akışı çalıştırması talimatını verin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Postcept MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a eklePostcept MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'POSTCEPT_API_KEY=<YOUR_POSTCEPT_API_KEY>' mcp -- npx -y @postcept/mcpPostcept MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@postcept/mcp"
],
"env": {
"POSTCEPT_API_KEY": "<YOUR_POSTCEPT_API_KEY>"
}
}
}
}Postcept MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@postcept/mcp"
],
"env": {
"POSTCEPT_API_KEY": "<YOUR_POSTCEPT_API_KEY>"
}
}
}
}Postcept MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@postcept/mcp"],"env":{"POSTCEPT_API_KEY":"<YOUR_POSTCEPT_API_KEY>"}}'Postcept MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@postcept/mcp"
],
"env": {
"POSTCEPT_API_KEY": "<YOUR_POSTCEPT_API_KEY>"
}
}
}
}Postcept MCP'yi Codex içine yükleyin
$ codex mcp add mcp --env 'POSTCEPT_API_KEY=<YOUR_POSTCEPT_API_KEY>' -- npx -y @postcept/mcpPostcept MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@postcept/mcp"] [mcp_servers.mcp.env] POSTCEPT_API_KEY = "<YOUR_POSTCEPT_API_KEY>"
Postcept MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'POSTCEPT_API_KEY=<YOUR_POSTCEPT_API_KEY>' mcp npx -- -y @postcept/mcpPostcept MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@postcept/mcp"
],
"env": {
"POSTCEPT_API_KEY": "<YOUR_POSTCEPT_API_KEY>"
}
}
}
}Postcept MCP araçları 6
README dosyasından algılandıverify_refundverify_cancellationverify_ticketget_verificationreconcile_verificationverified_completion_rate
| verify_refund | — | |
| verify_cancellation | — | |
| verify_ticket | — | |
| get_verification | — | |
| reconcile_verification | — | |
| verified_completion_rate | — |
Yapılandırma
POSTCEPT_API_KEYGerekliGizliPostcept API key
| Ad | Açıklama | Sunucu |
|---|---|---|
| POSTCEPT_API_KEY | Postcept API key | GerekliGizli |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirpostcept/mcp is public and reachablegithub.com/postcept/mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@postcept/mcp names postcept/mcp as sourcenpmjs.com/package/@postcept/mcp ↗Geçti
- Derleme kökeni (Sigstore onayı)Sigstore attestation for @postcept/mcpnpmjs.com/package/@postcept/mcp/v/0.3.3#provenance ↗Geçti
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-08-01github.com/postcept/mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @postcept/mcpGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok99 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
@postcept/mcp
A Model Context Protocol server that exposes Postcept, outcome verification for AI agents, as MCP tools.
After an agent performs a high-risk action (a refund, a subscription
cancellation, a support-ticket resolution), it calls a verify_* tool to confirm
the action actually completed in the system of record (Stripe, Zendesk, and more)
and obtain a signed completion receipt. "done" becomes proof, not a claim.
The server is a thin wrapper over the live Postcept HTTP API. It holds no credentials of its own beyond your Postcept API key, and verification is read-only against your systems of record.
Configuration
| Variable | Required | Default | Notes |
|---|---|---|---|
POSTCEPT_API_KEY |
yes | none | A Postcept API key (pcpt_sk_...) with verifications:write. |
POSTCEPT_BASE_URL |
no | https://api.postcept.com |
Point at a self-hosted or staging API. |
Create an API key in the Postcept dashboard under API keys.
Use with Claude Desktop / Claude Code
{
"mcpServers": {
"postcept": {
"command": "npx",
"args": ["-y", "@postcept/mcp"],
"env": { "POSTCEPT_API_KEY": "pcpt_sk_..." }
}
}
}
Tools
| Tool | Purpose |
|---|---|
verify_refund |
Verify a claimed refund (exists, amount/currency/customer match, not duplicated). |
verify_cancellation |
Verify a subscription was actually cancelled. |
verify_ticket |
Verify a support ticket is in the expected state. |
get_verification |
Fetch a past verification and its signed receipt by id. |
reconcile_verification |
Re-verify a past verification against the live system of record. |
verified_completion_rate |
Read the organization's Verified Completion Rate. |
Every verify_* tool accepts test: true to run against the deterministic
sandbox connector (excluded from your Verified Completion Rate), so an agent can
exercise the full flow without a live system of record.
A non-verified result (incomplete, duplicated, mismatched,
policy_failed) means the work is not done. Surface the gap and recover.
Advisory, by design
MCP puts the verification call in the agent's hands, which makes it the right integration for development, demos, and workflows where the agent's judgment is already trusted. It is advisory: an agent can skip the call, pass the wrong identifiers, or ignore the answer.
For consequential actions, enforce the decision outside the agent. The workflow
or orchestrator calls the Postcept API (or the SDK's guard()) itself and
branches on safe_to_claim_complete before anything customer-facing happens.
The agent then receives the allowed outcome instead of deciding it. Both
patterns use the same API and the same receipts, what changes is who owns the
branch.
Development
pnpm --filter @postcept/mcp build # compile to dist/
pnpm --filter @postcept/mcp typecheck
POSTCEPT_API_KEY=pcpt_sk_... node dist/index.js # stdio server
Postcept MCP soruları
Postcept MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'POSTCEPT_API_KEY=<YOUR_POSTCEPT_API_KEY>' mcp -- npx -y @postcept/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Postcept MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Postcept MCP hangi araçları sunar?
6 araç sunar; bunlar arasında verify_refund, verify_cancellation, verify_ticket, get_verification, reconcile_verification yer alır.
Postcept MCP server nasıl yapılandırılır?
Ortam değişkenlerinizde (environment variables) bir POSTCEPT_API_KEY ve isteğe bağlı olarak bir POSTCEPT_BASE_URL sağlamanız gerekir.
Doğrulama araçlarını canlı bir kayıt sistemi olmadan test edebilir miyim?
Evet, deterministik bir sandbox konektörüne karşı çalıştırmak için herhangi bir verify_* aracına test: true parametresini geçebilirsiniz.
Bir doğrulama sonucu 'verified' değilse ne olur?
Sonuç incomplete, duplicated, mismatched veya policy_failed ise, bu durum işin aslında tamamlanmadığı anlamına gelir.