Needle

Needle MCP

O mecanismo de outbound da Needle, disponível como ferramentas que um agente pode chamar. Crie listas de leads e faça prospecção no LinkedIn, Instagram e por e-mail usando Claude, ChatGPT, Codex, Cursor, Grok, OpenCode ou qualquer cliente MCP.

Este repositório é o guia de configuração. O servidor está hospedado em:

https://needle.app/mcp/v1

Os parâmetros, limites e a lista completa de ferramentas estão na documentação do Needle MCP.

O que você pode fazer

• Leads. Crie listas de leads a partir do LinkedIn e do Places.
• Campanhas. Faça prospecção multicanal e com várias contas no LinkedIn e Instagram.
• Rascunhos. Crie rascunhos de mensagens para uma pessoa revisar e aprovar antes do envio.
• LinkedIn. Pesquise pessoas e faça prospecção usando contas conectadas.
• Instagram. Entre em contato com pessoas no Instagram usando contas conectadas.
• Eventos. Pesquise atividades em campanhas, leads e contas conectadas.
• Places. Encontre empresas e locais para criar listas.
• Contas conectadas. Conecte contas do LinkedIn e Instagram para enviar mensagens.
• Supressões. Mantenha fora da lista as pessoas e empresas que você não deve contatar.
• Webhooks. Receba cada evento de outbound na sua própria URL assim que acontecer.
• Composição. Visualize uma mensagem antes de enviá-la.
• Arquivos. Armazene um arquivo privado e anexe-o a uma mensagem do LinkedIn ou ao InMail.

Prefere HTTP? Use a referência da API. Está começando com a Needle? Comece pela skill de integração.

Instale a skill de agente da Needle:

npx skills add needle-ai/needle-mcp

Exemplos de prompts

Cole um destes prompts no seu agente depois de conectar a Needle.

Concluir a integração

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 de uma publicação do 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.

Apresentações por contatos em comum

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.

Configuração

Todos os aplicativos autenticam você com OAuth no navegador. Uma chave de API no cabeçalho Authorization também funciona. Consulte Autenticação.

Não é necessário entrar para listar as ferramentas em https://needle.app/mcp/v1/tools.

Claude

Adicione a Needle ao Claude na web e no desktop. O Claude abre a janela de adição com a Needle preenchida. Clique em Continuar e depois em Conectar. Entre na Needle e clique em Permitir.

ChatGPT

Adicione a Needle como um aplicativo MCP personalizado. O modo de desenvolvedor precisa estar ativado.

1. No ChatGPT, abra Configurações, depois Segurança e login e ative o Modo de desenvolvedor.
2. Abra chatgpt.com/plugins e clique em +.
3. Clique em Criar servidor MCP personalizado e depois em Criar aplicativo MCP.
4. Digite Needle como nome. Em Conexão, mantenha URL do servidor e cole https://needle.app/mcp/v1.
5. Mantenha Autenticação como OAuth, marque Entendo e quero continuar e clique em Criar.

O ChatGPT solicitará que você adicione a Needle. Clique em Entrar com a Needle, entre e clique em Permitir.

Codex

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

Em seguida, execute codex mcp login needle, entre e clique em Permitir. codex mcp list mostra needle como ativado.

Cursor

Adicione a Needle ao Cursor. O Cursor abre a Needle no navegador. Entre e clique em Permitir.

Ou cole isto em .cursor/mcp.json (este projeto) ou em ~/.cursor/mcp.json (todos os projetos):

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

Grok

1. Abra grok.com/connectors.
2. Clique em Novo conector e depois em Personalizado.
3. Digite Needle como nome e https://needle.app/mcp/v1 como URL do servidor.
4. Clique em Adicionar conector.

O Grok abre a Needle no navegador. Entre e clique em Permitir.

Grok Bot

O Grok Bot adiciona conectores pelo chat.

1. Abra o Grok Bot no desktop ou no iOS e inicie um chat.
2. Envie esta mensagem:

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

3. Quando o Grok Bot pedir confirmação, clique em Adicionar.
4. Clique no cartão de conexão, entre na Needle e clique em Permitir.

As ferramentas da Needle estarão prontas a partir da próxima mensagem.

OpenCode

Adicione isto a opencode.json:

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

Execute opencode mcp auth needle, entre e clique em Permitir.

Outro aplicativo

Cole https://needle.app/mcp/v1 onde o aplicativo solicitar um servidor MCP. No primeiro uso, será aberta uma página de login da Needle. Entre e clique em Permitir.

Autenticação

Entre, clique em Permitir e a conexão estará concluída. Cada conexão está vinculada a um usuário e a um workspace. Os tokens expiram após uma hora e são renovados automaticamente. As sessões estão listadas em Configurações → Sessões, onde você pode desconectar uma delas.

Para usar uma chave de API, envie o mesmo cabeçalho da API REST:

Authorization: Bearer sk-ndl-…

Crie uma chave em Chaves de API. Cada chave está vinculada a um usuário e a um workspace.

Documentação

• Needle MCP — configuração e todas as ferramentas
• Autenticação
• Referência da API
• Skill de integração
• Índice da documentação para agentes