Postcept MCP server
✓ 인증됨Stripe 또는 Zendesk와 같은 시스템 기록과 AI agent의 작업을 대조하여 서명된 완료 영수증을 확보합니다.
다른 이름 Postcept/mcp, @postcept/mcp
- 스타
- 1
- Tools
- 6
- 다운로드, 30일
- —
- 최신 버전
- 0.3.3
- 마지막 커밋
- 2026년 8월 1일
- 라이선스
- MIT
Postcept MCP란?
Stripe 또는 Zendesk와 같은 시스템 기록과 AI agent의 작업을 대조하여 서명된 완료 영수증을 확보합니다. 6개 도구를 제공합니다. 예: verify_refund, verify_cancellation, verify_ticket.
프로젝트 README에서 생성된 요약
Postcept MCP server 정보
Stripe 또는 Zendesk와 같은 시스템에서 고위험 AI agent 작업이 실제로 발생했는지 검증하는 것이 이 server의 주요 기능입니다. 이 server는 agent가 환불, 구독 취소 또는 지원 티켓 해결이 성공했음을 증명하는 서명된 영수증을 확보함으로써, 단순한 완료 주장 이상의 단계를 수행할 수 있도록 합니다. 이를 통해 구두 확인을 검증 가능한 증거로 전환합니다.
개발자는 이 server를 Postcept HTTP API에 대한 얇은 래퍼로 사용하며, verifications:write 권한이 있는 POSTCEPT_API_KEY가 필요합니다. 보안을 보장하기 위해 시스템 기록에 대한 읽기 전용 연결로 작동합니다. 스테이징 또는 셀프 호스팅 환경을 사용하는 경우 POSTCEPT_BASE_URL을 통해 구성할 수 있습니다. 이 server는 npx를 사용하여 Claude Desktop 또는 Claude Code와 같은 클라이언트 내에서 사용하도록 설계되었습니다.
특정 도구에는 특정 결과를 확인하기 위한 verify_refund, verify_cancellation, verify_ticket이 포함됩니다. 테스트 목적으로 agent는 test: true 플래그를 사용하여 결정론적 샌드박스 커넥터에서 실행할 수 있습니다. 또한 이 server는 과거 영수증을 가져오는 get_verification, 실시간 시스템을 재확인하는 reconcile_verification, 조직의 성능을 모니터링하는 verified_completion_rate를 제공합니다.
활용 사례
- 1agent 워크플로를 안전하게 테스트하기실제 운영 시스템 대신 샌드박스에 대해 검증 흐름을 실행하도록 agent에게 지시합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Postcept MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Postcept MCP 설치
$ claude mcp add --env 'POSTCEPT_API_KEY=<YOUR_POSTCEPT_API_KEY>' mcp -- npx -y @postcept/mcpCursor에 Postcept MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@postcept/mcp"
],
"env": {
"POSTCEPT_API_KEY": "<YOUR_POSTCEPT_API_KEY>"
}
}
}
}VS Code에 Postcept MCP 설치
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@postcept/mcp"
],
"env": {
"POSTCEPT_API_KEY": "<YOUR_POSTCEPT_API_KEY>"
}
}
}
}VS Code CLI에 Postcept MCP 설치
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@postcept/mcp"],"env":{"POSTCEPT_API_KEY":"<YOUR_POSTCEPT_API_KEY>"}}'Claude Desktop에 Postcept MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@postcept/mcp"
],
"env": {
"POSTCEPT_API_KEY": "<YOUR_POSTCEPT_API_KEY>"
}
}
}
}Codex에 Postcept MCP 설치
$ codex mcp add mcp --env 'POSTCEPT_API_KEY=<YOUR_POSTCEPT_API_KEY>' -- npx -y @postcept/mcpCodex config.toml에 Postcept MCP 설치
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@postcept/mcp"] [mcp_servers.mcp.env] POSTCEPT_API_KEY = "<YOUR_POSTCEPT_API_KEY>"
Gemini CLI에 Postcept MCP 설치
$ gemini mcp add -s user -e 'POSTCEPT_API_KEY=<YOUR_POSTCEPT_API_KEY>' mcp npx -- -y @postcept/mcpGemini settings.json에 Postcept MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@postcept/mcp"
],
"env": {
"POSTCEPT_API_KEY": "<YOUR_POSTCEPT_API_KEY>"
}
}
}
}Postcept MCP 도구 6
README에서 감지됨verify_refundverify_cancellationverify_ticketget_verificationreconcile_verificationverified_completion_rate
| verify_refund | — | |
| verify_cancellation | — | |
| verify_ticket | — | |
| get_verification | — | |
| reconcile_verification | — | |
| verified_completion_rate | — |
구성
POSTCEPT_API_KEY필수비밀Postcept API key
| 이름 | 설명 | 유형 |
|---|---|---|
| POSTCEPT_API_KEY | Postcept API key | 필수비밀 |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능postcept/mcp is public and reachablegithub.com/postcept/mcp ↗통과
- 패키지가 이 저장소를 소스로 명시@postcept/mcp names postcept/mcp as sourcenpmjs.com/package/@postcept/mcp ↗통과
- 빌드 출처(Sigstore 증명)Sigstore attestation for @postcept/mcpnpmjs.com/package/@postcept/mcp/v/0.3.3#provenance ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-08-01github.com/postcept/mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @postcept/mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음99 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음6 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기@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 질문
Postcept MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'POSTCEPT_API_KEY=<YOUR_POSTCEPT_API_KEY>' mcp -- npx -y @postcept/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Postcept MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Postcept MCP는 어떤 도구를 제공하나요?
6개 도구를 제공합니다. 예: verify_refund, verify_cancellation, verify_ticket, get_verification, reconcile_verification.
Postcept MCP server를 어떻게 설정합니까?
환경 변수에 POSTCEPT_API_KEY를 제공해야 하며, 선택적으로 POSTCEPT_BASE_URL을 설정할 수 있습니다.
실제 시스템 기록 없이 검증 도구를 테스트할 수 있습니까?
네, 모든 verify_* 도구에 test: true를 전달하면 결정론적 샌드박스 커넥터를 통해 실행할 수 있습니다.
검증 결과가 'verified'가 아니면 어떻게 됩니까?
결과가 incomplete, duplicated, mismatched 또는 policy_failed인 경우 작업이 실제로 완료되지 않았음을 의미합니다.