Ir para conteúdo principal

Como configurar o servidor MCP local da Tomba

Conecte um assistente de IA à Tomba a partir do seu próprio computador com o servidor MCP local.

Escrito por Tomba.io Team

Use o servidor MCP local para conectar um assistente de IA, como o Claude Desktop, à Tomba a partir do seu próprio computador. O MCP é uma forma padrão de os assistentes de IA usarem outras ferramentas. Depois de configurá-lo, você pode pedir ao seu assistente que encontre e verifique emails para você.

💡 Dica: A maioria das pessoas deve usar o servidor MCP remoto em vez deste. Não há nada para instalar, e a maioria dos assistentes só pede que você entre com a sua conta.

Local ou remoto?

Local

Remoto

Onde é executado

No seu computador

Nos servidores da Tomba

O que você instala

Node.js

Nada

Como você se conecta

Chave de API e chave secreta

Entrando com a sua conta, ou chave de API e chave secreta

Os dois oferecem ao seu assistente as mesmas 28 ferramentas.

Antes de começar

Você precisa de duas coisas:

  • A sua chave de API e a sua chave secreta da Tomba. Veja Como encontrar minha chave de API?.

  • Node.js 18.20 ou posterior. O Node.js é o software que executa o servidor no seu computador.

Configure o servidor

Passo 1. Abra Integrations e encontre o grupo MCP. No card Local MCP Server, selecione Connect para abrir o guia de configuração.

O grupo MCP na página Integrations, com os títulos dos cards Local MCP Server, Remote MCP Server e Composio contornados

Passo 2. Abra API Keys. Copie a sua chave e o seu Account secret da coluna API Key & Secret.

A página API Keys com uma seta na coluna API Key & Secret, onde cada valor desfocado tem um ícone para mostrar e um ícone para copiar

Passo 3. Abra o arquivo de configurações do seu assistente. No Claude Desktop, vá em Settings > Developer e selecione Edit Config.

Passo 4. Adicione a Tomba a esse arquivo com os valores abaixo. O guia de configuração tem uma versão para copiar para cada assistente.

Configuração

Valor

Nome do servidor

tomba

Comando

npx

Argumentos

-y e @tomba-io/tomba-mcp-server

TOMBA_API_KEY

A sua chave de API, que começa com ta_

TOMBA_SECRET_KEY

A sua chave secreta, que começa com ts_

⚠️ Importante: Esse arquivo contém a sua chave secreta. Não o compartilhe nem o adicione a um repositório de código.

Passo 5. Feche o seu assistente e abra-o novamente. Ele inicia o servidor para você.

Passo 6. Peça ao seu assistente que execute a ferramenta list_flags. Uma lista, mesmo vazia, significa que a conexão funciona.

O que o seu assistente pode fazer

As principais ferramentas são:

  • Encontrar emails: Domain Search, Email Finder, Author Finder e LinkedIn Finder

  • Verificar emails: Email Verifier

  • Adicionar detalhes: enriquecimento de pessoas e empresas

  • Encontrar telefones: Phone Finder e Phone Validator

  • Conhecer empresas: busca de empresas, empresas semelhantes e a tecnologia que um site usa

  • Gerenciar contatos: listar os seus leads e adicionar novos

💳 Créditos: A maioria das buscas que o seu assistente faz usa créditos, assim como no app. Listar os seus leads ou flags é gratuito.

Para desenvolvedores: veja a documentação do servidor MCP local.

Perguntas frequentes

O servidor para assim que inicia. O que está errado?

A sua versão do Node.js provavelmente é antiga demais. Atualize para a versão 18.20 ou posterior. Se aparecer uma mensagem dizendo que TOMBA_API_KEY e TOMBA_SECRET_KEY são obrigatórios, um deles está faltando no arquivo de configurações.

As ferramentas aparecem, mas todas as buscas falham. Por quê?

A sua chave ou a sua chave secreta está errada, ou a sua chave expirou. O servidor só as verifica quando uma ferramenta é executada, então ele pode parecer conectado sem estar. Confira os dois valores em API Keys.

Uma busca falhou por causa de um limite. O que eu faço?

Aguarde um momento e peça de novo. A maioria dos planos limita quantas buscas você pode fazer por segundo, por minuto e por dia. O servidor local não tenta novamente por você.

Artigos relacionados

Isto respondeu à sua pergunta?