Claude.ai + Scrapeless: Thêm một Kết nối MCP Tùy Chỉnh
Senior Web Scraping Engineer
TL;DR:
- Scrapeless kết nối với claude.ai như một người kết nối tùy chỉnh. Thêm
https://api.scrapeless.com/mcptrong hộp thoại Thêm người kết nối tùy chỉnh và truyền khóa API của bạn như một tiêu đề yêu cầu. - Chuyển đổi Xác thực thành Không cần đăng nhập. Claude tự động chọn tùy chọn mà nó phát hiện, và đối với Scrapeless, đó là Đăng nhập ngay, một đăng nhập OAuth mà máy chủ không cung cấp.
- Thêm một tiêu đề yêu cầu:
x-api-token, với khóa thô làm giá trị. Claude gửi giá trị chính xác như bạn đã gõ, vì vậy không có gì đứng trước khóa. - Các tiêu đề yêu cầu là phiên bản beta. Anthropic cung cấp cho một tập hợp tổ chức hạn chế, và trên các gói Team và Enterprise, một Chủ sở hữu thêm người kết nối.
- Một người kết nối liệt kê 25 công cụ chưa chứng minh khóa. Scrapeless liệt kê các công cụ của mình cho bất kỳ giá trị khóa nào, vì vậy hãy xác nhận với một cuộc gọi công cụ trong trò chuyện.
- Nhận khóa trên gói miễn phí Scrapeless và kết nối trong vài phút.
Claude trên web có tìm kiếm web riêng. Máy chủ MCP Scrapeless thêm một loại truy cập khác: các trang được tạo ra trong một trình duyệt thực và trả về dưới dạng Markdown, một trình duyệt đám mây mà Claude có thể điều khiển từng cú nhấp chuột, quét nền và dữ liệu kết quả Google. Khi đã được kết nối, Claude gọi những công cụ đó giữa cuộc trò chuyện.
Hướng dẫn này thêm máy chủ lưu trữ thông qua hộp thoại Thêm người kết nối tùy chỉnh của claude.ai. Hộp thoại là một biểu mẫu duy nhất, và hai trong số các cài đặt của nó cần được chú ý cho Scrapeless: tùy chọn đăng nhập mà Claude phát hiện và tiêu đề mang khóa.
Cách một Người Kết Nối Tùy Chỉnh Đến Scrapeless
Một người kết nối tùy chỉnh là một máy chủ MCP từ xa mà Claude gọi từ đám mây của Anthropic thay vì từ máy tính của bạn. Hướng dẫn của Anthropic về các người kết nối tùy chỉnh nói rằng điều này đúng cho mọi khách hàng Claude, bao gồm claude.ai, vì vậy máy chủ phải có thể truy cập qua internet công cộng. Scrapeless hoạt động tại một điểm cuối HTTPS công cộng, vì vậy không có gì cần lưu trữ và không cần danh sách trắng.
Xác thực quyết định phần còn lại của cấu hình. Nhiều người kết nối đăng nhập từng người qua OAuth. Scrapeless không có luồng OAuth và đọc khóa API từ tiêu đề x-api-token trên mọi yêu cầu. Tài liệu của Claude cho các người kết nối MCP từ xa đề cập đến trường hợp đó với các tiêu đề yêu cầu: một thông tin xác thực cố định được nhập một lần khi người kết nối được thêm và gửi trên mọi yêu cầu.
Các Gì Scrapeless Thêm Vào Claude
Máy chủ triển khai 25 công cụ, được nhóm theo công việc:
scrape_markdown,scrape_htmlvàscrape_screenshottrả về một trang được tạo ra dưới dạng Markdown, HTML thô hoặc một hình ảnh trong một cuộc gọi.- Mười sáu
browser_*công cụ, từbrowser_createvàbrowser_gotođếnbrowser_click,browser_typevàbrowser_snapshot, điều khiển phiên trình duyệt đám mây từng bước một. crawl_start,crawl_resultvàcrawl_cancelthực hiện một lần quét trong nền và thu thập nó sau.google_searchvàgoogle_trendstrả về kết quả tìm kiếm và dữ liệu xu hướng, vàai_scraperthu thập câu trả lời từ các trợ lý AI như ChatGPT, Gemini và Perplexity.
Trong cài đặt của người kết nối, Claude liệt kê chúng dưới những tên có thể đọc như "AI scraper" và "Browser click", mỗi cái với quyền riêng của nó.
Điều Kiện Tiên Quyết
- Một gói Claude với các người kết nối tùy chỉnh. Anthropic liệt kê Free, Pro, Max, Team và Enterprise, và giới hạn Free cho một người kết nối tùy chỉnh.
- Phần Tiêu đề yêu cầu trong hộp thoại Thêm người kết nối tùy chỉnh. Xác thực tiêu đề yêu cầu đang ở phiên bản beta cho một tập hợp tổ chức hạn chế; nếu phần này không có, tổ chức của bạn vẫn chưa có quyền truy cập.
- Trên các gói Team và Enterprise, một Chủ sở hữu hoặc Chủ sở hữu Chính để thêm người kết nối.
- Một khóa API Scrapeless từ bảng điều khiển Scrapeless.
Bước 1: Mở Thêm Người Kết Nối Tùy Chỉnh
Nơi hộp thoại mở phụ thuộc vào gói:
| Gói | Nơi thêm người kết nối |
|---|---|
| Free, Pro, Max | Tùy chỉnh > Người kết nối, sau đó + > Thêm người kết nối tùy chỉnh |
| Team, Enterprise | Một Chủ sở hữu mở Cài đặt Tổ chức > Người kết nối, nhấp Thêm, di chuột qua Tùy chỉnh và chọn Web |
Điền vào bước đầu tiên:
| Trường | Giá trị |
|---|---|
| Tên | Scrapeless |
| URL máy chủ MCP | https://api.scrapeless.com/mcp |
Giữ khóa ra khỏi URL. Scrapeless chỉ đọc nó từ tiêu đề x-api-token, và hướng dẫn xác thực của Anthropic cho các người kết nối khuyên không nên có thông tin xác thực trong các URL người kết nối, vì URL được ghi trong nhật ký máy chủ, proxy và lịch sử duyệt web.
Cài đặt điều này bây giờ? Kế hoạch miễn phí Scrapeless bao gồm kết nối và các cuộc gọi công cụ đầu tiên của bạn.
Bước 2: Thay đổi Tùy chọn Được phát hiện thành Không đăng nhập
Sau khi bạn tiếp tục, Claude sẽ kiểm tra URL và tự động chọn xác thực mà nó phát hiện, được đánh dấu là Được phát hiện. Đối với https://api.scrapeless.com/mcp, tùy chọn được phát hiện là Đăng nhập ngay. Chọn Không đăng nhập thay vào đó.
Hai tùy chọn đăng nhập chạy một luồng OAuth, và Scrapeless không cung cấp một cái nào. Phản hồi 401 của nó không mang theo tiêu đề WWW-Authenticate, và các đường dẫn phát hiện OAuth của nó trả về 404. Không đăng nhập là tùy chọn mà tài liệu của Anthropic đặt tên cho các máy chủ sử dụng khóa API, kết hợp với khóa dưới Request headers. Khi nó được chọn, các trường khách hàng OAuth sẽ biến mất khỏi hộp thoại.
Bước 3: Thêm tiêu đề x-api-token
Mở Request headers và thêm một hàng:
| Cài đặt | Giá trị |
|---|---|
| Tên tiêu đề | x-api-token |
| Giá trị | Khóa API Scrapeless của bạn, không có gì ở phía trước |
| Bắt buộc | Bật |
Sau đó nhấn Thêm.
Chọn tên từ danh sách, hoặc chọn Tiêu đề tùy chỉnh và gõ vào đó. Anthropic phê duyệt mỗi tên tiêu đề tùy chỉnh trước khi Claude gửi nó đến một máy chủ bên thứ ba, và hộp thoại từ chối một tên không được phê duyệt. x-api-token đã được lưu mà không có lỗi khi thiết lập này được thử nghiệm.
Giá trị không cần tiền tố. Claude gửi nó chính xác như đã nhập và không thêm bất kỳ sơ đồ xác thực nào, điều mà Scrapeless mong đợi: máy chủ đọc toàn bộ giá trị tiêu đề như là khóa. Một giá trị như Bearer <key> hoặc token <key> vẫn đi qua quá trình bắt tay và danh sách công cụ, sau đó thất bại trong mỗi cuộc gọi công cụ.
Bắt buộc khiến một giá trị bị thiếu làm thất bại kết nối thay vì gửi yêu cầu mà không có tiêu đề. Claude lưu trữ giá trị một cách an toàn và không hiển thị lại. Cài đặt xác thực không thể chỉnh sửa sau này, vì vậy một khóa hoặc tên tiêu đề sai có nghĩa là loại bỏ kết nối và thêm lại.
Bước 4: Kiểm tra Các Công cụ và Quyền của Chúng
Mở Tùy chỉnh > Kết nối và chọn Scrapeless. Trang kết nối liệt kê tất cả 25 công cụ dưới Quyền công cụ, và mỗi công cụ có thể được đặt thành Luôn cho phép, Cần phê duyệt hoặc Bị chặn. Trong quá trình thử nghiệm, mỗi công cụ của Scrapeless bắt đầu ở trạng thái Cần phê duyệt, vì vậy Claude yêu cầu trước mỗi cuộc gọi.
Chặn những gì mà một công việc không cần. Một cuộc trò chuyện chỉ đọc trang có thể giữ scrape_markdown và google_search khả dụng và chặn các công cụ browser_*, điều khiển một phiên duyệt web trực tiếp. Bài viết của Anthropic về việc sử dụng các kết nối mô tả cùng ba mức quyền cho từng kết nối.
Bước 5: Chạy Một Cuộc Gọi Công Cụ Trong Một Cuộc Trò Chuyện
Các kết nối được bật theo từng cuộc trò chuyện. Trong một cuộc trò chuyện mới, nhấn +, mở Kết nối và bật Scrapeless. Sau đó yêu cầu một công việc nhỏ, có thể kiểm tra:
text
Use the Scrapeless scrape_markdown tool to fetch https://example.comCho phép cuộc gọi nếu Claude yêu cầu phê duyệt. Claude hiển thị một bước Lấy dữ liệu markdown cho https://example.com, sau đó trả lại trang dưới dạng Markdown, bắt đầu với:
text
# Example Domain
This domain is for use in documentation examples without needing permission. Avoid use in operations.Cuộc gọi này là bài kiểm tra quan trọng. Scrapeless trả lời quá trình 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, vì vậy một kết nối đã được kết nối với danh sách công cụ đầy đủ chỉ cho thấy rằng tiêu đề đã đến. Với một khóa sai, kết quả công cụ bắt đầu bằng Failed to fetch data.
Sửa các Vấn đề Thường Gặp
| Những gì bạn thấy | Nguyên nhân | Sửa chữa |
|---|---|---|
| Không có phần Request headers trong hộp thoại | Bản beta tiêu đề yêu cầu chưa được bật cho tổ chức của bạn | Kiểm tra với Chủ sở hữu Nhóm hoặc Doanh nghiệp, hoặc với hỗ trợ của Claude |
| Kết nối bắt đầu một quá trình đăng nhập thất bại | Đăng nhập ngay hoặc Đăng nhập khi cần thiết vẫn được chọn | Gỡ bỏ kết nối và thêm lại với Không đăng nhập |
| Lưu bị từ chối do tên tiêu đề | Tên được gõ không phải là tên tiêu đề được phê duyệt | Kiểm tra chính tả x-api-token, hoặc yêu cầu hỗ trợ của Claude để phê duyệt |
| Kết nối không thành công | Khóa đã được dán dưới một tên tiêu đề khác, chẳng hạn như authorization, hoặc một giá trị Bắt buộc bị trống |
Thêm lại kết nối với x-api-token và khóa |
Kết quả công cụ bắt đầu bằng Failed to fetch data |
Khóa sai hoặc đã bị thu hồi, hoặc có một tiền tố | Thêm lại kết nối với khóa hợp lệ, nguyên vẹn |
| Thành viên không thể tìm thấy kết nối | Trên các kế hoạch Nhóm và Doanh nghiệp, chỉ có Chủ sở hữu thêm các kết nối tùy chỉnh | Một Chủ sở hữu thêm nó; các thành viên kết nối từ Tùy chỉnh > Kết nối |
Một Khóa cho Toàn bộ Tổ chức
Một tiêu đề yêu cầu là một thông tin đăng nhập được lưu trữ trên kết nối. Tài liệu của Claude mô tả tiêu đề yêu cầu là phù hợp cho các dịch vụ mà mọi người trong tổ chức chia sẻ một thông tin đăng nhập, và trên các kế hoạch Nhóm và Doanh nghiệp, Chủ sở hữu nhập nó một lần cho mọi thành viên. Tất cả các cuộc gọi Scrapeless của mọi thành viên sau đó chạy trên một khóa đó và kế hoạch của nó.
Sử dụng một khóa được tạo riêng cho Claude, để có thể thay đổi mà không làm ảnh hưởng đến các tích hợp khác. Thay đổi khóa có nghĩa là gỡ bỏ đầu nối và thêm lại với khóa mới, và các thành viên sẽ kết nối lại sau đó. Đặt quyền truy cập công cụ với toàn bộ đội ngũ trong tâm trí.
Để biết thêm về những gì máy chủ cung cấp, hãy đọc thông báo máy chủ Scrapeless MCP. Tài liệu Browser MCP cung cấp tham khảo cấu hình, trang Scraping API đề cập đến các đối tượng đứng sau các công cụ, và bảng giá liệt kê chi phí cho một cuộc gọi.
Kết luận
Scrapeless đi vào claude.ai dưới dạng một đầu nối tùy chỉnh với ba cài đặt quan trọng: URL https://api.scrapeless.com/mcp, Không đăng nhập thay cho tùy chọn đăng nhập đã được phát hiện, và một tiêu đề yêu cầu x-api-token chứa khóa cơ bản. Bật đầu nối trong một cuộc trò chuyện, và Claude có thể gọi tất cả 25 công cụ.
Đọc danh sách công cụ như dấu hiệu cho thấy tiêu đề đã đến, không phải rằng khóa hoạt động. Một cuộc gọi scrape_markdown trả về một trang thực sự thiết lập khóa, và quyền công cụ quyết định Claude có thể làm gì mà không cần hỏi.
Sẵn sàng để cung cấp cho Claude một trình duyệt đám mây và nội dung trang sạch? Bắt đầu với gói miễn phí Scrapeless và thêm đầu nối.
FAQ
Q: Tôi có thể thêm một đầu nối tùy chỉnh với một khóa API trong claude.ai không?
Có, nơi mà beta tiêu đề yêu cầu có sẵn. Chọn Không đăng nhập trong hộp thoại Thêm đầu nối tùy chỉnh và thêm khóa dưới Tiêu đề yêu cầu. Claude lưu giá trị và gửi nó trong mọi yêu cầu đến máy chủ.
Q: Tôi nên chọn tùy chọn xác thực nào cho Scrapeless trong claude.ai?
Không đăng nhập. Claude có thể đánh dấu Đăng nhập ngay là Đã phát hiện, nhưng Scrapeless không có đăng nhập OAuth và xác thực bằng x-api-token thay vào đó.
Q: Scrapeless cần tiêu đề nào trong Claude?
x-api-token, với khóa API là toàn bộ giá trị. Claude không thêm tiền tố nào, vì vậy chỉ cần nhập khóa.
Q: Tại sao tôi không thấy Tiêu đề yêu cầu trong hộp thoại Thêm đầu nối tùy chỉnh?
Xác thực tiêu đề yêu cầu đang trong giai đoạn beta và có sẵn cho một tập hợp tổ chức hạn chế. Nếu không có phần đó, một máy chủ khóa API như Scrapeless không thể được thêm thông qua hộp thoại.
Q: Tôi có thể thay đổi khóa Scrapeless sau khi thêm đầu nối không?
Không thể thay đổi tại chỗ. Các cài đặt xác thực, bao gồm cả tiêu đề yêu cầu, không thể thay đổi sau khi một đầu nối đã được thêm. Gỡ bỏ đầu nối và thêm lại với khóa mới; các thành viên sẽ kết nối lại sau đó.
Q: Tại sao đầu nối lại hiển thị 25 công cụ khi khóa của tôi sai?
Scrapeless liệt kê các công cụ của mình cho bất kỳ giá trị khóa nào. Khóa được kiểm tra khi một công cụ chạy, và một khóa sai trả về văn bản bắt đầu bằng Failed to fetch data.
Q: Tôi có thể đưa khóa API Scrapeless vào URL của đầu nối không?
Không. Scrapeless chỉ chấp nhận khóa trong tiêu đề x-api-token, và Anthropic khuyên không nên đưa thông tin đăng nhập vào URL của đầu nối.
Q: Có bao nhiêu công cụ Scrapeless thêm vào Claude?
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.
Tại Scrapless, chúng tôi chỉ truy cập dữ liệu có sẵn công khai trong khi tuân thủ nghiêm ngặt các luật, quy định và chính sách bảo mật trang web hiện hành. Nội dung trong blog này chỉ nhằm mục đích trình diễn và không liên quan đến bất kỳ hoạt động bất hợp pháp hoặc vi phạm nào. Chúng tôi không đảm bảo và từ chối mọi trách nhiệm đối với việc sử dụng thông tin từ blog này hoặc các liên kết của bên thứ ba. Trước khi tham gia vào bất kỳ hoạt động cạo nào, hãy tham khảo ý kiến cố vấn pháp lý của bạn và xem xét các điều khoản dịch vụ của trang web mục tiêu hoặc có được các quyền cần thiết.
