Needle

Needle MCP

El motor de prospección de Needle, disponible como herramientas que un agente puede usar. Crea listas de clientes potenciales y realiza campañas de contacto en LinkedIn, Instagram y correo electrónico desde Claude, ChatGPT, Codex, Cursor, Grok, OpenCode o cualquier cliente MCP.

Este repositorio es la guía de configuración. El servidor está alojado en:

https://needle.app/mcp/v1

Los parámetros, los límites y la lista completa de herramientas están en la documentación de Needle MCP.

Qué puedes hacer

• Clientes potenciales. Crea listas de clientes potenciales a partir de LinkedIn y Places.
• Campañas. Realiza campañas de contacto multicanal y con varias cuentas en LinkedIn e Instagram.
• Borradores. Redacta mensajes para que una persona los revise y apruebe antes de enviarlos.
• LinkedIn. Busca personas y realiza campañas de contacto desde cuentas conectadas.
• Instagram. Contacta con personas en Instagram desde cuentas conectadas.
• Eventos. Busca actividad en campañas, clientes potenciales y cuentas conectadas.
• Places. Encuentra empresas y ubicaciones para crear listas.
• Cuentas conectadas. Conecta cuentas de LinkedIn e Instagram desde las que enviar mensajes.
• Exclusiones. Evita que las personas y empresas a las que no debes contactar aparezcan en la lista.
• Webhooks. Recibe cada evento saliente en tu propia URL en cuanto se produzca.
• Redacción. Previsualiza un mensaje antes de enviarlo.
• Archivos. Guarda un archivo privado y adjúntalo a un mensaje de LinkedIn o a un InMail.

¿Prefieres HTTP? Usa la referencia de la API. ¿Acabas de llegar a Needle? Empieza con la guía de incorporación.

Instala la habilidad de agente de Needle:

npx skills add needle-ai/needle-mcp

Ejemplos de instrucciones

Pega una de estas instrucciones en tu agente cuando Needle esté conectado.

Completar la incorporación

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.

Clientes potenciales a partir de una publicación de 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.

Presentaciones de contactos

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.

Configuración

Todas las aplicaciones te autentican con OAuth en el navegador. También puedes usar una clave de API en el encabezado Authorization. Consulta Autenticación.

No es necesario iniciar sesión para consultar las herramientas en https://needle.app/mcp/v1/tools.

Claude

Agrega Needle a Claude en la web y en la aplicación de escritorio. Claude abre el cuadro de diálogo para agregarlo con Needle ya seleccionado. Haz clic en Continue y luego en Connect. Inicia sesión en Needle y haz clic en Allow.

ChatGPT

Agrega Needle como una aplicación MCP personalizada. El modo de desarrollador debe estar activado.

1. En ChatGPT, abre Settings, luego Security and login y activa Developer mode.
2. Abre chatgpt.com/plugins y haz clic en +.
3. Haz clic en Create custom MCP server y luego en Create MCP App.
4. Escribe Needle como nombre. En Connection, deja Server URL y pega https://needle.app/mcp/v1.
5. Deja Authentication en OAuth, marca I understand and want to continue y haz clic en Create.

ChatGPT te pedirá que agregues Needle. Haz clic en Sign in with Needle, inicia sesión y haz clic en Allow.

Codex

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

Luego ejecuta codex mcp login needle, inicia sesión y haz clic en Allow. codex mcp list muestra needle como habilitado.

Cursor

Agrega Needle a Cursor. Cursor abre Needle en el navegador. Inicia sesión y haz clic en Allow.

También puedes pegar esto en .cursor/mcp.json (este proyecto) o en ~/.cursor/mcp.json (todos los proyectos):

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

Grok

1. Abre grok.com/connectors.
2. Haz clic en New Connector y luego en Custom.
3. Escribe Needle como nombre y https://needle.app/mcp/v1 como URL del servidor.
4. Haz clic en Add Connector.

Grok abre Needle en el navegador. Inicia sesión y haz clic en Allow.

Grok Bot

Grok Bot agrega conectores desde el chat.

1. Abre Grok Bot en la aplicación de escritorio o en iOS e inicia un chat.
2. Envía este mensaje:

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

3. Cuando Grok Bot te pida confirmación, haz clic en Add it.
4. Haz clic en la tarjeta de conexión, inicia sesión en Needle y haz clic en Allow.

Las herramientas de Needle estarán listas a partir del siguiente mensaje.

OpenCode

Agrega esto a opencode.json:

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

Ejecuta opencode mcp auth needle, inicia sesión y haz clic en Allow.

Otra aplicación

Pega https://needle.app/mcp/v1 donde la aplicación solicite un servidor MCP. La primera vez que lo uses, se abrirá una página para iniciar sesión en Needle. Inicia sesión y haz clic en Allow.

Autenticación

Inicia sesión, haz clic en Allow y la conexión estará lista. Cada conexión está vinculada a un usuario y un espacio de trabajo. Los tokens caducan al cabo de una hora y se renuevan automáticamente. Las sesiones aparecen en Settings → Sessions, donde puedes desconectarlas.

Para usar una clave de API, envía el mismo encabezado que en la API REST:

Authorization: Bearer sk-ndl-…

Crea una clave en API keys. Cada clave está vinculada a un usuario y un espacio de trabajo.

Documentación

• Needle MCP — configuración y todas las herramientas
• Autenticación
• Referencia de la API
• Guía de incorporación
• Índice de documentación para agentes