Rivalize

Máy chủ MCP Rivalize

Thông tin tình báo cạnh tranh có nguồn gốc, có ngày tháng cho trợ lý AI của bạn, qua Giao thức Ngữ cảnh Mô hình (Model Context Protocol).

Chức năng

Máy chủ này kết nối Claude, Cursor hoặc bất kỳ máy khách MCP nào khác với Rivalize. Trợ lý của bạn có thể phân tích định vị, giá cả, quảng cáo, sự hiện diện trên mạng xã hội, đánh giá, tuyển dụng và đà phát triển của đối thủ cạnh tranh chỉ trong một lần gọi, tìm kiếm trong vũ trụ các công ty được theo dõi của Rivalize, đồng thời đọc các dự án, báo cáo, thẻ chiến đấu, dòng thời gian và bằng chứng trong tài khoản Rivalize của chính bạn. Mọi câu trả lời đều đến từ dữ liệu Rivalize đã thu thập, kèm ngày tháng và nguồn, thay vì từ trí nhớ của mô hình.

Máy chủ chỉ đọc theo mặc định. Một công cụ ghi, add_competitor, khả dụng khi bạn chọn tham gia với RIVALIZE_MCP_ALLOW_WRITES=1.

Bắt đầu nhanh

Yêu cầu Node.js 22 trở lên (node --version).

1. Tạo tài khoản tại rivalize.ai.
2. Tạo khóa API trong Bảng điều khiển → Cài đặt → Khóa API. Khóa bắt đầu bằng rk_live_. Khóa từ bất kỳ gói nào đều hoạt động, kể cả gói miễn phí, gói này bị giới hạn tốc độ đọc.
3. Thêm máy chủ vào máy khách của bạn bằng một trong các khối bên dưới.

Claude Desktop

Chỉnh sửa ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) hoặc %APPDATA%\Claude\claude_desktop_config.json (Windows), sau đó khởi động lại Claude Desktop:

{
  "mcpServers": {
    "rivalize": {
      "command": "npx",
      "args": ["-y", "@rivalize/mcp"],
      "env": { "RIVALIZE_API_KEY": "rk_live_..." }
    }
  }
}

Claude Code

claude mcp add rivalize -e RIVALIZE_API_KEY=rk_live_... -- npx -y @rivalize/mcp

Cursor

Thêm vào .cursor/mcp.json trong dự án của bạn, hoặc ~/.cursor/mcp.json cho tất cả các dự án:

{
  "mcpServers": {
    "rivalize": {
      "command": "npx",
      "args": ["-y", "@rivalize/mcp"],
      "env": { "RIVALIZE_API_KEY": "rk_live_..." }
    }
  }
}

Cline

Trong Cline, mở bảng MCP Servers, chọn Configure, rồi Configure MCP Servers. Thao tác này mở cline_mcp_settings.json. Thêm:

{
  "mcpServers": {
    "rivalize": {
      "command": "npx",
      "args": ["-y", "@rivalize/mcp"],
      "env": { "RIVALIZE_API_KEY": "rk_live_..." }
    }
  }
}

Lưu tệp. Máy chủ rivalize xuất hiện với chấm xanh sau khoảng 10 đến 15 giây (lần khởi động đầu tiên tải xuống gói). Trên Windows, nếu không khởi động được, hãy dùng "command": "cmd" và "args": ["/c", "npx", "-y", "@rivalize/mcp"].

Nếu bạn nhờ Cline cài đặt giúp, hãy trỏ tới llms-install.md.

Bất kỳ máy khách MCP nào (stdio)

Máy chủ nói MCP qua stdin và stdout. Cấu hình máy khách của bạn để khởi chạy:

Cài đặt	Giá trị
Lệnh	npx
Đối số	-y @rivalize/mcp
Biến môi trường	RIVALIZE_API_KEY=rk_live_...
Giao thức vận chuyển	stdio

Trên Windows, một số máy khách không thể khởi chạy npx trực tiếp vì nó là npx.cmd. Thay vào đó, hãy dùng cmd làm lệnh và /c npx -y @rivalize/mcp làm đối số.

Công cụ

Mười ba công cụ chỉ đọc luôn khả dụng. add_competitor chỉ được đăng ký khi RIVALIZE_MCP_ALLOW_WRITES được đặt thành 1, true hoặc yes; nếu không, công cụ không tồn tại cho máy khách.

Công cụ	Quyền truy cập	Chức năng	Đối số chính
teardown_competitor	đọc	Phân tích chiến lược đối thủ trong một lần gọi dưới dạng Markdown: định vị, giá cả, quảng cáo, mạng xã hội, đánh giá, tuyển dụng, đà phát triển và điểm yếu để tấn công, kèm thời điểm dữ liệu được làm mới lần cuối	domain (bắt buộc)
list_universe_companies	đọc	Tìm kiếm trong vũ trụ Rivalize, tập dữ liệu xuyên khách hàng về các công ty được theo dõi	q, category (slug), layer, limit (1-100), offset
get_universe_company	đọc	Hồ sơ vũ trụ đầy đủ cho một công ty: danh tính, giá cả, tính năng, quảng cáo, mạng xã hội, đánh giá, tài trợ và tuyển dụng, xếp hạng, tín hiệu, đà phát triển	domain (bắt buộc), layers
list_projects	đọc	Các dự án trong tài khoản của bạn; trả về project_id mà các công cụ khác nhận	không có
list_reports	đọc	Báo cáo của bạn, mới nhất trước. Đọc không bao giờ tạo báo cáo	project_id, limit (1-100), offset
get_report	đọc	Một báo cáo dưới dạng Markdown, toàn bộ hoặc một phần hoặc từng đối thủ một lúc	report_id (bắt buộc), section, competitor, page
list_competitors	đọc	Các đối thủ bạn theo dõi, kèm điểm đà phát triển, mức độ đe dọa và, nếu API cung cấp, vị thế của từng đối thủ trên Brief của bạn	project_id, limit (1-100), offset
get_competitor_intelligence	đọc	Thông tin tình báo mới nhất được lưu trữ cho một đối thủ được theo dõi; một trường chỉ xuất hiện khi nó được đo lường	competitor_id (bắt buộc)
get_battlecard	đọc	Thẻ chiến đấu bán hàng có trích dẫn cho một đối thủ được theo dõi. Yêu cầu gói Pro	competitor_id (bắt buộc)
get_strategic_timeline	đọc	Dòng thời gian liên kết bằng chứng về các động thái của đối thủ trên giá cả, sản phẩm, nhân sự, tài trợ và nội dung/mạng xã hội	project_id (bắt buộc), days (30, 90, 180), competitor_id, lanes, format, page
get_competitive_landscape	đọc	Vị thế hàng tuần hiện tại hoặc được lưu trữ của các đối thủ theo hoạt động và tầm quan trọng chiến lược	project_id (bắt buộc), week (YYYY-MM-DD), format, page
get_freshness	đọc	Thời điểm mỗi đối thủ được theo dõi trong một dự án được quan sát thực tế lần cuối và cách thức	project_id (bắt buộc)
get_evidence	đọc	Các nguồn đằng sau sự thật cho sản phẩm của bạn hoặc một đối thủ: URL, nội dung nó hỗ trợ và thời điểm nó được đọc	project_id (bắt buộc), competitor_id
add_competitor	ghi, chọn tham gia	Thêm URL đối thủ vào một dự án. Tiêu tốn tín dụng và xếp hàng phân tích	project_id (bắt buộc), urls (1-10, bắt buộc)

project_id và competitor_id là UUID từ list_projects và list_competitors. Các công cụ đọc tài khoản của bạn chỉ thấy dữ liệu của chính bạn.

Các phần báo cáo

get_report nhận section để trợ lý của bạn có thể đọc phần mà câu hỏi cần thay vì toàn bộ báo cáo:

Phần	Nội dung
tldr, biggest-threat, blind-spots, actions	Các phần tiêu đề của báo cáo (actions là điều sản phẩm của bạn nên làm)
battlecards	Các thẻ chiến đấu bán hàng có trích dẫn
competitors	Phần của mọi đối thủ đầy đủ
pricing, momentum, app-store, strengths, weaknesses, key-findings, creators, ads, tech-stack	Một chủ đề được thu thập từ phần của mọi đối thủ

Một báo cáo chỉ có các phần mà nó có dữ liệu; yêu cầu bất kỳ tên nào khác sẽ trả về lỗi liệt kê các phần mà nó có. section kết hợp với competitor, vì vậy section: "pricing" với competitor: "Acme" trả về giá của Acme. Các tuyên bố mà kiểm tra phát hiện chế tạo của báo cáo đã loại bỏ xuất hiện dưới dạng [removed — unverified], chính xác như trong báo cáo.

Phản hồi dài

Mọi phản hồi đều dưới 25.000 ký tự và không có gì bị cắt âm thầm:

• Markdown (get_report, get_strategic_timeline, get_competitive_landscape) được chia thành các trang tại ranh giới phần. Mỗi trang bắt đầu bằng Page N of M, lượng còn lại và lệnh gọi chính xác cho trang tiếp theo.
• Danh sách (list_universe_companies, list_competitors, list_reports) trả về pagination.next_offset; tiếp tục từ đó cho đến khi nó là null.
• Đối tượng (get_universe_company, và JSON dòng thời gian hoặc bối cảnh) giới hạn các mảng dài và ghi lại giới hạn trong _capped. Một trường vẫn không vừa được liệt kê trong _omitted kèm lệnh gọi lấy nó.

Ví dụ lời nhắc

• "Phân tích linear.app." (teardown_competitor)
• "Ai là những người chơi trong công cụ phát triển AI?" (list_universe_companies)
• "Tóm tắt báo cáo mới nhất của tôi, sau đó cho tôi xem đối thủ của tôi tính phí bao nhiêu." (list_reports, get_report với section: "pricing")
• "Đối thủ nào của tôi di chuyển nhiều nhất trong quý này, và họ đã làm gì?" (get_competitive_landscape, get_strategic_timeline)
• "Cho tôi điểm nói chuyện bán hàng chống lại đối thủ hàng đầu của tôi." (list_competitors, get_battlecard)
• "Tuyên bố giá đó đến từ đâu, và nó mới đến mức nào?" (get_evidence, get_freshness)

Cấu hình

Biến	Bắt buộc	Mặc định	Mô tả
RIVALIZE_API_KEY	có	không có	Khóa API Rivalize của bạn. Phải bắt đầu bằng rk_live_; máy chủ thoát khi khởi động với thông báo nếu thiếu hoặc sai định dạng.
RIVALIZE_API_URL	không	https://rivalize.ai	Nguồn gốc của API Rivalize. Một khóa chỉ hoạt động trên máy chủ đã cấp nó: để trống cho rivalize.ai, và đối với máy chủ Rivalize tự lưu trữ hoặc không phải sản xuất, đặt nó thành nguồn gốc của máy chủ đó, nếu không mọi lệnh gọi trả về 401.
RIVALIZE_MCP_ALLOW_WRITES	không	tắt	1, true hoặc yes (bất kỳ chữ hoa/thường nào) đăng ký add_competitor. Bất kỳ giá trị nào khác, hoặc để trống, giữ máy chủ chỉ đọc.
HTTPS_PROXY / HTTP_PROXY	không	không có	Định tuyến yêu cầu qua proxy công ty. Các dạng chữ thường cũng được đọc, và HTTPS_PROXY thắng khi cả hai được đặt. NO_PROXY được tôn trọng. Lỗi nêu tên máy chủ proxy, không bao giờ nêu thông tin xác thực của nó.

Xử lý sự cố

"Kết nối đã đóng"

Khi máy chủ không thể khởi động, nhiều máy khách chỉ hiển thị "Kết nối đã đóng" hoặc trạng thái thất bại. Máy chủ in lý do dưới dạng dòng đầu tiên của stderr, có tiền tố rivalize-mcp:, và hầu hết máy khách giữ stderr trong nhật ký MCP của chúng. Các nguyên nhân thường gặp:

1. RIVALIZE_API_KEY thiếu hoặc không hợp lệ. Nhật ký đọc rivalize-mcp: RIVALIZE_API_KEY is required, hoặc nói khóa trông không giống khóa API Rivalize (nó phải bắt đầu bằng rk_live_). Đặt khóa vào khối env của máy chủ và khởi động lại máy khách.
2. Node.js cũ hơn 22. Chạy node --version và cài Node.js 22 trở lên. Máy khách của bạn dùng node và npx nào xuất hiện đầu tiên trên PATH của chính nó, có thể khác với terminal của bạn.
3. Không có truy cập mạng. npx tải xuống gói ở lần chạy đầu tiên, và mọi lệnh gọi công cụ đi đến https://rivalize.ai (hoặc RIVALIZE_API_URL). Sau proxy công ty, đặt HTTPS_PROXY. Lỗi mạng nêu tên máy chủ và mã nguyên nhân, chẳng hạn như ECONNREFUSED hoặc ENOTFOUND.

Để xem thông báo trực tiếp, chạy máy chủ trong terminal với cùng khóa:

RIVALIZE_API_KEY=rk_live_... npx -y @rivalize/mcp

Một máy chủ khỏe mạnh in rivalize-mcp-server connected via stdio ra stderr và chờ đầu vào (nhấn Ctrl+C để dừng). Bất kỳ điều gì khác là lý do máy khách của bạn không thể kết nối.

Mọi lệnh gọi trả về 401

Khóa bị máy chủ mà nó được gửi đến từ chối, và lỗi nêu tên máy chủ đó. Kiểm tra khóa chưa bị thu hồi, và RIVALIZE_API_URL để trống trừ khi khóa được cấp bởi một máy chủ Rivalize khác.

Một công cụ nói cần gói cao hơn

Đọc khả dụng trên mọi gói. Một số khả năng, chẳng hạn như thẻ chiến đấu và lịch sử dòng thời gian hoặc bối cảnh đầy đủ, cần gói cao hơn; lỗi cho biết gói nào và liên kết đến rivalize.ai/pricing.

Docker

Kho lưu trữ bao gồm Dockerfile xây dựng cùng một máy chủ stdio trên Node 22 và chạy nó dưới tư cách người dùng không phải root.

docker build -t rivalize-mcp .

{
  "mcpServers": {
    "rivalize": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "RIVALIZE_API_KEY", "rivalize-mcp"],
      "env": { "RIVALIZE_API_KEY": "rk_live_..." }
    }
  }
}

Chạy container với -i và không có TTY, vì MCP dùng stdin và stdout. -e RIVALIZE_API_KEY không có giá trị chuyển khóa qua từ môi trường của máy khách, vì vậy nó không bao giờ xuất hiện trên dòng lệnh docker run. Thêm -e RIVALIZE_API_URL hoặc -e RIVALIZE_MCP_ALLOW_WRITES theo cùng cách nếu bạn cần.

Chính sách quyền riêng tư

Máy chủ này là một máy khách mỏng cho API Rivalize.

• Nó gửi gì và gửi đến đâu. Mỗi lần gọi công cụ sẽ trở thành một yêu cầu HTTPS đến API Rivalize tại https://rivalize.ai, hoặc nguồn gốc bạn đặt trong RIVALIZE_API_URL. Một yêu cầu mang khóa API của bạn dưới dạng mã thông báo Bearer, một User-Agent của rivalize-mcp/<version>, và các đối số của công cụ: ví dụ như tên miền công ty, cụm từ tìm kiếm, dự án, báo cáo hoặc ID đối thủ, và, khi bật ghi, các URL đối thủ bạn thêm. Nếu bạn đặt HTTPS_PROXY hoặc HTTP_PROXY, các yêu cầu sẽ đi qua proxy đó. Không có gì được gửi đến nơi nào khác.
• Nó không gửi gì. Không có telemetry, phân tích hoặc báo cáo sự cố. Nó không đọc tệp trên máy của bạn, cuộc trò chuyện của bạn hoặc đầu ra của các công cụ khác; nó chỉ thấy các đối số mà máy khách MCP của bạn truyền cho các công cụ của chính nó.
• Nó lưu trữ gì cục bộ. Không có gì. Nó không ghi tệp, không giữ bộ nhớ đệm và không giữ trạng thái giữa các lần chạy. Khóa của bạn nằm trong cấu hình của máy khách MCP, không phải trong máy chủ này. Thông báo chẩn đoán được gửi đến stderr, mà máy khách MCP của bạn có thể ghi nhật ký; chúng không bao giờ bao gồm khóa API của bạn.
• Rivalize làm gì với các yêu cầu. API xử lý chúng theo Chính sách quyền riêng tư của Rivalize tại rivalize.ai/privacy. Rivalize được vận hành bởi Downshift LLC, đơn vị kiểm soát dữ liệu cho dữ liệu đó. Các câu hỏi về quyền riêng tư gửi đến privacy@rivalize.ai.

Bảo mật

Vui lòng báo cáo lỗ hổng một cách riêng tư đến support@rivalize.ai với "security" trong dòng tiêu đề, không phải trong vấn đề công khai. Bao gồm phiên bản gói (npm view @rivalize/mcp version, hoặc User-Agent ở trên), những gì bạn đã làm và những gì đã xảy ra. Chúng tôi sẽ xác nhận báo cáo của bạn và cập nhật cho bạn cho đến khi nó được giải quyết.

Hãy coi khóa API của bạn như một thông tin xác thực. Giữ nó trong khối env của máy khách hoặc môi trường shell của bạn, không bao giờ trong tệp dùng chung hoặc đã cam kết, và thu hồi khóa bị rò rỉ trong Dashboard → Settings → API Keys.

Đóng góp

Báo cáo lỗi và yêu cầu tính năng được hoan nghênh tại github.com/Downshift/rivalize-mcp/issues. Đối với câu hỏi về tài khoản và thanh toán, hãy gửi email đến support@rivalize.ai.

Để làm việc trên máy chủ cục bộ:

npm ci
npm run typecheck
npm run build      # emits dist/, which the rivalize-mcp bin runs
npm test           # offline: every API call is mocked or served by a local fixture

server.json là mục MCP Registry. Các bài kiểm tra xác thực nó theo lược đồ chính thức (được nhúng trong schema/) và kiểm tra rằng tên, phiên bản và gói của nó khớp với package.json.

Nhật ký thay đổi

0.3.2

• list_competitors giờ đây cho trợ lý của bạn biết cách chọn đối thủ hàng đầu: theo thứ hạng của đối thủ trên Brief của bạn (brief.standing) khi API trả về nó, nếu không thì theo momentum_score. threat_level được mô tả như những gì nó là, dải điểm động lượng, và không còn được cung cấp như một thứ hạng.
• Khi thứ hạng của một hàng vẫn đang được đọc (brief.state là deferred), list_competitors yêu cầu cùng một trang lần nữa, tối đa 4 lần, cách nhau 1,5 giây. Với API không trả về brief, nó thực hiện một yêu cầu cho mỗi lần gọi như trước.
• Diễn đạt rõ ràng hơn trong gợi ý 401 cho máy chủ Rivalize tự lưu trữ hoặc không phải sản xuất, và trong mô tả add_competitor.

0.3.1

• Phiên bản mà lịch sử kho lưu trữ này bắt đầu: mười ba công cụ chỉ đọc, công cụ ghi add_competitor chọn tham gia, phản hồi giữ dưới 25.000 ký tự với phân trang rõ ràng, hỗ trợ proxy và mục MCP Registry trong server.json.

Giấy phép

MIT, © 2026 Downshift LLC. Xem LICENSE.