scrupp

Scrupp MCP 服务

基于 Scrupp Jobs API 的 MCP 服务，让 Agent 无需编写 HTTP 请求，即可导出 LinkedIn、Sales Navigator 和 Apollo 搜索结果、查找决策者，以及查找并验证工作邮箱。可通过 npm 安装 scrupp-mcp-server，并已收录于官方 MCP 注册表，名称为 io.github.wismhero-maker/scrupp。概览： https://scrupp.com/email-finder-mcp

在 Claude 中使用（无需安装）

在 Claude 中添加 https://mcp.scrupp.com/mcp 作为自定义连接器，然后登录 Scrupp。 所有 Scrupp 套餐（包括免费套餐）均可查找并验证工作邮箱。需要完整工具集的 Scrupp 客户请使用设置指南中介绍的私有连接器。设置步骤、各工具的要求及故障排除： https://scrupp.com/docs/api/claude

在 Claude Code 中使用（插件）

/plugin install scrupp --marketplace Wism-Corp/scrupp-mcp-server

对于低于 2.1.275 的 Claude Code，请按以下两个步骤操作：

/plugin marketplace add Wism-Corp/scrupp-mcp-server
/plugin install scrupp@scrupp

该插件将 Claude Code 连接到 Scrupp 的私有托管连接器，提供与私有 Claude 连接器相同的 完整工具集，因此无需在本地安装任何内容。工具首次运行时，打开 /mcp，选择 scrupp， 然后登录 Scrupp。

该插件包含两项内容：

• .mcp.json — 上述托管连接器，通过 OAuth 登录。
• skills/scrupp-prospecting — 指导 Claude 如何使用工具：先检查额度，根据用户拥有的权限 选择工具；先导出五条记录作为样本，再导出整个搜索结果；使用 scrupp_get_job 获取长时间运行的 任务；以及工具拒绝请求时该如何回复。

发布前使用 claude plugin validate . 检查。

使用方法

{
  "mcpServers": {
    "scrupp": {
      "command": "npx",
      "args": ["-y", "scrupp-mcp-server"],
      "env": { "SCRUPP_API_KEY": "sk_live_..." }
    }
  }
}

SCRUPP_WAIT_SECONDS（默认值为 120）限制工具阻塞的最长时间。如果任务运行时间超过该限制， 工具会返回 { status: "running", job_id }，并提示 Agent 调用 scrupp_get_job。这样比让对话因导出 2,500 条记录而挂起二十分钟更好。

工具

工具	功能
scrupp_export_sales_navigator_search	根据 Sales Navigator 搜索 URL 获取人员信息
scrupp_export_linkedin_search	根据 LinkedIn 人员搜索 URL 获取人员信息
scrupp_run_apollo_search	根据 Apollo 搜索 URL 获取人员信息（需要已连接的账户）
scrupp_enrich_linkedin_profiles	获取个人资料 URL 对应的完整资料数据
scrupp_lookup_company	根据域名、LinkedIn URL 或名称获取公司数据
scrupp_find_decision_makers	查找应联系某家公司的哪些人
scrupp_find_emails	根据姓名和域名查找已验证的工作邮箱
scrupp_verify_emails	检查现有邮箱地址的可送达性（每个地址消耗 1 个额度）
scrupp_get_job	获取仍在运行的任务的状态和记录
scrupp_credits	获取剩余额度和套餐信息

每个工具都带有 title 和 readOnlyHint / destructiveHint 注释——Claude 连接器目录 不接受缺少这些注释的服务。

托管连接器（Streamable HTTP）

node src/http.js（或 scrupp-mcp-http）通过 Streamable HTTP 在 POST /mcp 提供相同的服务， 采用无状态模式，并提供 GET /health 供负载均衡器使用。PORT 默认值为 8787。每个请求都使用调用方自己的密钥进行身份验证，格式为 Authorization: Bearer sk_live_...；密钥仅用于该请求，因此一个进程可以为多个账户提供服务， 而不会混淆它们。

托管连接器提供的工具集比本地服务更精简：查找邮箱、验证邮箱、查询任务状态和额度。用于从 LinkedIn（Sales Navigator、LinkedIn 搜索、资料补全）收集数据或从共享潜在客户数据库中查询答案 （公司查询、决策者）的工具，以及 Apollo 导出功能，都仅限本地使用——它们通过非调用方自己的账户运行， 因此不适合列入公开目录。

在 Claude Code 中通过已部署的实例试用：

claude mcp add --transport http scrupp https://mcp.scrupp.com/mcp \
  --header "Authorization: Bearer sk_live_..."

包含完整 API 的私有连接器

第二个端点为通过 URL 添加该连接器的 Scrupp 客户提供更完整的工具集 （Claude.ai：Settings → Connectors → Add custom connector；地址见 https://scrupp.com/docs/api/claude 中的设置指南）。该端点未列入目录，且适用于 所有 Scrupp 套餐。除核心工具外，它还提供 API 中的其他工具： scrupp_build_sales_navigator_search（用文字描述受众 → 生成 Sales Navigator 搜索 URL，并附上 Sales Navigator 报告的规模，不消耗点数）， scrupp_export_sales_navigator_search、scrupp_export_linkedin_search、 scrupp_run_apollo_search、scrupp_enrich_linkedin_profiles（可选包含 邮箱）、scrupp_lookup_company 和 scrupp_find_decision_makers。

如果调用方拥有已通过 Scrupp 扩展连接 Sales Navigator 的 LinkedIn 账号，所有工具都只在 该账号上运行。否则，它们会使用 Scrupp 的共享账号池，该账号池对付费套餐开放。是否使用 该账号池由 Scrupp API 决定，而非此服务。

OAuth 资源用于区分这两个端点：每个端点的受保护资源元数据都会声明各自的资源，而 app.scrupp.com 仅针对私有资源颁发私有连接器的密钥（connector:claude-sn）。 即使将 /mcp 连接器的密钥发送到私有端点，该密钥调用除查找邮箱之外的所有工具时仍会收到 403。

使用 OAuth 连接

Claude.ai、Claude Desktop 和 Claude Code 的用户无需粘贴密钥：只需点击 Connect，登录 Scrupp 并允许访问。服务会在 /.well-known/oauth-protected-resource（RFC 9728）处公布其 授权服务器，并在收到未经身份验证的请求时返回 401，以及指向该地址的 WWW-Authenticate 标头。授权服务器本身位于 Scrupp 应用中，即 app.scrupp.com （/oauth/register、/oauth/authorize、/oauth/token）；它颁发的访问令牌是普通的 Scrupp API 密钥，标记为 connector:claude，API 会将其限制为上述四种工具。访问令牌有效期为 一小时，因此服务会在每次请求前检查令牌（缓存一分钟）；令牌过期时会返回 401 invalid_token，客户端据此刷新令牌。

变量	默认值	含义
PORT	8787	监听端口
MCP_PUBLIC_URL	https://mcp.scrupp.com	此服务的公共 URL，用于元数据
SCRUPP_AUTH_SERVER_URL	https://app.scrupp.com	OAuth 令牌的颁发地址
SCRUPP_API_URL	https://api.scrupp.com/api/v1	工具调用的 Scrupp API

工具描述是为模型而非人编写的：它们说明何时应使用该工具，而不只是说明工具的功能。在注册目录中， 这正是全部的排序信号——描述含糊的已列出服务会被选中，随后遭到误用。

发布

1. 将此目录移至独立仓库 Wism-Corp/scrupp-mcp-server——MCP 注册目录会根据仓库和 package.json 中的 mcpName 验证所有权。
2. 使用 GitHub Actions 提供来源证明，执行 npm publish --access public；工作流形式与 n8n-nodes-scrupp 相同。
3. 发布注册目录条目：

   npx @modelcontextprotocol/publisher login github
   npx @modelcontextprotocol/publisher publish
   

   它会读取 server.json，检查 npm 包是否包含匹配的 mcpName，然后列出该服务。
4. 然后提交到下游目录；这些目录从注册目录读取信息或通过表单接收信息： Smithery、Glama、mcp.so、PulseMCP 和 Anthropic 的连接器目录。

发布前测试

npm install
SCRUPP_API_KEY=... npx @modelcontextprotocol/inspector node src/index.js

先运行 scrupp_credits（免费），再使用两个人运行 scrupp_find_emails——这是能测试创建 → 轮询 → 结果 流程的最低成本调用。