모델 컨텍스트 프로토콜(MCP)은 AI 애플리케이션이 외부 데이터 소스 및 API에 안전하게 연결할 수 있도록 하는 개방형 표준입니다. Dodo Payments MCP 서버는 Claude, Cursor 및 기타 MCP 호환 클라이언트와 같은 AI 어시스턴트에게 귀하의 결제 인프라에 대한 구조화된 접근을 제공합니다.
# Pull the latest imagedocker pull ghcr.io/dodopayments/mcp:latest# Run the containerdocker run -e DODO_PAYMENTS_API_KEY="dodo_test_..." \ -p 3000:3000 \ ghcr.io/dodopayments/mcp:latest
# Include only specific toolsnpx dodopayments-mcp --tool=create_payments --tool=list_payments# Exclude specific toolsnpx dodopayments-mcp --no-tool=delete_products# List all available toolsnpx dodopayments-mcp --list
import { server, endpoints, init } from "dodopayments-mcp/server";import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";// Initialize with all default endpointsinit({ server, endpoints });// Start the serverconst transport = new StdioServerTransport();await server.connect(transport);
자격 증명을 버전 관리에 커밋하지 마십시오API 키를 환경 변수 또는 안전한 비밀 관리 시스템에 저장합니다.
복사
# Use environment variablesexport DODO_PAYMENTS_API_KEY="dodo_test_..."# Use a .env file (add to .gitignore)echo "DODO_PAYMENTS_API_KEY=dodo_test_..." > .env
정기적으로 키를 교체하십시오정기적으로 새로운 API 키를 생성하고 Dodo Payments 대시보드를 통해 이전 키를 취소합니다.개발 중에는 테스트 키를 사용하십시오생산 데이터에 영향을 주지 않도록 항상 개발 중에는 테스트 모드 API 키를 사용하십시오.
접근 제어
생산에서 도구 필터링 적용AI 어시스턴트가 필요로 하는 작업만 노출되도록 제한합니다.
복사
# Production: read-only accessnpx dodopayments-mcp --operation=read# Development: full accessnpx dodopayments-mcp
사용자 정의 엔드포인트에 대한 인증 구현요청을 검증하고 사용자 정의 도구 핸들러에서 권한 부여를 시행합니다.API 사용 모니터링Dodo Payments 대시보드를 통해 MCP 서버 활동을 추적하고 비정상적인 패턴에 대한 알림을 설정합니다.
네트워크 보안
원격 서버에 HTTPS 사용항상 HTTPS 엔드포인트 뒤에 원격 MCP 서버를 배포합니다.요율 제한 구현MCP 서버와 API 수준 모두에서 요율 제한을 구현하여 남용으로부터 보호합니다.네트워크 접근 제한어떤 클라이언트가 MCP 서버에 연결할 수 있는지를 제한하기 위해 방화벽 규칙을 구성합니다.
# Test your API keycurl -H "Authorization: Bearer dodo_test_..." \ https://api.dodopayments.com/payments
네트워크 연결 확인Dodo Payments API 엔드포인트에 도달할 수 있는지 확인합니다.클라이언트 로그 검토연결 문제를 진단하기 위해 MCP 클라이언트에서 자세한 로깅을 활성화합니다.
인증 오류
API 키 환경 확인테스트 엔드포인트에는 테스트 키를, 생산 엔드포인트에는 라이브 키를 사용하고 있는지 확인합니다.키 권한 확인API 키가 시도하는 작업에 대한 권한이 있는지 확인합니다.자격 증명 재생성문제가 지속되면 대시보드를 통해 새로운 API 키를 생성합니다.
도구 실행 실패
입력 매개변수 검증AI 어시스턴트가 각 도구에 대해 올바르게 형식화된 매개변수를 제공하고 있는지 확인합니다.오류 메시지 검토API의 오류 응답을 확인하여 무엇이 잘못되었는지에 대한 구체적인 지침을 확인합니다.API 직접 테스트curl 또는 Postman을 통해 Dodo Payments API를 직접 호출할 때 작업이 작동하는지 확인합니다.