Needle

Needle MCP

Le moteur sortant Needle, sous forme d’outils qu’un agent peut appeler. Créez des listes de prospects et lancez des campagnes de prospection sur LinkedIn, Instagram et par e-mail depuis Claude, ChatGPT, Codex, Cursor, Grok, OpenCode ou tout client MCP.

Ce dépôt est le guide de configuration. Le serveur est hébergé à l’adresse suivante :

https://needle.app/mcp/v1

Les paramètres, les limites et la liste complète des outils sont disponibles dans la documentation Needle MCP.

Ce que vous pouvez faire

• Prospects. Créer des listes de prospects à partir de LinkedIn et de Places.
• Campagnes. Lancer des campagnes de prospection multicanales et multi-comptes sur LinkedIn et Instagram.
• Brouillons. Rédiger des messages qu’une personne peut examiner et approuver avant leur envoi.
• LinkedIn. Rechercher des personnes et lancer des campagnes de prospection depuis des comptes connectés.
• Instagram. Contacter des personnes sur Instagram depuis des comptes connectés.
• Événements. Rechercher des activités dans les campagnes, les prospects et les comptes connectés.
• Places. Trouver des entreprises et des lieux pour constituer des listes.
• Comptes connectés. Connecter des comptes LinkedIn et Instagram pour envoyer des messages.
• Exclusions. Exclure de la liste les personnes et les entreprises que vous ne devez pas contacter.
• Webhooks. Recevoir chaque événement sortant sur votre propre URL au moment où il se produit.
• Rédaction. Prévisualiser un message avant de l’envoyer.
• Fichiers. Stocker un fichier privé, puis le joindre à un message LinkedIn ou à un InMail.

Vous préférez HTTP ? Consultez la référence de l’API. Vous découvrez Needle ? Commencez par le skill d’intégration.

Installez le skill d’agent Needle :

npx skills add needle-ai/needle-mcp

Exemples de prompts

Collez l’un de ces prompts dans votre agent une fois Needle connecté.

Terminer l’intégration

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.

Prospects à partir d’une publication 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.

Mises en relation chaleureuses

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.

Configuration

Chaque application vous connecte avec OAuth dans le navigateur. Une clé API dans l’en-tête Authorization fonctionne également. Consultez Authentification.

La liste des outils à l’adresse https://needle.app/mcp/v1/tools est accessible sans connexion.

Claude

Ajouter Needle à Claude sur le Web et sur ordinateur. Claude ouvre sa boîte de dialogue d’ajout avec Needle déjà renseigné. Cliquez sur Continuer, puis sur Connecter. Connectez-vous à Needle et cliquez sur Autoriser.

ChatGPT

Ajoutez Needle comme application MCP personnalisée. Le mode développeur doit être activé.

1. Dans ChatGPT, ouvrez Paramètres, puis Sécurité et connexion, et activez le Mode développeur.
2. Ouvrez chatgpt.com/plugins et cliquez sur +.
3. Cliquez sur Créer un serveur MCP personnalisé, puis sur Créer une application MCP.
4. Saisissez Needle comme nom. Sous Connexion, conservez URL du serveur et collez https://needle.app/mcp/v1.
5. Conservez Authentification sur OAuth, cochez Je comprends et je souhaite continuer, puis cliquez sur Créer.

ChatGPT vous invite à ajouter Needle. Cliquez sur Se connecter avec Needle, connectez-vous, puis cliquez sur Autoriser.

Codex

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

Exécutez ensuite codex mcp login needle, connectez-vous et cliquez sur Autoriser. codex mcp list affiche needle comme activé.

Cursor

Ajouter Needle à Cursor. Cursor ouvre Needle dans le navigateur. Connectez-vous et cliquez sur Autoriser.

Vous pouvez aussi coller ceci dans .cursor/mcp.json (ce projet) ou ~/.cursor/mcp.json (tous les projets) :

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

Grok

1. Ouvrez grok.com/connectors.
2. Cliquez sur Nouveau connecteur, puis sur Personnalisé.
3. Saisissez Needle comme nom et https://needle.app/mcp/v1 comme URL du serveur.
4. Cliquez sur Ajouter un connecteur.

Grok ouvre Needle dans le navigateur. Connectez-vous et cliquez sur Autoriser.

Grok Bot

Grok Bot ajoute des connecteurs depuis une conversation.

1. Ouvrez Grok Bot sur ordinateur ou iOS et démarrez une conversation.
2. Envoyez ce message :

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

3. Lorsque Grok Bot vous demande de confirmer, cliquez sur Ajouter.
4. Cliquez sur la carte de connexion, connectez-vous à Needle et cliquez sur Autoriser.

Les outils Needle sont prêts dès le message suivant.

OpenCode

Ajoutez ceci à opencode.json :

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

Exécutez opencode mcp auth needle, connectez-vous et cliquez sur Autoriser.

Une autre application

Collez https://needle.app/mcp/v1 à l’endroit où l’application demande un serveur MCP. Lors de la première utilisation, une page de connexion à Needle s’ouvre. Connectez-vous et cliquez sur Autoriser.

Authentification

Connectez-vous, cliquez sur Autoriser et la connexion est établie. Chaque connexion est associée à un utilisateur et à un espace de travail. Les jetons expirent au bout d’une heure et sont renouvelés automatiquement. Les sessions sont répertoriées sous Paramètres → Sessions, où vous pouvez en déconnecter une.

Pour utiliser une clé API, envoyez le même en-tête que pour l’API REST :

Authorization: Bearer sk-ndl-…

Créez une clé sous Clés API. Chaque clé est associée à un utilisateur et à un espace de travail.

Documentation

• Needle MCP — configuration et liste complète des outils
• Authentification
• Référence de l’API
• Skill d’intégration
• Index de la documentation des agents