Needle

Needle MCP

Công cụ outbound engine của Needle mà agent có thể gọi. Tạo danh sách khách hàng tiềm năng và triển khai hoạt động tiếp cận trên LinkedIn, Instagram và email từ Claude, ChatGPT, Codex, Cursor, Grok, OpenCode hoặc bất kỳ MCP client nào.

Kho lưu trữ này là hướng dẫn thiết lập. Máy chủ được lưu trữ tại:

https://needle.app/mcp/v1

Các tham số, giới hạn và danh sách công cụ đầy đủ có trong tài liệu Needle MCP.

Bạn có thể làm gì

• Khách hàng tiềm năng. Tạo danh sách khách hàng tiềm năng từ LinkedIn và Places.
• Chiến dịch. Triển khai hoạt động tiếp cận đa kênh, đa tài khoản trên LinkedIn và Instagram.
• Bản nháp. Soạn tin nhắn để một người xem xét và phê duyệt trước khi gửi.
• LinkedIn. Tìm kiếm mọi người và triển khai hoạt động tiếp cận từ các tài khoản đã kết nối.
• Instagram. Tiếp cận mọi người trên Instagram từ các tài khoản đã kết nối.
• Sự kiện. Tìm kiếm hoạt động trên các chiến dịch, khách hàng tiềm năng và tài khoản đã kết nối.
• Places. Tìm công ty và địa điểm để tạo danh sách.
• Tài khoản đã kết nối. Kết nối tài khoản LinkedIn và Instagram để gửi tin nhắn.
• Danh sách chặn. Không đưa những người và công ty bạn không nên liên hệ vào danh sách.
• Webhook. Nhận mọi sự kiện outbound tại URL của riêng bạn ngay khi sự kiện xảy ra.
• Soạn tin. Xem trước tin nhắn trước khi gửi.
• Tệp. Lưu trữ tệp riêng tư, sau đó đính kèm tệp vào tin nhắn LinkedIn hoặc InMail.

Thích dùng HTTP? Hãy xem tài liệu tham khảo API. Mới dùng Needle? Bắt đầu với kỹ năng onboarding.

Cài đặt kỹ năng agent của Needle:

npx skills add needle-ai/needle-mcp

Prompt mẫu

Dán một trong các prompt này vào agent sau khi kết nối Needle.

Hoàn tất onboarding

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.

Khách hàng tiềm năng từ bài đăng 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.

Giới thiệu qua mối quan hệ sẵn có

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.

Thiết lập

Mỗi ứng dụng đăng nhập cho bạn bằng OAuth trong trình duyệt. Bạn cũng có thể dùng API key trong header Authorization. Xem Xác thực.

Không cần đăng nhập để liệt kê công cụ tại https://needle.app/mcp/v1/tools.

Claude

Thêm Needle vào Claude trên web và máy tính. Claude mở hộp thoại thêm ứng dụng với Needle đã được điền sẵn. Nhấp Continue, rồi nhấp Connect. Đăng nhập vào Needle và nhấp Allow.

ChatGPT

Thêm Needle làm MCP app tùy chỉnh. Bạn phải bật chế độ nhà phát triển.

1. Trong ChatGPT, mở Settings, rồi mở Security and login và bật Developer mode.
2. Mở chatgpt.com/plugins và nhấp +.
3. Nhấp Create custom MCP server, rồi nhấp Create MCP App.
4. Nhập Needle làm tên. Trong Connection, giữ nguyên Server URL và dán https://needle.app/mcp/v1.
5. Giữ Authentication ở chế độ OAuth, đánh dấu I understand and want to continue, rồi nhấp Create.

ChatGPT sẽ yêu cầu bạn thêm Needle. Nhấp Sign in with Needle, đăng nhập và nhấp Allow.

Codex

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

Sau đó chạy codex mcp login needle, đăng nhập và nhấp Allow. codex mcp list hiển thị needle là đã bật.

Cursor

Thêm Needle vào Cursor. Cursor mở Needle trong trình duyệt. Đăng nhập và nhấp Allow.

Hoặc dán nội dung này vào .cursor/mcp.json (dự án này) hoặc ~/.cursor/mcp.json (mọi dự án):

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

Grok

1. Mở grok.com/connectors.
2. Nhấp New Connector, rồi nhấp Custom.
3. Nhập Needle làm tên và https://needle.app/mcp/v1 làm URL máy chủ.
4. Nhấp Add Connector.

Grok mở Needle trong trình duyệt. Đăng nhập và nhấp Allow.

Grok Bot

Grok Bot thêm connector từ cuộc trò chuyện.

1. Mở Grok Bot trên máy tính hoặc iOS và bắt đầu cuộc trò chuyện.
2. Gửi tin nhắn này:

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

3. Khi Grok Bot yêu cầu xác nhận, nhấp Add it.
4. Nhấp vào thẻ kết nối, đăng nhập vào Needle và nhấp Allow.

Các công cụ của Needle sẽ sẵn sàng từ tin nhắn tiếp theo.

OpenCode

Thêm nội dung này vào opencode.json:

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

Chạy opencode mcp auth needle, đăng nhập và nhấp Allow.

Ứng dụng khác

Dán https://needle.app/mcp/v1 vào nơi ứng dụng yêu cầu MCP server. Lần đầu sử dụng, ứng dụng sẽ mở trang đăng nhập Needle. Đăng nhập và nhấp Allow.

Xác thực

Đăng nhập, nhấp Allow là hoàn tất kết nối. Mỗi kết nối được liên kết với một người dùng và một workspace. Token hết hạn sau một giờ và tự động được làm mới. Các phiên được liệt kê trong Settings → Sessions, nơi bạn có thể ngắt kết nối một phiên.

Để dùng API key, hãy gửi cùng header như REST API:

Authorization: Bearer sk-ndl-…

Tạo key trong API keys. Mỗi key được liên kết với một người dùng và một workspace.

Tài liệu

• Needle MCP — hướng dẫn thiết lập và toàn bộ công cụ
• Xác thực
• Tài liệu tham khảo API
• Kỹ năng onboarding
• Mục lục tài liệu agent