Grok Bot và Scrapeless: Thêm một Kết nối MCP Tùy chỉnh

TL;DR:

• Scrapeless không có trong danh mục Plugins của Grok Bot, vì vậy nó được thêm vào như một kết nối tùy chỉnh. Tìm kiếm nó trên Marketplace không trả về kết quả nào; một Bot đăng ký một máy chủ MCP từ xa tùy chỉnh khi bạn yêu cầu.
• Một tin nhắn bằng tiếng Anh thực hiện thiết lập. Đặt tên cho máy chủ, cung cấp URL https://api.scrapeless.com/mcp, và yêu cầu Bot xác thực với tiêu đề x-api-token.
• Grok Bot hiển thị một thẻ chấp thuận trước khi bất kỳ thứ gì được lưu. Kiểm tra tên, loại Remote HTTPS, URL máy chủ và tiêu đề, sau đó lưu lại.
• Tên tiêu đề là x-api-token. Một tiêu đề Bearer bị từ chối với 401 Unauthorized: Missing x-api-token header.
• Chứng minh điều đó bằng một lần gọi công cụ, không phải thẻ trạng thái. Scrapeless trả lời quá trình bắt tay cho bất kỳ giá trị khóa nào, và các kết nối API-key có thể hiển thị một thẻ "Cần xác thực" trong khi chúng hoạt động.
• Lấy một khóa trên kế hoạch miễn phí của Scrapeless và kết nối nó trong vài phút.

Grok Bot cung cấp cho mỗi Bot của mình một máy tính đám mây, một trình duyệt và một tập hợp các kết nối. Những gì nó thiếu là một cách trực tiếp để biến một trang web đã được hiển thị thành Markdown sạch, chạy một lần quét trong nền hoặc kéo kết quả Google từ một lần gọi công cụ. Máy chủ Scrapeless MCP thêm những công cụ đó mà mọi Bot trên tài khoản của bạn có thể gọi.

Kết nối là một máy chủ MCP từ xa tùy chỉnh, và trong Grok Bot, bạn tạo một cái bằng cách yêu cầu một Bot thay vì phải điền vào một trang cài đặt. Hướng dẫn này đề cập đến tin nhắn gửi đi, những gì cần kiểm tra trên thẻ chấp thuận, và cách phân biệt một kết nối hoạt động với một kết nối chỉ trông có vẻ được kết nối.

Tại sao Scrapeless không có trong Marketplace Plugins

Grok Bot hiển thị các kết nối như Plugins, và danh mục đó là của Cursor. hướng dẫn Grok Bot của xAI cho các đội nói rằng không có danh sách kết nối Grok Bot riêng biệt: các kết nối xuất hiện dưới dạng plugins trong ứng dụng, và Grok Bot thừa hưởng chính sách kết nối của đội từ Cursor. Scrapeless không được công bố trong danh mục đó, vì vậy tìm kiếm nó trên Marketplace trở về trống rỗng.

Bất kỳ thứ gì bên ngoài danh mục được thêm vào như một kết nối tùy chỉnh, và một Bot làm điều đó cho bạn. Bạn cung cấp URL HTTPS của máy chủ từ xa và các tiêu đề nó cần; nó đăng ký máy chủ với công cụ Thêm MCP của nó sau khi bạn xác nhận. Một kết nối tùy chỉnh hoạt động trên toàn tài khoản, vì vậy khi một Bot thêm Scrapeless, các Bot khác trên cùng một tài khoản cũng có thể sử dụng nó.

Những gì Scrapeless thêm vào các Bots của bạn

Máy chủ cung cấp 25 công cụ, được nhóm theo công việc:

• scrape_markdown, scrape_html và scrape_screenshot trả về một trang đã được hiển thị dưới dạng Markdown, HTML thô hoặc hình ảnh trong một lần gọi.
• Mười sáu công cụ browser_*, từ browser_create và browser_goto đến browser_click, browser_type và browser_snapshot, điều khiển một phiên trình duyệt đám mây từng bước.
• crawl_start, crawl_result và crawl_cancel chạy một lần quét trong nền và thu thập nó sau.
• google_search và google_trends trả về kết quả tìm kiếm và dữ liệu xu hướng, và ai_scraper nắm bắt câu trả lời từ các trợ lý AI như ChatGPT, Gemini và Perplexity.

Một Bot đã có một trình duyệt của riêng mình. Điểm khác biệt là đầu ra: những công cụ này trả lại nội dung trang mà mô hình có thể đọc trực tiếp, thay vì một phiên mà nó phải nhấp vào.

Các yêu cầu tiên quyết

• Grok Bot trên một kế hoạch đủ điều kiện. xAI liệt kê SuperGrok Plus, SuperGrok Heavy, Cursor Pro+, Cursor Ultra, và Cursor Teams Standard hoặc Premium. Hướng dẫn này sử dụng ứng dụng desktop Grok Bot, phiên bản 0.47.0, trên Windows.
• Một khóa API Scrapeless từ bảng điều khiển Scrapeless.
• Trên một đội Cursor, một chính sách kết nối cho phép máy chủ. Khi chính sách chặn một cái nào đó, các thành viên sẽ thấy plugin đó là Bị vô hiệu hóa bởi quản trị viên đội.

Bước 1: Yêu cầu một Bot thêm Scrapeless

Mở bất kỳ Bot nào và gửi tin nhắn này, với khóa của bạn thay thế cho dấu chấm:

Add a custom remote MCP server.
Name: scrapeless
URL: https://api.scrapeless.com/mcp
Authentication: HTTP header "x-api-token" with the value YOUR_SCRAPELESS_API_KEY
Do not use an Authorization or Bearer header.

Dòng cuối cùng thực hiện công việc thực sự. Hầu hết các kết nối xác thực bằng OAuth hoặc một mã thông báo Bearer, và một Bot giả định Bearer sẽ xây dựng một tiêu đề bị Scrapeless từ chối. Điểm cuối trả lời một yêu cầu như vậy với 401 Unauthorized: Missing x-api-token header.

Biết nơi khóa kết thúc khi nó là một phần của tin nhắn. Nó ở lại trong cuộc trò chuyện của Bot đó, và việc chia sẻ Bot với đội của bạn cho thấy lịch sử đầy đủ của nó, bao gồm cả các cuộc trò chuyện trước đó. Trang trợ giúp của Grok Bot về bí mật khuyên nên giữ khóa API ra khỏi trò chuyện. Đối với một Bot chia sẻ, hãy gửi cùng một tin nhắn mà không có giá trị và gõ khóa vào thẻ chấp thuận trong Bước 2 thay vì; đó là cách mà khóa đã được nhập khi thiết lập này được thử nghiệm.

Thiết lập điều này ngay bây giờ? Kế hoạch miễn phí của Scrapeless bao gồm kết nối và các lần gọi công cụ đầu tiên của bạn.

Bước 2: Kiểm tra thẻ chấp thuận và lưu lại

Trước khi Bot đăng ký bất cứ điều gì, Grok Bot hiển thị một thẻ Thêm Máy chủ MCP. So sánh từng trường với những gì bạn đã yêu cầu:

Để trống ID khách hàng OAuth và Mật khẩu Khách hàng, vì Scrapeless không sử dụng OAuth. Nếu giá trị tiêu đề trống, hãy gõ khóa vào đó, sau đó chọn Lưu. Thẻ cũng cung cấp Chỉnh sửa JSON, chứa cùng một máy chủ dưới dạng đối tượng JSON có khóa theo tên của nó, một máy chủ tại một thời điểm.

Khóa đã lưu gắn liền với bộ kết nối. Tài liệu của xAI nói rằng các mã thông báo OAuth ở lại trên backend kết nối của Cursor và Bots gọi các công cụ mà không nhận được chúng. Tài liệu của Cursor cho các đại lý được lưu trữ của nó thêm rằng giá trị tiêu đề trên các máy chủ HTTP MCP được mã hóa khi nghỉ ngơi, bị làm mờ sau khi lưu và không bao giờ được đặt trên máy của đại lý; các cuộc gọi công cụ đi qua backend của Cursor.

Bước 3: Chạy Một Cuộc Gọi Công Cụ

Hãy yêu cầu Bot một công việc nhỏ, có thể kiểm tra:

Use the scrapeless MCP server's scrape_markdown tool to fetch https://example.com
and reply with the first heading of the returned page, quoted exactly.

Một bộ kết nối hoạt động trở lại với tiêu đề của trang:

"# Example Domain"

Một cuộc gọi công cụ là bài kiểm tra quan trọng, vì trạng thái của bộ kết nối không thể phân biệt một khóa tốt với một khóa xấu. Scrapeless trả lời bắt tay MCP và liệt kê 25 công cụ của nó cho bất kỳ giá trị khóa nào. Sự khác biệt chỉ thể hiện khi một công cụ được chạy: với một khóa sai, văn bản kết quả bắt đầu bằng Failed to fetch data.

Huy hiệu trạng thái cũng có thể gây nhầm lẫn theo hướng ngược lại. Huy hiệu plugin của Grok Bot chỉ tính một lần đăng nhập OAuth là đã xác thực, vì vậy một bộ kết nối sử dụng mã API có thể đọc Cần xác thực trong khi các công cụ của nó hoạt động. Nhân viên Cursor xác nhận rằng huy hiệu Cần xác thực chỉ mang tính chất thẩm mỹ cho các bộ kết nối như thế này. Nhấn Xác thực không thay đổi nó; cuộc gọi công cụ ở trên là bài kiểm tra.

Sửa Các Vấn Đề Chung

Hàng cuối cùng là điều đáng biết trước khi nó xảy ra. Grok Bot phát hiện tất cả các bộ kết nối của một tài khoản dưới một ngân sách thời gian chung, vì vậy một máy chủ duy nhất không bao giờ trả lời bắt tay của nó có thể khiến mọi bộ kết nối trở về trống rỗng. Scrapeless đã trả lời bắt tay của nó trong chưa đầy nửa giây trong quá trình thử nghiệm, vì vậy không phải là bộ kết nối im lặng.

Chia sẻ Scrapeless Giữa Một Nhóm Cursor

Yêu cầu một Bot thêm bộ kết nối cho một tài khoản. Một nhóm muốn có cùng một bộ kết nối cho mỗi thành viên có thể phát hành nó dưới dạng một plugin trong một Thị trường nhóm Cursor, mà các kế hoạch Teams và Enterprise hỗ trợ. Các thành viên sau đó sẽ tìm thấy nó trong danh mục Plugin dưới các plugin của nhóm, và không ai sao chép một khóa vào một cuộc trò chuyện.

mcp.json của plugin chỉ giữ một vị trí:

{
  "mcpServers": {
    "scrapeless": {
      "url": "https://api.scrapeless.com/mcp",
      "headers": {
        "x-api-token": "${SCRAPELESS_API_KEY}"
      }
    }
  }
}

.cursor-plugin/plugin.json của nó tuyên bố rằng vị trí đó là một biến, vì vậy một quản trị viên nhóm đặt khóa thực tế trong bảng điều khiển Cursor dưới Plugin → Cấu hình:

{
  "name": "scrapeless",
  "variables": {
    "type": "object",
    "properties": {
      "SCRAPELESS_API_KEY": {
        "type": "string",
        "title": "Scrapeless API key",
        "description": "Sent as the x-api-token header to https://api.scrapeless.com/mcp."
      }
    },
    "required": ["SCRAPELESS_API_KEY"]
  }
}

Một kế hoạch Teams cho phép một thị trường nhóm, vì vậy một nhóm đã nhập khẩu một cái thêm plugin Scrapeless vào kho đó thay vì tạo một cái thứ hai.
Để biết thêm về những gì máy chủ cung cấp, đọc thông báo máy chủ Scrapeless MCP. Hướng dẫn cài đặt con trỏ đề cập đến cùng một máy chủ trong trình chỉnh sửa con trỏ, tài liệu MCP Trình duyệt chứa tham khảo cấu hình, trang API Scraping đề cập đến các diễn viên đứng sau các công cụ, và bảng giá liệt kê chi phí của một cuộc gọi.

Kết luận

Thêm Scrapeless vào Grok Bot chỉ mất một tin nhắn và một sự phê duyệt. Bot đăng ký https://api.scrapeless.com/mcp như một máy chủ MCP từ xa tùy chỉnh, thẻ phê duyệt xác nhận tên, loại, URL và tiêu đề x-api-token, và mọi Bot trên tài khoản có thể gọi 25 công cụ.

Hai kiểm tra giữ cho việc thiết lập được trung thực. Đọc kết quả của một cuộc gọi công cụ thực tế thay vì biểu tượng trạng thái, vì một khóa sai và một kết nối API-key hoạt động đều có thể trông chưa hoàn thành. Và quyết định nơi khóa nên ở trước khi gửi tin nhắn: trong chat cho một Bot riêng tư, hoặc trong thẻ phê duyệt khi các đồng đội có thể đọc cuộc trò chuyện.

Sẵn sàng để cho các Bot của bạn thấy trực tiếp trang web? Bắt đầu với gói miễn phí của Scrapeless và gửi tin nhắn từ Bước 1.

Câu hỏi thường gặp

Q: Tôi có thể thêm một máy chủ MCP tùy chỉnh vào Grok Bot không?

Có. Hãy yêu cầu một Bot thêm một máy chủ MCP từ xa tùy chỉnh và cung cấp URL HTTPS của máy chủ và bất kỳ tiêu đề nào mà nó cần. Grok Bot hiển thị thẻ phê duyệt Thêm MCP Server với tên, loại, URL và các tiêu đề, và lưu kết nối khi bạn xác nhận.

Q: Tại sao Scrapeless không xuất hiện khi tôi tìm kiếm Các Plugin của Grok Bot?

Danh mục các Plugin liệt kê các plugin đã xuất bản, và Scrapeless không phải là một trong số đó. Nó kết nối như một kết nối tùy chỉnh thay thế, cái không xuất hiện trong tìm kiếm Marketplace.

Q: Tiêu đề nào mà Scrapeless cần trong Grok Bot?

x-api-token, với khóa API Scrapeless của bạn làm giá trị. Một tiêu đề Authorization: Bearer sẽ bị từ chối với 401 Unauthorized: Missing x-api-token header.

Q: Tại sao kết nối Scrapeless của tôi lại nói Cần xác thực?

Biểu tượng của Grok Bot chỉ đếm các đăng nhập OAuth là được xác thực, và Scrapeless sử dụng khóa API. Nhân viên Con trỏ mô tả biểu tượng như một cái gì đó thẩm mỹ cho các kết nối như thế này. Chạy một cuộc gọi công cụ để xác nhận kết nối hoạt động.

Q: Tôi có nên đưa khóa API của mình vào tin nhắn chat không?

Nó hoạt động, nhưng khóa sẽ ở lại trong cuộc trò chuyện của Bot, và các đồng đội sẽ thấy lịch sử đó trên một Bot chia sẻ. Đối với các Bot chia sẻ, hãy bỏ qua giá trị khỏi tin nhắn và gõ khóa vào thẻ phê duyệt.

Q: Tất cả các Bot của tôi có nhận được các công cụ Scrapeless không?

Có. Các máy chủ MCP tùy chỉnh là toàn bộ tài khoản, vì vậy một kết nối mà một Bot thêm có sẵn cho các Bot khác trên cùng một tài khoản.

Q: Scrapeless thêm bao nhiêu công cụ vào Grok Bot?

25: ba công cụ scrape_*, mười sáu công cụ browser_*, ba công cụ crawl_*, cộng với google_search, google_trends và ai_scraper.