Needle

Needle MCP

Исходящий движок Needle в виде инструментов, которые может вызывать агент. Создавайте списки потенциальных клиентов и запускайте рассылки в LinkedIn, Instagram и по электронной почте из Claude, ChatGPT, Codex, Cursor, Grok, OpenCode или любого MCP-клиента.

Этот репозиторий — руководство по настройке. Сервер размещён по адресу:

https://needle.app/mcp/v1

Параметры, ограничения и полный список инструментов приведены в документации Needle MCP.

Что можно делать

• Потенциальные клиенты. Создавать списки потенциальных клиентов из LinkedIn и Places.
• Кампании. Запускать многоканальные рассылки с нескольких аккаунтов в LinkedIn и Instagram.
• Черновики. Готовить сообщения, чтобы человек проверил и одобрил их перед отправкой.
• LinkedIn. Искать людей и запускать рассылки с подключённых аккаунтов.
• Instagram. Связываться с людьми в Instagram через подключённые аккаунты.
• События. Искать активность в кампаниях, среди потенциальных клиентов и в подключённых аккаунтах.
• Places. Находить компании и местоположения для составления списков.
• Подключённые аккаунты. Подключать аккаунты LinkedIn и Instagram для отправки сообщений.
• Исключения. Исключать из списков людей и компании, с которыми не следует связываться.
• Вебхуки. Получать каждое исходящее событие на собственный URL сразу после его возникновения.
• Составление сообщений. Предварительно просматривать сообщение перед отправкой.
• Файлы. Хранить приватный файл, а затем прикреплять его к сообщению или InMail в LinkedIn.

Предпочитаете 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 в браузере. Также можно использовать ключ API в заголовке Authorization. См. раздел Аутентификация.

Для просмотра списка инструментов по адресу 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. Откройте Grok Bot на компьютере или устройстве iOS и начните чат.
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.

Другое приложение

Вставьте https://needle.app/mcp/v1 в поле, где приложение запрашивает MCP-сервер. При первом использовании откроется страница входа в Needle. Войдите в систему и нажмите Allow.

Аутентификация

Войдите в систему, нажмите Allow — и подключение готово. Каждое подключение привязано к одному пользователю и одному рабочему пространству. Срок действия токенов истекает через час, после чего они обновляются автоматически. Список сеансов находится в разделе Settings → Sessions, где можно отключить любой из них.

Чтобы использовать ключ API, отправьте тот же заголовок, что и для REST API:

Authorization: Bearer sk-ndl-…

Создайте ключ в разделе API keys. Каждый ключ привязан к одному пользователю и одному рабочему пространству.

Документация

• Needle MCP — настройка и описание всех инструментов
• Аутентификация
• Справочник API
• Навык для онбординга
• Указатель документации для агентов