Máy chủ Brevo MCP

Brevo cung cấp một máy chủ MCP chính thức được lưu trữ sẵn tại mcp.brevo.com, mở ra 27 module gồm liên hệ, chiến dịch, giao dịch, mẫu, WhatsApp, SMS và nhiều hơn nữa, dưới dạng công cụ mà bất kỳ tác nhân AI nào cũng gọi được. Không cần cài đặt cục bộ.

Bắt đầu nhanh

1. Lấy token MCP của bạn

Brevo MCP dùng một token MCP riêng (không phải khóa API tiêu chuẩn):

1. Đăng nhập vào app.brevo.com
2. Vào Account > SMTP & API > API Keys
3. Nhấp Generate a new API key rồi bật Create MCP server API key
4. Sao chép và lưu token của bạn ở nơi an toàn

2. Kết nối công cụ AI của bạn

{
  "mcpServers": {
    "brevo": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.brevo.com/v1/brevo/mcp",
        "--header",
        "Authorization: Bearer ${BREVO_MCP_TOKEN}"
      ],
      "env": {
        "BREVO_MCP_TOKEN": "paste-your-mcp-token-here"
      }
    }
  }
}

{
  "mcpServers": {
    "brevo": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.brevo.com/v1/brevo/mcp",
        "--header",
        "Authorization: Bearer ${BREVO_MCP_TOKEN}"
      ],
      "env": {
        "BREVO_MCP_TOKEN": "paste-your-mcp-token-here"
      }
    }
  }
}

claude mcp list

{
  "mcpServers": {
    "brevo": {
      "url": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer paste-your-mcp-token-here"
      }
    }
  }
}

{
  "servers": {
    "brevo": {
      "type": "http",
      "url": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer paste-your-mcp-token-here"
      }
    }
  }
}

{
  "mcpServers": {
    "brevo": {
      "serverUrl": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer paste-your-mcp-token-here"
      }
    }
  }
}

3. Kiểm tra kết nối

Sau khi kết nối xong, hãy hỏi trợ lý AI của bạn:

> How many contacts do I have?
> Create an email campaign for my product launch
> Show me deals in the Negotiation stage
> Add a contact to my newsletter list

Các máy chủ hiện có

Máy chủ chính tại /v1/brevo/mcp bao gồm cả 27 module. Với những tình huống sử dụng hẹp, hãy kết nối tới từng máy chủ riêng lẻ để AI có bộ công cụ nhỏ hơn, tập trung hơn và cho chất lượng phản hồi tốt hơn.

Máy chủ chính

Máy chủ riêng lẻ

Chỉ kết nối những module mà tác nhân của bạn cần. Cách này cải thiện chất lượng phản hồi của AI nhờ thu hẹp bề mặt công cụ.

Liên hệ và CRM

Chiến dịch và nhắn tin

Sales CRM

Tài khoản và cài đặt

Mọi endpoint đều dùng URL gốc https://mcp.brevo.com.

Giới hạn công cụ cho tác nhân

Với tác nhân Tajo, chỉ kết nối những máy chủ mà tác nhân đó cần. Đây chính là cách bạn triển khai việc giới hạn quyền, mỗi tác nhân nhận một bộ máy chủ MCP khác nhau.

Ví dụ: tác nhân khôi phục giỏ hàng

Tác nhân này chỉ cần liên hệ, chiến dịch email và SMS:

{
  "mcpServers": {
    "brevo_contacts": {
      "url": "https://mcp.brevo.com/v1/brevo_contacts/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    },
    "brevo_email": {
      "url": "https://mcp.brevo.com/v1/brevo_email_campaign_management/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    },
    "brevo_templates": {
      "url": "https://mcp.brevo.com/v1/brevo_templates/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    },
    "brevo_sms": {
      "url": "https://mcp.brevo.com/v1/brevo_sms_campaigns/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    }
  }
}

Ví dụ: tác nhân Sales CRM

Tác nhân này chỉ làm việc với giao dịch và công ty:

{
  "mcpServers": {
    "brevo_deals": {
      "url": "https://mcp.brevo.com/v1/brevo_deals/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    },
    "brevo_companies": {
      "url": "https://mcp.brevo.com/v1/brevo_companies/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    },
    "brevo_pipelines": {
      "url": "https://mcp.brevo.com/v1/brevo_pipelines/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    },
    "brevo_tasks": {
      "url": "https://mcp.brevo.com/v1/brevo_tasks/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    },
    "brevo_notes": {
      "url": "https://mcp.brevo.com/v1/brevo_notes/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    }
  }
}

Tajo dùng Brevo MCP như thế nào

Tajo đứng giữa ý định của bạn và các công cụ MCP của Brevo. Luồng điều phối như sau:

Marketer Intent
    "Win back customers who haven't ordered in 90 days"
        ↓
Tajo Agent Layer
    Selects: Win-Back Agent
    Agent reads its spec: tools, constraints, strategy
        ↓
Brevo MCP Tools
    brevo_contacts → find churned customers
    brevo_segments → create target segment
    brevo_email    → send recovery campaign
    brevo_sms      → SMS follow-up for non-openers
        ↓
Brevo Platform
    Emails delivered, SMS sent, events tracked

Mỗi đặc tả tác nhân Tajo khai báo những máy chủ Brevo MCP mà nó cần. Lớp điều phối chỉ kết nối đúng các máy chủ đó, qua đó áp dụng nguyên tắc đặc quyền tối thiểu.

Khắc phục sự cố

”Command not found: npx”

Hãy cài Node.js. Cầu nối npx mcp-remote là bắt buộc với Claude Desktop và Claude Code.

Công cụ không hiện ra

• Khởi động lại hoàn toàn ứng dụng (không chỉ tải lại)
• Kiểm tra JSON của bạn không có lỗi cú pháp (dấu phẩy thừa, thiếu dấu ngoặc)
• Kiểm tra token MCP không dính khoảng trắng thừa

Lỗi xác thực

• Kiểm tra token MCP vẫn còn hiệu lực tại Brevo Dashboard > SMTP & API
• Xác nhận header Authorization được định dạng đúng là Bearer <token> với một dấu cách

Bước tiếp theo

• Xây dựng tác nhân đầu tiên, Dùng công cụ Brevo MCP để xây một tác nhân marketing
• Định dạng đặc tả tác nhân, Định nghĩa tác nhân tùy chỉnh với quyền truy cập công cụ được giới hạn
• Tham khảo Skills, Xem cách Tajo Skills xếp lớp lên trên các công cụ MCP
• Tài liệu chính thức của Brevo, Tài liệu đầy đủ về Brevo MCP