Needle

Needle MCP

Needle 出站引擎，可作为智能体调用的工具。从 Claude、ChatGPT、Codex、Cursor、Grok、OpenCode 或任何 MCP 客户端构建潜在客户名单，并在 LinkedIn、Instagram 和电子邮件上开展外联。

本仓库是设置指南。服务器托管于：

https://needle.app/mcp/v1

参数、限制和完整工具列表请参阅 Needle MCP 文档。

你可以做什么

• 潜在客户。 从 LinkedIn 和 Places 构建潜在客户名单。
• 营销活动。 在 LinkedIn 和 Instagram 上开展多渠道、多账号外联。
• 草稿。 起草消息，供他人审核并批准后再发送。
• LinkedIn。 搜索人员，并通过已连接的账号开展外联。
• Instagram。 通过已连接的账号联系 Instagram 上的用户。
• 事件。 搜索营销活动、潜在客户和已连接账号中的活动。
• Places。 查找公司和地点，以便收集名单。
• 已连接的账号。 连接 LinkedIn 和 Instagram 账号以便发送消息。
• 抑制名单。 将不应联系的人员和公司排除在名单之外。
• Webhooks。 事件发生时，将每个出站事件发送到你自己的 URL。
• 撰写。 发送前预览消息。
• 文件。 存储私有文件，然后将其附加到 LinkedIn 消息或 InMail。

更喜欢使用 HTTP？请参阅 API 参考。刚开始使用 Needle？请从入门技能开始。

安装 Needle 智能体技能：

npx skills add needle-ai/needle-mcp

示例提示词

连接 Needle 后，将以下任一提示词粘贴到你的智能体中。

完成入门设置

Help me finish my Needle onboarding. Read my onboarding info to see my ideal customer profile, the leads Needle found, and my draft campaign. Then activate my campaign, and after that start looking for more leads.

从 LinkedIn 帖子获取潜在客户

Pull the people who commented on and reacted to this LinkedIn post: [paste the post URL]. Add the ones who fit my ideal customer as leads, skip anyone already in my workspace, and draft a short first message for the best fits.

温暖引荐

Look through my LinkedIn connections and find who can give me a warm intro to [name or company]. Rank the best paths, say why each person is a good route, and draft a short note I can send them.

设置

每个应用都会在浏览器中通过 OAuth 登录。也可以使用 Authorization 标头中的 API 密钥。请参阅身份验证。

列出 https://needle.app/mcp/v1/tools 上的工具无需登录。

Claude

在网页端和桌面端将 Needle 添加到 Claude。Claude 会打开已填入 Needle 的添加对话框。点击 Continue，然后点击 Connect。登录 Needle 并点击 Allow。

ChatGPT

将 Needle 添加为自定义 MCP 应用。必须开启开发者模式。

1. 在 ChatGPT 中打开 Settings，然后打开 Security and login，并开启 Developer mode。
2. 打开 chatgpt.com/plugins 并点击 +。
3. 点击 Create custom MCP server，然后点击 Create MCP App。
4. 将 Needle 设为名称。在 Connection 下，保留 Server URL 并粘贴 https://needle.app/mcp/v1。
5. 保持 Authentication 设为 OAuth，勾选 I understand and want to continue，然后点击 Create。

ChatGPT 会提示你添加 Needle。点击 Sign in with Needle，登录并点击 Allow。

Codex

codex mcp add needle --url https://needle.app/mcp/v1

然后运行 codex mcp login needle，登录并点击 Allow。codex mcp list 会显示 needle 已启用。

Cursor

将 Needle 添加到 Cursor。Cursor 会在浏览器中打开 Needle。登录并点击 Allow。

或者将以下内容粘贴到 .cursor/mcp.json（此项目）或 ~/.cursor/mcp.json（所有项目）：

{
  "mcpServers": {
    "needle": {
      "url": "https://needle.app/mcp/v1"
    }
  }
}

Grok

1. 打开 grok.com/connectors。
2. 点击 New Connector，然后点击 Custom。
3. 将 Needle 设为名称，并将 https://needle.app/mcp/v1 设为服务器 URL。
4. 点击 Add Connector。

Grok 会在浏览器中打开 Needle。登录并点击 Allow。

Grok Bot

Grok Bot 可在聊天中添加连接器。

1. 在桌面端或 iOS 上打开 Grok Bot 并开始聊天。
2. 发送以下消息：

Add a custom MCP server called needle at https://needle.app/mcp/v1. It supports OAuth.

3. Grok Bot 提示确认时，点击 Add it。
4. 点击连接卡片，登录 Needle 并点击 Allow。

从下一条消息开始即可使用 Needle 的工具。

OpenCode

将以下内容添加到 opencode.json：

{
  "mcp": {
    "needle": {
      "type": "remote",
      "url": "https://needle.app/mcp/v1",
      "enabled": true
    }
  }
}

运行 opencode mcp auth needle，登录并点击 Allow。

其他应用

在应用要求填写 MCP 服务器时，粘贴 https://needle.app/mcp/v1。首次使用时会打开 Needle 登录页面。登录并点击 Allow。

身份验证

登录并点击 Allow，即可完成连接。每个连接都绑定到一个用户和一个工作区。令牌一小时后过期，并会自动刷新。会话列在设置 → 会话下，你可以在此断开连接。

如需使用 API 密钥，请发送与 REST API 相同的标头：

Authorization: Bearer sk-ndl-…

在 API 密钥下创建密钥。每个密钥都绑定到一个用户和一个工作区。

文档

• Needle MCP — 设置指南和所有工具
• 身份验证
• API 参考
• 入门技能
• 智能体文档索引