Como instalar e usar o Apify MCP: passo a passo

Passo a passo

Antes de começar: Uma conta na Apify. O README diz que, se você não tiver, dá para criar uma gratuita na janela de login que abre; Claude Code instalado; Node.js 22 ou mais novo, só se for usar o servidor local (a versão hospedada não exige).

1. Entenda os dois jeitos de usar

   O README recomenda o servidor hospedado pela Apify, que entra com login pelo navegador. Existe também uma versão local, que roda no seu computador e precisa de um token. Este passo a passo segue o hospedado.

2. Adicione o servidor ao Claude Code

   No terminal, cole o comando e aperte Enter. Ele aponta o Claude Code para o endereço hospedado da Apify.

   ComandoCopiar ⧉

   claude mcp add apify "https://mcp.apify.com" -t http

3. Entre na sua conta da Apify

   O README diz que o Claude Code abre a página de login da Apify na primeira vez que usa o servidor. Entre ali e autorize. Nesse modo não é preciso token de API.

4. Faça um pedido simples em português ou inglês

   O README diz que o assistente acha um Actor adequado, confere a entrada e o preço, roda e lê os resultados. Comece com um pedido pequeno, para limitar o custo.

5. Limite o gasto de cada execução

   O README explica como colocar um teto no custo de uma execução, usando maxTotalChargeUsd nos Actors cobrados por evento ou maxItems nos cobrados por resultado, dentro das opções do call-actor. Você pode pedir isso ao Claude em palavras.

6. Para só conhecer sem conta, use as ferramentas de descoberta

   O README diz que algumas ferramentas, como a busca de Actors e a leitura da documentação, funcionam sem conta da Apify. Basta selecionar só essas no endereço do servidor.

Cuidados

• O servidor em si é gratuito, mas as execuções de Actors são cobradas na sua conta da Apify, conforme o preço de cada Actor. A Apify mostra o preço antes da execução pela ferramenta fetch-actor-details.
• O README diz que o plano gratuito da Apify inclui 5 dólares de uso mensal da plataforma. Confira esse valor no site da Apify, porque ele pode mudar.
• Há telemetria ligada por padrão. O README diz que ela coleta dados das chamadas de ferramentas e que a busca de Actors envia uma frase, escrita pelo modelo, com o motivo da busca. O transporte local também usa o Sentry para registro de erros.
• Para desligar a telemetria, o README manda usar o parâmetro telemetry-enabled igual a false no endereço, ou a variável TELEMETRY_ENABLED=false no servidor local.
• Pedidos e entradas dos Actors vão para a API da Apify para rodar os Actors que você chama. O README diz que a Apify não os compartilha com terceiros além do necessário para rodar esses Actors.
• Actors com permissão total precisam da sua aprovação única, e até lá o call-actor devolve um erro com um link de aprovação.
• O README avisa que o token de API deve ser tratado como senha e mantido fora de repositórios. Ele só é necessário se o cliente não aceitar OAuth ou no servidor local.
• O README diz que a Loja também lista Actors de criadores independentes, e que cada um é um produto separado, com README e preço próprios.
• O servidor hospedado aceita até 20 requisições por segundo por conta.

Como desfazer

O README não traz um passo de remoção do servidor no Claude Code.

O que o README não confirma

Esta página foi montada lendo o README. Estes pontos não estão escritos lá:

• O preço de cada Actor e o valor do plano gratuito mudam e devem ser conferidos no site da Apify antes de rodar tarefas grandes.
• O README não diz quanto uma tarefa de exemplo custaria; só que o preço aparece antes da execução.
• Os Actors citados nos exemplos são de terceiros e de criadores independentes, cada um com regras e preço próprios.
• Não está confirmado se os pedidos em português funcionam bem. Os exemplos do README estão em inglês.

Dúvidas

Próximo da lista

← #11 Figma Context · #13 Windows MCP →

Ver os 15 MCPs