Chuyển đến nội dung chính

Tổng quan

Giao thức Ngữ cảnh Mô hình (MCP) là một tiêu chuẩn mở cho phép các ứng dụng AI kết nối an toàn với các nguồn dữ liệu và API bên ngoài. Máy chủ MCP Dodo Payments cung cấp cho các trợ lý AI như Claude, Cursor và các khách hàng tương thích với MCP khác quyền truy cập có cấu trúc vào hạ tầng thanh toán của bạn.

Các khả năng chính

  • Hoạt động thanh toán: Tạo, truy xuất và quản lý thanh toán và hoàn tiền
  • Quản lý đăng ký: Xử lý thanh toán định kỳ, nâng cấp và hủy bỏ
  • Quản lý khách hàng: Quản lý dữ liệu khách hàng và quyền truy cập cổng thông tin
  • Danh mục sản phẩm: Tạo và cập nhật sản phẩm, giá cả và giảm giá
  • Quản lý giấy phép: Kích hoạt, xác thực và quản lý giấy phép phần mềm
  • Thanh toán dựa trên mức sử dụng: Theo dõi và lập hóa đơn cho mức sử dụng theo chỉ số

Cài đặt

Chọn phương pháp cài đặt phù hợp nhất với quy trình làm việc của bạn.

Máy chủ MCP từ xa (Khuyến nghị)

Truy cập máy chủ MCP được lưu trữ mà không cần thiết lập hoặc cài đặt cục bộ. Đây là cách nhanh nhất để bắt đầu.
1

Truy cập máy chủ từ xa

Điều hướng đến https://mcp.dodopayments.com trong trình duyệt của bạn.
2

Cấu hình khách hàng MCP của bạn

Sao chép cấu hình JSON được cung cấp cho khách hàng cụ thể của bạn. Đối với Cursor hoặc Claude Desktop, thêm điều này vào cài đặt MCP của bạn:
{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
3

Xác thực và cấu hình

Quy trình OAuth sẽ yêu cầu bạn:
  • Nhập khóa API Dodo Payments của bạn
  • Chọn môi trường của bạn (kiểm tra hoặc trực tiếp)
  • Chọn loại khách hàng MCP của bạn
Giữ cho khóa API của bạn an toàn. Sử dụng khóa chế độ kiểm tra trong quá trình phát triển.
4

Hoàn tất thiết lập

Nhấp vào Đăng nhập và Phê duyệt để ủy quyền kết nối.
Khi đã kết nối, trợ lý AI của bạn có thể tương tác với API Dodo Payments thay mặt bạn.

Gói NPM

Cài đặt và chạy máy chủ MCP cục bộ bằng NPM.
# Set your API key
export DODO_PAYMENTS_API_KEY="dodo_test_..."

# Run the latest version
npx -y dodopayments-mcp@latest
Sử dụng @latest để luôn kéo phiên bản mới nhất, hoặc ghim vào một phiên bản cụ thể như @1.0.0 để đảm bảo tính ổn định.

Docker

Chạy máy chủ MCP trong môi trường container hóa để triển khai nhất quán.
# Pull the latest image
docker pull ghcr.io/dodopayments/mcp:latest

# Run the container
docker run -e DODO_PAYMENTS_API_KEY="dodo_test_..." \
  -p 3000:3000 \
  ghcr.io/dodopayments/mcp:latest
Hình ảnh Docker có sẵn trên GitHub Container Registry.

Cấu hình Khách hàng

Cấu hình máy chủ MCP Dodo Payments trong khách hàng AI mà bạn ưa thích.
Thiết lập máy chủ MCP Dodo Payments trong Cursor để cho phép truy cập hội thoại vào dữ liệu thanh toán của bạn.
1

Mở cài đặt Cursor

Điều hướng đến Cài đặt Cursor > Tính năng > Giao thức Ngữ cảnh Mô hình hoặc nhấn Cmd/Ctrl + Shift + P và tìm kiếm “Cài đặt MCP”.
2

Chỉnh sửa cấu hình

Nhấp vào Chỉnh sửa Cấu hình để mở tệp mcp_config.json.
3

Thêm cấu hình Dodo Payments

Chọn một trong các cấu hình sau:Máy chủ từ xa (Khuyến nghị)
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
Local NPX
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_..."
      }
    }
  }
}
4

Lưu và khởi động lại

Lưu tệp cấu hình và khởi động lại Cursor.
Xác minh kết nối bằng cách hỏi trợ lý AI về dữ liệu Dodo Payments của bạn.

Lọc công cụ

Kiểm soát các hoạt động API nào được công khai cho trợ lý AI của bạn để tối ưu hóa hiệu suất và duy trì an ninh.

Lọc theo loại hoạt động

Hạn chế quyền truy cập chỉ cho các hoạt động đọc hoặc ghi.
# Only expose read operations (GET requests)
npx dodopayments-mcp --operation=read

# Only expose write operations (POST, PUT, DELETE)
npx dodopayments-mcp --operation=write
Sử dụng --operation=read trong quá trình phát triển để ngăn chặn các thay đổi không mong muốn đối với dữ liệu của bạn.

Lọc theo tài nguyên

Giới hạn các công cụ cho các tài nguyên API cụ thể.
# Only expose payment-related tools
npx dodopayments-mcp --resource=payments

# Expose multiple resources
npx dodopayments-mcp --resource=payments --resource=customers

Bao gồm hoặc loại trừ các công cụ cụ thể

Tinh chỉnh các công cụ riêng lẻ nào có sẵn.
# Include only specific tools
npx dodopayments-mcp --tool=create_payments --tool=list_payments

# Exclude specific tools
npx dodopayments-mcp --no-tool=delete_products

# List all available tools
npx dodopayments-mcp --list

Kết hợp các bộ lọc

Áp dụng nhiều bộ lọc đồng thời để kiểm soát chính xác.
# Only payment and subscription read operations
npx dodopayments-mcp --operation=read --resource=payments --resource=subscriptions

Sử dụng nâng cao

Tích hợp lập trình

Xây dựng các máy chủ MCP tùy chỉnh hoặc mở rộng máy chủ hiện có một cách lập trình.
import { server, endpoints, init } from "dodopayments-mcp/server";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

// Initialize with all default endpoints
init({ server, endpoints });

// Start the server
const transport = new StdioServerTransport();
await server.connect(transport);

Phát triển công cụ tùy chỉnh

Mở rộng máy chủ MCP với các công cụ và logic kinh doanh của riêng bạn.
import { server, init } from "dodopayments-mcp/server";
import createPayments from "dodopayments-mcp/tools/payments/create-payments";
import { zodToJsonSchema } from "zod-to-json-schema";
import { z } from "zod";

// Define a custom tool
const customTool = {
  tool: {
    name: 'calculate_payment_total',
    description: 'Calculate payment total with tax and fees',
    inputSchema: zodToJsonSchema(
      z.object({
        amount: z.number().describe('Base amount in cents'),
        tax_rate: z.number().describe('Tax rate as decimal'),
      })
    ),
  },
  handler: async (client, args) => {
    const total = args.amount * (1 + args.tax_rate);
    return {
      content: [{
        type: 'text',
        text: JSON.stringify({ total, currency: 'usd' }),
      }],
    };
  },
};

// Initialize with custom tools
init({ 
  server, 
  endpoints: [createPayments, customTool] 
});

Thực hành bảo mật tốt nhất

Bảo vệ thông tin xác thực API của bạn và duy trì các tích hợp an toàn.
Không bao giờ cam kết thông tin xác thực vào kiểm soát phiên bảnLưu trữ khóa API trong các biến môi trường hoặc hệ thống quản lý bí mật an toàn.
# Use environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."

# Use a .env file (add to .gitignore)
echo "DODO_PAYMENTS_API_KEY=dodo_test_..." > .env
Thay đổi khóa thường xuyênTạo khóa API mới định kỳ và thu hồi các khóa cũ thông qua bảng điều khiển Dodo Payments của bạn.Sử dụng khóa kiểm tra cho phát triểnLuôn sử dụng khóa API chế độ kiểm tra trong quá trình phát triển để tránh ảnh hưởng đến dữ liệu sản xuất.
Áp dụng lọc công cụ trong sản xuấtGiới hạn các hoạt động được công khai chỉ cho những gì trợ lý AI của bạn cần.
# Production: read-only access
npx dodopayments-mcp --operation=read

# Development: full access
npx dodopayments-mcp
Thực hiện xác thực cho các điểm cuối tùy chỉnhXác thực các yêu cầu và thực thi ủy quyền trong các trình xử lý công cụ tùy chỉnh của bạn.Theo dõi việc sử dụng APITheo dõi hoạt động máy chủ MCP thông qua bảng điều khiển Dodo Payments của bạn và thiết lập cảnh báo cho các mẫu bất thường.
Sử dụng HTTPS cho các máy chủ từ xaLuôn triển khai các máy chủ MCP từ xa phía sau các điểm cuối HTTPS.Thực hiện giới hạn tỷ lệBảo vệ chống lại lạm dụng bằng cách thực hiện giới hạn tỷ lệ ở cả cấp máy chủ MCP và API.Hạn chế quyền truy cập mạngCấu hình các quy tắc tường lửa để giới hạn các khách hàng nào có thể kết nối với máy chủ MCP của bạn.

Khắc phục sự cố

Xác minh khóa API của bạnĐảm bảo khóa API của bạn được thiết lập chính xác và có các quyền cần thiết.
# Test your API key
curl -H "Authorization: Bearer dodo_test_..." \
  https://api.dodopayments.com/payments
Kiểm tra kết nối mạng của bạnXác minh rằng bạn có thể truy cập các điểm cuối API Dodo Payments.Xem nhật ký của khách hàngBật ghi nhật ký chi tiết trong khách hàng MCP của bạn để chẩn đoán các vấn đề kết nối.
Xác nhận môi trường khóa APIĐảm bảo bạn đang sử dụng khóa kiểm tra với các điểm cuối kiểm tra và khóa trực tiếp với các điểm cuối sản xuất.Kiểm tra quyền của khóaXác minh rằng khóa API của bạn có quyền cho các hoạt động mà bạn đang cố gắng thực hiện.Tạo lại thông tin xác thựcNếu vấn đề vẫn tiếp diễn, hãy tạo một khóa API mới thông qua bảng điều khiển của bạn.
Xác thực các tham số đầu vàoĐảm bảo trợ lý AI đang cung cấp các tham số được định dạng chính xác cho mỗi công cụ.Xem các thông báo lỗiKiểm tra phản hồi lỗi từ API để có hướng dẫn cụ thể về những gì đã sai.Kiểm tra trực tiếp với APIXác minh rằng hoạt động hoạt động khi gọi API Dodo Payments trực tiếp qua curl hoặc Postman.

Tài nguyên