Needle

Needle MCP 服务

将 Claude、ChatGPT、Cursor 和其他 MCP 客户端连接到你的 Needle 潜在客户：查看该回复谁、完整阅读潜在客户信息、用你的品牌语气起草回复、标记已处理的潜在客户，并在 Reddit、Hacker News、论坛等平台上运行新的搜索。

在 Claude 中： Needle 已列入 Claude 的连接器目录。

• URL： https://api.useneedle.net/mcp（Streamable HTTP）
• 身份验证： 使用你的 Needle 账户登录（OAuth），或使用从 Needle Settings → API & MCP 获取的 API 密钥。适用于 Growth 和 Scale 套餐，以及 7 天免费试用（完整访问权限，无需信用卡）。
• 变更： CHANGELOG.md。工具和字段绝不会重命名或移除。
• 文档： useneedle.net/docs/mcp（工具、限制、错误）和 REST API

设置

claude.ai 和 Claude Desktop： 打开 Claude 连接器目录中的 Needle，或前往 Settings → Connectors，找到 Needle 并点击 Connect。登录 Needle 并选择 Allow。如果你的工作区无法使用该目录，请选择 Add custom connector 并粘贴 https://api.useneedle.net/mcp。

ChatGPT： Plugins → Add → Add custom MCP server。输入 https://api.useneedle.net/mcp，将 Authentication 保持为 OAuth，勾选 I understand and want to continue，然后点击 Create 和 Connect。登录 Needle 并选择 Allow。

Claude Code

claude mcp add --transport http needle https://api.useneedle.net/mcp

然后运行 /mcp，选择 needle 并在浏览器中完成身份验证。

Cursor： 使用上方的按钮，或将以下内容添加到 mcp.json 并点击 Connect：

{
  "mcpServers": {
    "needle": { "url": "https://api.useneedle.net/mcp" }
  }
}

使用 API 密钥（适用于 Windsurf、脚本或任何无法登录的客户端）：

{
  "mcpServers": {
    "needle": {
      "url": "https://api.useneedle.net/mcp",
      "headers": { "Authorization": "Bearer ndl_live_…" }
    }
  }
}

在 Windsurf 的 mcp_config.json 中，将 URL 命名为 serverUrl，而不是 url。

要调试连接，请运行 MCP Inspector（npx @modelcontextprotocol/inspector），选择 Streamable HTTP 并输入 URL。

你登录过的应用会列在 Needle 的 Settings → API & MCP → Connected apps 下，你可以在此断开连接。

技能

现成的工作流，采用 Agent Skills 格式（skills/<name>/SKILL.md）。每项技能都会说明大致需要多少次 API 调用。

技能	功能
daily-lead-shortlist	今日最优潜在客户，并附上一句话说明“为何回复”，跳过已忽略的潜在客户
five-replies-a-morning	为你的前 5 位潜在客户起草回复
competitor-switchers	正在离开竞争对手的用户，以及联系切入点
weekly-pain-report	汇总本周的痛点和问题，并按主题归类，附上引述
trend-to-content	根据热门问题和你的潜在客户生成内容创意

Needle 不会替你发布内容：草稿只是供你审核和发布的文本。

错误

失败的工具调用会以稳定的代码开头（例如 search_in_progress），随后是 JSON 格式的详细信息，其中包括指向错误表的 doc_url，以及可在联系支持团队时引用的 request_id。

支持

在此代码库中提交 issue，或发送邮件至 [email protected]。

许可证

MIT © VS NextGen Solutions。