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 の名前に url ではなく serverUrl を指定します。

接続のデバッグには、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.