Needle

公式

本番環境対応のRAGをすぐに利用でき、自身のドキュメントからデータを検索・取得できます。

GitHub

105

Needle MCPで何ができますか？

リードリストを作成 — LinkedInとPlacesから、ワークスペースにすでに登録されている人を除外してリードリストを作成するよう、アシスタントに依頼します。
アウトリーチキャンペーンを実施 — 接続済みアカウントから、LinkedInとInstagramで複数チャネル・複数アカウントのアウトリーチを実施します。
確認用のメッセージを下書き — 送信前に担当者が確認・承認できるメッセージを下書きし、送信前にプレビューします。
アクティビティを検索 — キャンペーン、リード、接続済みアカウント全体のアクティビティを検索します。
抑制リストを管理 — 連絡すべきでない人や企業をリストから除外します。
ファイルを保存して添付 — 非公開ファイルを保存し、LinkedInメッセージまたはInMailに添付します。

ドキュメント

Needle MCP

Needle のアウトバウンドエンジンを、エージェントが呼び出せるツールとして利用できます。Claude、ChatGPT、Codex、Cursor、Grok、OpenCode、または任意の MCP クライアントから、リードリストを作成し、LinkedIn、Instagram、メールでアプローチを実行できます。

このリポジトリはセットアップガイドです。サーバーは次の場所でホストされています。

https://needle.app/mcp/v1

パラメーター、制限、すべてのツールの一覧については、Needle MCP docs をご覧ください。

できること

リード。 LinkedIn と Places からリードリストを作成します。
キャンペーン。 LinkedIn と Instagram で、複数チャネル・複数アカウントのアプローチを実行します。
下書き。 送信前に担当者が確認して承認できるメッセージの下書きを作成します。
LinkedIn。 人物を検索し、接続済みアカウントからアプローチを実行します。
Instagram。 接続済みアカウントから Instagram のユーザーにアプローチします。
イベント。 キャンペーン、リード、接続済みアカウント全体のアクティビティを検索します。
Places。 リスト作成に使う企業や場所を見つけます。
接続済みアカウント。 LinkedIn と Instagram のアカウントを接続して、そこから送信します。
抑制リスト。 連絡すべきでない人物や企業をリストから除外します。
Webhook。 発生したすべてのアウトバウンドイベントを、独自の URL で受信します。
メッセージ作成。 送信前にメッセージをプレビューします。
ファイル。 非公開ファイルを保存し、LinkedIn メッセージまたは InMail に添付します。

HTTP を使う場合は、API reference をご覧ください。Needle を初めて使う場合は、onboarding skill から始めてください。

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 キーを指定する方法も使えます。Authentication をご覧ください。

https://needle.app/mcp/v1/tools でのツール一覧の取得には、サインインは不要です。

Claude

ウェブ版またはデスクトップ版の Claude に Needle を追加します。Claude が Needle を入力済みの追加ダイアログを開きます。Continue、次に Connect をクリックします。Needle にサインインして Allow をクリックします。

ChatGPT

Needle をカスタム MCP アプリとして追加します。Developer mode を有効にする必要があります。

ChatGPT で Settings を開き、次に Security and login を開いて、Developer mode をオンにします。
chatgpt.com/plugins を開き、+ をクリックします。
Create custom MCP server、次に Create MCP App をクリックします。
名前に Needle を入力します。Connection で Server URL を選択したまま、https://needle.app/mcp/v1 を貼り付けます。
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

Cursor に Needle を追加します。Cursor がブラウザーで Needle を開きます。サインインして Allow をクリックします。

または、.cursor/mcp.json（このプロジェクト）または ~/.cursor/mcp.json（すべてのプロジェクト）に次の内容を貼り付けます。

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

Grok

grok.com/connectors を開きます。
New Connector、次に Custom をクリックします。
名前に Needle を入力し、サーバー URL に https://needle.app/mcp/v1 を指定します。
Add Connector をクリックします。

Grok がブラウザーで Needle を開きます。サインインして Allow をクリックします。

Grok Bot

Grok Bot では、チャットからコネクターを追加できます。

デスクトップまたは iOS で Grok Bot を開き、チャットを開始します。
次のメッセージを送信します。

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

Grok Bot から確認を求められたら、Add it をクリックします。
接続カードをクリックし、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 人のユーザーと 1 つのワークスペースに紐付けられます。トークンは 1 時間後に期限切れとなり、自動的に更新されます。セッションは Settings → Sessions に一覧表示され、そこで接続を解除できます。

API キーを使う場合は、REST API と同じヘッダーを送信します。

Authorization: Bearer sk-ndl-…

API keys でキーを作成します。各キーは 1 人のユーザーと 1 つのワークスペースに紐付けられます。

ドキュメント

Needle MCP — セットアップとすべてのツール
Authentication
API reference
Onboarding skill
Agent docs index