Claude.ai + Scrapeless: 添加自定义 MCP 连接器

TL;DR:

• Scrapeless 作为自定义连接器连接到 claude.ai。 在添加自定义连接器对话框中添加 https://api.scrapeless.com/mcp 并将您的 API 密钥作为请求头传递。
• 将身份验证切换为无登录。 Claude 预先选择了它检测到的选项，对于 Scrapeless，选择的是 立即登录，但服务器并不提供 OAuth 登录。
• 添加一个请求头：x-api-token，值为裸密钥。 Claude 将值准确发送为您所输入的内容，因此没有任何内容会放在密钥前面。
• 请求头仍处于测试阶段。 Anthropic 将其提供给有限的一组组织，在团队和企业计划中，所有者添加连接器。
• 列出 25 个工具的连接器尚未验证密钥。 Scrapeless 列出了任何密钥值的工具，因此通过聊天中调用一个工具进行确认。
• 在 Scrapeless 免费计划 上获取密钥，并在几分钟内连接。

Claude 的网络具有自己的网络搜索。Scrapeless MCP 服务器提供了一种不同的访问方式：在真实浏览器中呈现的页面并以 Markdown 返回，这是一个云浏览器，Claude 可以逐步驱动，进行后台抓取以及 Google 结果数据。一旦连接成功，Claude 可以在对话中调用这些工具。

本指南通过 claude.ai 的添加自定义连接器对话框添加托管服务器。该对话框是一个单一表单，其中有两个设置需要关注，以便与 Scrapeless 配合使用：Claude 检测到的登录选项和承载密钥的请求头。

如何自定义连接器到达 Scrapeless

自定义连接器是一个远程 MCP 服务器，Claude 从 Anthropic 的云中调用，而不是从您的计算机中调用。Anthropic 对自定义连接器的指南 表示，这适用于每个 Claude 客户端，包括 claude.ai，因此服务器必须可通过公共互联网访问。Scrapeless 在公共 HTTPS 端点上运行，因此无需托管或白名单。

身份验证决定了其余的设置。许多连接器通过 OAuth 登录每个人。Scrapeless 没有 OAuth 流，而是从每个请求中的 x-api-token 头读取 API 密钥。 Claude 关于远程 MCP 连接器的文档 涵盖了请求头的情况：在添加连接器时输入一次的固定凭证，并在每个请求中发送。

Scrapeless 为 Claude 添加了什么

该服务器公开了 25 个工具，按工作分组：

• scrape_markdown、scrape_html 和 scrape_screenshot 在一个调用中返回渲染的页面作为 Markdown、原始 HTML 或图像。
• 十六个 browser_* 工具，从 browser_create 和 browser_goto 到 browser_click、browser_type 和 browser_snapshot，逐步驱动云浏览器会话。
• crawl_start、crawl_result 和 crawl_cancel 在后台运行抓取并稍后收集。
• google_search 和 google_trends 返回搜索结果和趋势数据，而 ai_scraper 捕获来自 AI 助手如 ChatGPT、Gemini 和 Perplexity 的答案。

在连接器的设置中，Claude 以可读名称列出它们，如“AI 爬虫”和“浏览器点击”，每个都有自己的权限。

前提条件

• 一个包含自定义连接器的 Claude 计划。Anthropic 列出了免费、高级、最大、团队和企业，并且将免费计划限制为一个自定义连接器。
• 添加自定义连接器对话框中的 请求头 部分。请求头身份验证处于测试阶段，仅限于有限的一组组织；如果该部分缺失，则您的组织尚未获得访问权限。
• 在团队和企业计划中，有一个所有者或主要所有者来添加连接器。
• 来自 Scrapeless 仪表板的 Scrapeless API 密钥。

第 1 步：打开添加自定义连接器

对话框打开的位置取决于计划：

填写第一步：

将密钥排除在 URL 之外。Scrapeless 仅从 x-api-token 头中读取它，并且 Anthropic 的连接器身份验证指南 不建议在连接器 URL 中放置凭证，因为 URL 会记录在服务器日志、代理和浏览历史中。
现在设置这个吗？Scrapeless 免费计划 包括连接和你的第一个工具调用。

步骤 2：将检测选项更改为无需登录

继续后，Claude 会检查 URL 并预选所检测到的认证，标记为 检测到。对于 https://api.scrapeless.com/mcp，检测到的选项是 立即登录。请选择 无需登录。

这两个登录选项运行 OAuth 流程，而 Scrapeless 不提供一个。它的 401 响应没有 WWW-Authenticate 头，而它的 OAuth 发现路径返回 404。无需登录 是 Anthropic 文档中为使用 API 密钥的服务器命名的选项，配合 请求头 下的密钥。选择后，OAuth 客户端字段将从对话框中消失。

步骤 3：添加 x-api-token 头

打开 请求头 并添加一行：

然后点击 添加。

从列表中选择名称，或者选择 自定义头 并输入。Anthropic 在 Claude 将其发送到第三方服务器之前会批准每个自定义头名称，对话框会拒绝未获批准的名称。x-api-token 在此设置测试时成功保存没有错误。

值不需要前缀。Claude 会按照输入的内容发送，不添加任何身份验证方案，这是 Scrapeless 所期望的：服务器将整个头值读取为密钥。像 Bearer <key> 或 token <key> 这样的值仍然能够通过握手和工具列表，但在每次工具调用中失败。

必需 会使缺失的值导致连接失败，而不是在没有头的情况下发送请求。Claude 会安全地存储值，并不会再次显示。身份验证设置无法在稍后进行编辑，因此错误的密钥或头名称意味着需要移除连接器并重新添加它。

步骤 4：检查工具及其权限

打开 自定义 > 连接器 并选择 Scrapeless。连接器页面列出了 工具权限 下的所有 25 个工具，每个工具可以设置为 始终允许、需要审批 或 阻止。在测试中，每个 Scrapeless 工具起初都是 需要审批，所以 Claude 在每次调用之前都会询问。

阻止工作不需要的内容。一个只读取页面的聊天可以保持 scrape_markdown 和 google_search 可用，并阻止 browser_* 工具，这些工具驱动实时浏览器会话。Anthropic 关于使用连接器的文章 为每个连接器描述了相同的三个权限级别。

步骤 5：在聊天中运行一个工具调用

连接器在每个会话中开启。在新的聊天中，点击 +，打开 连接器 并启用 Scrapeless。然后请求一个小的、可检查的任务：

Use the Scrapeless scrape_markdown tool to fetch https://example.com

如果 Claude 请求批准，请允许调用。Claude 显示 https://example.com 的 抓取 markdown 步骤，然后以 Markdown 返回页面，从：

# Example Domain

This domain is for use in documentation examples without needing permission. Avoid use in operations.

这个调用是关键的测试。Scrapeless 对 MCP 握手作出响应，并为任何密钥值列出其 25 个工具，因此一个连接的连接器与完整工具列表仅显示头部到达。使用错误密钥，工具结果以 Failed to fetch data 开头。

修复常见问题

一个密钥适用于整个组织

请求头是连接器上存储的一个凭证。Claude 的文档将请求头描述为适合组织中每个人共享一个凭证的服务，在团队和企业计划中，所有者为每位成员输入一次。所有成员的 Scrapeless 调用随后都运行在那个密钥及其计划上。
使用专为Claude创建的密钥，这样可以在不影响其他集成的情况下进行轮换。轮换意味着移除连接器，然后使用新密钥重新添加，并且成员在之后重新连接。设定工具权限时要考虑整个团队。

有关服务器提供的更多信息，请阅读 Scrapeless MCP服务器公告。 Browser MCP文档 载有配置参考，Scraping API 页面介绍工具背后的参与者， 定价 列出一个调用的费用。

结论

Scrapeless作为一个自定义连接器进入claude.ai，具有三个重要设置：URL https://api.scrapeless.com/mcp、替代检测到的登录选项的无登录，以及包含基本密钥的x-api-token请求头。在聊天中开启连接器后，Claude可以调用所有25个工具。

将工具列表作为请求头到达的标志，而不是密钥有效的标志。一 scrape_markdown 调用返回真实页面确定密钥，而工具权限决定了Claude在未请求的情况下可以做多少。

准备好给Claude一个云浏览器和清洁的页面内容吗？ 从Scrapeless免费计划开始 并添加连接器。

常见问题

问：我可以在claude.ai中添加带有API密钥的自定义连接器吗？

可以，在请求头beta可用的地方。在添加自定义连接器对话框中选择无登录，并在请求头下添加密钥。Claude将存储该值并在每个请求中发送给服务器。

问：我应该为claude.ai中的Scrapeless选择哪个身份验证选项？

无登录。Claude可能将立即登录标记为检测到，但Scrapeless没有OAuth登录，而是用x-api-token请求头进行身份验证。

问：Scrapeless在Claude中需要什么请求头？

x-api-token，API密钥作为整个值。Claude不添加前缀，因此仅输入密钥即可。

问：为什么我在添加自定义连接器对话框中看不到请求头？

请求头身份验证处于测试阶段，仅适用于有限的组织集。在没有该部分的情况下，Scrapeless这种API密钥服务器不能通过对话框添加。

问：我可以在添加连接器后更改Scrapeless密钥吗？

不可以。身份验证设置，包括请求头，在连接器添加后无法更改。移除连接器，然后使用新密钥重新添加；成员随后重新连接。

问：为什么连接器显示25个工具而我的密钥错误？

Scrapeless 为任何密钥值列出其工具。运行工具时会检查密钥，错误密钥会返回以Failed to fetch data开头的文本。

问：我可以将Scrapeless API密钥放在连接器URL中吗？

不可以。Scrapeless仅在x-api-token请求头中接受密钥，Anthropic建议不要将凭据放在连接器URL中。

问：Scrapeless会为Claude添加多少个工具？

25个：三个scrape_*工具，十六个browser_*工具，三个crawl_*工具，加上google_search、google_trends和ai_scraper。