StableOps Agent Payments MCP 서버

中文文档

에이전트가 StableOps Agent Payments를 구성하고 실행할 수 있게 해주는 stdio Model Context Protocol(MCP) 서버입니다. 개인 키, 시드 문구, KMS 자격 증명 및 승인 권한은 사용자가 계속 제어합니다.

설치 및 실행

Node.js 20 이상이 필요합니다.

설정 중에는 관리 키만 제공하세요:

STABLEOPS_API_KEY=sk_sandbox_... \
STABLEOPS_AP_ENABLE_MANAGEMENT_WRITES=true \
STABLEOPS_AGENT_KEY_OUTPUT_FILE=/protected/absolute/path/stableops-agent-key \
npx -y -p @stableops/agent-payments-mcp-server@0.2.0 stableops-agent-payments-mcp

관리 모드는 기본적으로 읽기 전용입니다. 변경 도구는 STABLEOPS_AP_ENABLE_MANAGEMENT_WRITES=true로 설정된 경우에만 등록되며, 관리 프로세스는 개방형 검색이나 결제 실행을 절대 노출하지 않습니다. 일회성 Agent Key 비밀은 모델에 절대 반환되지 않습니다. 서버는 발급 전에 0600 대상을 예약하고, 저장에 실패하면 새로 발급된 키를 자동으로 폐기합니다.

지갑 페어링 도구는 사용자가 서명해야 하는 정확한 메시지만 반환합니다. 어떤 도구도 개인 키, 시드 문구 또는 KMS 자격 증명을 받지 않습니다. 사용자는 자신의 지갑에서 서명하고 서명 값만 반환합니다.

일일 런타임 사용을 위해서는 관리 키를 제거하고 제한된 Agent Key와 사용자 운영 서명자 사이드카를 사용하세요:

STABLEOPS_AGENT_KEY=ak_sandbox_... \
STABLEOPS_SIDECAR_URL=http://127.0.0.1:8789 \
STABLEOPS_SIDECAR_TOKEN=... \
npx -y -p @stableops/agent-payments-mcp-server@0.2.0 stableops-agent-payments-mcp

관리 모드와 런타임 모드는 상호 배타적입니다. STABLEOPS_API_KEY와 STABLEOPS_AGENT_KEY가 모두 설정된 경우 서버는 시작을 거부합니다. 런타임 모드는 검색, 예산, 미리보기, 통제된 구매 및 결제 조정 도구만 노출하며, 정책을 변경하거나 자체 결제를 승인할 수 없습니다.

Related MCP server: BotWallet MCP Server

보안 모델

• 서버는 지갑 개인 키, 시드 문구 또는 KMS 자격 증명을 절대 수락하거나 저장하지 않습니다.

• 사용자는 서버 외부에서 지갑 소유권 증명에 서명해야 합니다.

• 런타임 결제는 사용자가 운영하는 제한된 서명자 사이드카만 호출할 수 있으며, 임의의 서명 엔드포인트는 호출할 수 없습니다.

• 알 수 없는 출처, 알 수 없는 수신자 및 임계값 초과 결제는 StableOps에서 사람의 승인이 필요합니다.

• 모든 새 구매에는 안정적인 idempotency_key가 필요하며, 불확실한 결제는 원래 의도와 조정되어야 합니다.

• 모든 구매는 정확한 URL, 최대 견적 및 감사 컨텍스트에 바인딩된 preview_token을 사용해야 하며, 구매 도구는 대체 URL을 허용하지 않습니다.

• 미리보기 토큰은 프로세스 로컬입니다. MCP 재시작 후 원래 정확한 URL을 다시 미리보고 새 토큰으로 재개하세요. API는 의도에 저장된 전체 URL 해시를 검증합니다.

• 256KiB를 초과하는 응답은 단기 MCP 리소스로 제공되며, 모든 인라인 요약은 신뢰할 수 없는 외부 콘텐츠로 표시됩니다.

문서

전체 가이드는 https://stableops.dev/en/docs/agent-payments/quickstart에서 확인하세요.

라이선스

Apache-2.0