MCP 服务

RenewSell 提供一个远程 MCP 服务。AI 助手连接后可以查看额度和目标客户、查找联系人、查询海关数据、发送外联消息。这一页说明怎么连接、有哪些工具、写操作要注意什么。

连接

1. 在 API 密钥 页面创建密钥，见 API 密钥。需要助手发消息或点赞时，勾选 允许跟进操作。
2. 在你的 AI 助手的 MCP 设置里添加一个远程 HTTP 服务。地址是 https://www.renewsell.com/api/mcp，请求头带 Authorization: Bearer <你的 API 密钥>。
3. 连接后助手会先调用 initialize，再调用 tools/list 取工具清单。服务名显示为 RenewSell。

服务只接受 POST，协议是 JSON-RPC 2.0；支持 MCP 协议版本 2024-11-05、2025-03-26、2025-06-18。用 GET 请求会返回 405。

工具

服务共 22 个工具。每个工具名都以 renewsell_ 开头，例如 renewsell_whoami。下表只写前缀之后的部分；连接后助手会显示完整名称和参数说明。

能做什么	工具	需要的授权
查看当前密钥的权限范围、套餐和已连接渠道数量	whoami	默认密钥
查看额度余额、已预留、本期用量	get_credits	默认密钥
列出已连接渠道（不含账号凭证）	list_connect_accounts	默认密钥
列出、读取目标客户	list_targets、get_target	默认密钥
读取筛选条件和每轮搜索	get_target_strategy	默认密钥
读取名单里的条目（游标分页）	list_target_items	默认密钥
创建目标客户并开始查找	create_target	默认密钥
提高目标结果数	expand_target	默认密钥
查询、取消任务	get_job、cancel_job	默认密钥
发起公司调研	research_public_web	默认密钥
查找某家公司的联系人	find_contacts	默认密钥
海关数据查询，7 个查询	customs_company_candidates 等	默认密钥
发送一条外联消息	send_outreach	允许跟进操作
给 LinkedIn 帖子点赞	like_linkedin_post	允许跟进操作

写操作

• create_target、expand_target、send_outreach、like_linkedin_post 和计费的海关查询都需要 idempotency_key。用同一个 key 重试不会重复执行或重复扣费。
• send_outreach 只能指向已有会话，或「联系人 + 渠道」；没有群发语义。
• create_target 会拒绝超过套餐每个列表结果上限的 count，不会自动调低。报错信息会写明当前套餐的上限和你请求的 count，请用更小的值重试。
• 计费的写操作和网页端使用同一套额度单位，见 额度如何计算。

计费

工具	计费
读取类工具（whoami、get_credits、列表与查询）	不收费
create_target	查找免费；被接纳的结果按 合格线索 计费
find_contacts	按公司计 联系人发现
research_public_web	按 公司调研 计费，最多 25 额度一份
海关查询	按返回行计 海关贸易数据
send_outreach、like_linkedin_post	每次按 客户互动

错误与限流

• 工具执行失败时返回 isError: true，内容里是 { code, message }。缺少授权时 code 是 insufficient_scope。
• 常见错误码：invalid_params（参数不合法）、not_found（对象不存在）、idempotency_conflict（同一个幂等键对应了不同的请求）。
• 请求过快时返回 JSON-RPC 错误 -32001，内容里带 retry_after_ms；等待后重试。
• JSON-RPC 请求格式不合法时返回 -32600；工具参数不合法属于工具错误（isError: true，code 是 invalid_params），不是 JSON-RPC 错误。

示例

列出工具：

curl "https://www.renewsell.com/api/mcp" \
  -H "Authorization: Bearer $RENEWSELL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

调用一个只读工具：

curl "https://www.renewsell.com/api/mcp" \
  -H "Authorization: Bearer $RENEWSELL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"renewsell_get_credits","arguments":{}}}'

常见问题

助手看不到工具？ 先确认密钥有效：用同一个密钥调用 GET /v1/credits 能返回额度。再确认客户端用的是远程 HTTP MCP，并且请求头是 Authorization: Bearer。

能批量发消息吗？ 不能。外联工具一次只发一条，而且必须指向已有会话或联系人。

调研工具报不可用怎么办？ 说明当前环境没有可用的调研数据源。调用会直接返回错误，不会排队，也不会扣额度。