Needle

offiziell

Produktionsreifes RAG direkt einsatzbereit, um Daten aus Ihren eigenen Dokumenten zu durchsuchen und abzurufen.

GitHub

105

Was kann man mit Needle MCP machen?

Lead-Listen erstellen — Bitte deinen Assistenten, Lead-Listen aus LinkedIn und Places zu erstellen und dabei Personen auszulassen, die sich bereits in deinem Workspace befinden.
Outreach-Kampagnen durchführen — Führe kanalübergreifende Outreach-Kampagnen über mehrere Konten auf LinkedIn und Instagram mit verbundenen Konten durch.
Nachrichten zur Prüfung entwerfen — Entwirf Nachrichten, die eine Person vor dem Versand prüfen und freigeben kann, und zeige eine Nachricht vor dem Versand in der Vorschau an.
Aktivitäten durchsuchen — Durchsuche Aktivitäten in Kampagnen, bei Leads und in verbundenen Konten.
Sperrlisten verwalten — Sorge dafür, dass Personen und Unternehmen, die du nicht kontaktieren solltest, nicht auf der Liste stehen.
Dateien speichern und anhängen — Speichere eine private Datei und hänge sie anschließend an eine LinkedIn-Nachricht oder InMail an.

Dokumentation

Needle MCP

Die Outbound-Engine von Needle als Tools, die ein Agent aufrufen kann. Erstelle Lead-Listen und führe Outreach auf LinkedIn, Instagram und per E-Mail über Claude, ChatGPT, Codex, Cursor, Grok, OpenCode oder einen beliebigen MCP-Client durch.

Dieses Repository ist die Einrichtungsanleitung. Der Server wird gehostet unter:

https://needle.app/mcp/v1

Parameter, Limits und die vollständige Tool-Liste findest du in der Needle MCP-Dokumentation.

Was du tun kannst

Leads. Erstelle Lead-Listen aus LinkedIn und Places.
Kampagnen. Führe kanalübergreifenden Outreach über mehrere Konten auf LinkedIn und Instagram durch.
Entwürfe. Verfasse Nachrichten, die eine Person vor dem Versand prüfen und freigeben kann.
LinkedIn. Suche nach Personen und führe Outreach über verbundene Konten durch.
Instagram. Erreiche Personen auf Instagram über verbundene Konten.
Events. Durchsuche Aktivitäten über Kampagnen, Leads und verbundene Konten hinweg.
Places. Finde Unternehmen und Standorte, um Listen zusammenzustellen.
Verbundene Konten. Verbinde LinkedIn- und Instagram-Konten, über die Nachrichten versendet werden.
Sperrlisten. Halte Personen und Unternehmen, die du nicht kontaktieren solltest, von der Liste fern.
Webhooks. Empfange jedes Outbound-Ereignis in Echtzeit unter deiner eigenen URL.
Verfassen. Sieh dir eine Nachricht vor dem Versand in der Vorschau an.
Dateien. Speichere eine private Datei und hänge sie anschließend an eine LinkedIn-Nachricht oder InMail an.

Du bevorzugst HTTP? Verwende die API-Referenz. Neu bei Needle? Beginne mit dem Onboarding-Skill.

Installiere den Needle-Agent-Skill:

npx skills add needle-ai/needle-mcp

Beispiel-Prompts

Füge einen dieser Prompts in deinen Agenten ein, sobald Needle verbunden ist.

Onboarding abschließen

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.

Leads aus einem LinkedIn-Beitrag

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.

Warme Empfehlungen

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.

Einrichten

Jede App meldet dich per OAuth im Browser an. Ein API-Schlüssel im Header Authorization funktioniert ebenfalls. Siehe Authentifizierung.

Zum Auflisten der Tools unter https://needle.app/mcp/v1/tools ist keine Anmeldung erforderlich.

Claude

Füge Needle zu Claude hinzu, im Web und auf dem Desktop. Claude öffnet den Dialog zum Hinzufügen und trägt Needle bereits ein. Klicke auf Continue und dann auf Connect. Melde dich bei Needle an und klicke auf Allow.

ChatGPT

Füge Needle als benutzerdefinierte MCP-App hinzu. Der Entwicklermodus muss aktiviert sein.

Öffne in ChatGPT Settings, dann Security and login, und aktiviere Developer mode.
Öffne chatgpt.com/plugins und klicke auf +.
Klicke auf Create custom MCP server und dann auf Create MCP App.
Gib Needle als Namen ein. Lass unter Connection die Option Server URL ausgewählt und füge https://needle.app/mcp/v1 ein.
Lass Authentication auf OAuth, aktiviere I understand and want to continue und klicke auf Create.

ChatGPT fordert dich auf, Needle hinzuzufügen. Klicke auf Sign in with Needle, melde dich an und klicke auf Allow.

Codex

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

Führe anschließend codex mcp login needle aus, melde dich an und klicke auf Allow. codex mcp list zeigt needle als aktiviert an.

Cursor

Füge Needle zu Cursor hinzu. Cursor öffnet Needle im Browser. Melde dich an und klicke auf Allow.

Oder füge dies in .cursor/mcp.json (dieses Projekt) oder ~/.cursor/mcp.json (jedes Projekt) ein:

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

Grok

Öffne grok.com/connectors.
Klicke auf New Connector und dann auf Custom.
Gib Needle als Namen und https://needle.app/mcp/v1 als Server-URL ein.
Klicke auf Add Connector.

Grok öffnet Needle im Browser. Melde dich an und klicke auf Allow.

Grok Bot

Grok Bot fügt Connectoren über den Chat hinzu.

Öffne Grok Bot auf dem Desktop oder unter iOS und starte einen Chat.
Sende diese Nachricht:

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

Wenn Grok Bot dich um Bestätigung bittet, klicke auf Add it.
Klicke auf die Verbindungskarte, melde dich bei Needle an und klicke auf Allow.

Die Needle-Tools stehen ab der nächsten Nachricht bereit.

OpenCode

Füge dies zu opencode.json hinzu:

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

Führe opencode mcp auth needle aus, melde dich an und klicke auf Allow.

Eine andere App

Füge https://needle.app/mcp/v1 dort ein, wo die App nach einem MCP-Server fragt. Bei der ersten Verwendung wird eine Needle-Anmeldeseite geöffnet. Melde dich an und klicke auf Allow.

Authentifizierung

Melde dich an, klicke auf Allow und die Verbindung ist hergestellt. Jede Verbindung ist an einen Benutzer und einen Workspace gebunden. Tokens laufen nach einer Stunde ab und werden automatisch erneuert. Sitzungen werden unter Settings → Sessions aufgeführt. Dort kannst du eine Verbindung trennen.

Um einen API-Schlüssel zu verwenden, sende denselben Header wie bei der REST-API:

Authorization: Bearer sk-ndl-…

Erstelle einen Schlüssel unter API keys. Jeder Schlüssel ist an einen Benutzer und einen Workspace gebunden.