Needle

공식

프로덕션에 바로 사용 가능한 RAG로, 자신의 문서에서 데이터를 검색하고 가져올 수 있습니다.

Needle MCP(으)로 무엇을 할 수 있나요?

  • 리드 목록 만들기 — 어시스턴트에게 LinkedIn과 Places에서 리드 목록을 만들도록 요청하고, 이미 워크스페이스에 있는 사람은 제외합니다.
  • 아웃리치 캠페인 실행 — 연결된 계정에서 LinkedIn과 Instagram을 통해 여러 채널과 계정을 활용한 아웃리치를 실행합니다.
  • 검토용 메시지 초안 작성 — 사람이 검토하고 승인한 후 보낼 메시지 초안을 작성하고, 전송 전에 메시지를 미리 봅니다.
  • 활동 검색 — 캠페인, 리드, 연결된 계정 전반의 활동을 검색합니다.
  • 연락 제외 대상 관리 — 연락하면 안 되는 사람과 회사를 목록에서 제외합니다.
  • 파일 저장 및 첨부 — 비공개 파일을 저장한 다음 LinkedIn 메시지나 InMail에 첨부합니다.

문서

Needle MCP

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 계정을 연결합니다.
  • 연락 제외. 연락하면 안 되는 사람과 회사를 목록에서 제외합니다.
  • 웹훅. 아웃바운드 이벤트가 발생할 때마다 자체 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을 입력하고 서버 URL로 https://needle.app/mcp/v1를 입력합니다.
  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.
  1. Grok Bot에서 확인을 요청하면 Add it을 클릭합니다.
  2. 연결 카드를 클릭하고 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를 클릭하면 연결이 완료됩니다. 각 연결은 사용자 한 명과 워크스페이스 한 개에 연결됩니다. 토큰은 1시간 후 만료되며 자동으로 갱신됩니다. 세션은 Settings → Sessions에서 확인할 수 있으며, 여기서 연결을 해제할 수 있습니다.

API 키를 사용하려면 REST API와 동일한 헤더를 보내세요.

Authorization: Bearer sk-ndl-…

API keys에서 키를 만드세요. 각 키는 사용자 한 명과 워크스페이스 한 개에 연결됩니다.

문서