Primeiros passos

Da conta à primeira pesquisa de empresas em três passos.

Crie uma conta, copie uma chave API e ligue o servidor MCP da ProsperaData ao seu editor. O plano gratuito não pede cartão e inclui 1.000 empresas por mês.

Criar conta gratuita Ir para a configuração

Endpoint MCP

https://mcp.prosperadata.com/mcp

Crie uma conta Inicie sessão na consola de programador. Sem cartão.
Obtenha uma chave API As chaves começam por ctc_ e mostram-se uma só vez.
Ligue o MCP Cole a configuração no Cursor ou no Claude Code e pesquise.

Passo 1

Crie a sua conta gratuita

Tudo o que se segue acontece na consola de programador. O plano gratuito é imediato e nunca pede cartão.

Abra a consola de programador Entre em app.prosperadata.com e inicie sessão com o seu email.
Confirme o seu espaço de trabalho O espaço de trabalho é criado no primeiro início de sessão e guarda as chaves, os créditos e o registo de auditoria.
Mantenha-se no plano gratuito O plano gratuito inclui 1.000 empresas por mês e 30 pedidos por minuto. Os planos pagos ainda não estão à venda.

Passo 2

Obtenha a chave API

As chaves começam por ctc_. Substitua ctc_… na configuração abaixo pela sua chave completa.

Abra Chaves API Na consola de programador escolha «Criar chave» e dê-lhe um nome reconhecível, como cursor ou claude-code.
Copie a chave uma única vez A chave completa só é apresentada no momento da criação. Guarde-a já no seu gestor de palavras-passe.
Mantenha-a em segredo Nunca coloque a chave num repositório nem a cole numa conversa partilhada. Se for exposta, revogue-a na consola e crie outra.
Uma chave por ferramenta Chaves separadas por editor permitem revogar uma integração sem tocar nas outras.

Passo 3

Ligue o servidor MCP

A ProsperaData fala Model Context Protocol sobre Streamable HTTP. Cole um dos blocos abaixo no editor e reinicie-o.

Cursor

Crie ou edite ~/.cursor/mcp.json com o servidor abaixo e reinicie o Cursor para que volte a ler o ficheiro.

~/.cursor/mcp.json JSON

{
  "mcpServers": {
    "prosperadata": {
      "url": "https://mcp.prosperadata.com/mcp",
      "headers": {
        "Authorization": "Bearer ctc_…"
      }
    }
  }
}

O campo url tem de ser exatamente https://mcp.prosperadata.com/mcp e o cabeçalho Authorization tem de transportar a sua chave com o prefixo Bearer. O ficheiro tem de ser JSON válido: sem comentários e vírgulas finais. Detalhes no guia do Cursor.

Claude Code

Execute isto uma vez no terminal para registar a ProsperaData como servidor MCP HTTP com o nome prosperadata.

Terminal Shell

claude mcp add --transport http prosperadata https://mcp.prosperadata.com/mcp --header "Authorization: Bearer ctc_…"

Confirme o registo com claude mcp list: prosperadata deve aparecer com o transporte http e o endpoint https://mcp.prosperadata.com/mcp. Detalhes no guia do Claude Code.

Primeira pesquisa

Peça empresas como um agente pediria

Com o servidor registado, pergunte ao editor em linguagem natural: «procura fabricantes de garrafas de vidro em Portugal». O agente chama search_companies com o país e os termos de oferta.

search_companies JSON

{
  "country": "PT",
  "query": "glass bottle manufacturers for olive oil",
  "fields": ["name", "website", "phone", "offerings", "evidence"],
  "limit": 20
}

Cada pesquisa exige um país e termos de oferta concretos (o que a empresa vende).
No máximo 100 empresas por chamada; até 1.000 empresas por mês no plano gratuito.
Um crédito por empresa única no período mensal; repetições e campos extra são grátis.
Apenas dados de nível empresarial: canais empresariais genéricos quando elegíveis, nunca perfis de contacto pessoais.

Resolução de problemas

Primeiros passos: os tropeços habituais

O email de registo nunca chega

Verifique o spam e as promoções e confirme o endereço na página de início de sessão da consola de programador. Se a conta já existir, peça um novo link de sessão em vez de criar uma segunda conta.

O editor não lista prosperadata

Reinicie o editor depois de guardar a configuração e confirme que o ficheiro está exactamente em ~/.cursor/mcp.json (Cursor) ou que o comando claude mcp add correu no mesmo âmbito onde inicia a sessão (Claude Code). Depois use claude mcp list no Claude Code.

O editor responde 401 Unauthorized

O cabeçalho Authorization tem de ser Bearer seguido de um espaço e da chave completa. As chaves começam por ctc_. Copie a chave novamente na consola de programador; se foi exposta, revogue-a e crie outra.

O editor responde 429 Too Many Requests

A quota mensal de créditos de empresas da conta foi atingida. Aguarde o próximo período mensal ou atualize o plano na consola de programador. Uma chamada nunca devolve mais de 100 empresas.

O agente não devolve empresas

Cada pesquisa exige um país e termos de oferta concretos (o que a empresa vende) e devolve no máximo 100 empresas por chamada. Amplie o país ou os termos de oferta e tente novamente.

Por que não há emails ou telemóveis pessoais?

A ProsperaData é dados de nível empresarial por conceção: o agente obtém identidade da empresa, ofertas e canais de contacto empresariais genéricos quando elegíveis — nunca perfis de contacto pessoais.