🛠️ Ferramenta: o verbo que o agente pode executar
Novo aqui? Um protocolo é apenas um conjunto de regras combinadas de antemão pra duas partes conseguirem conversar sem se entender mal — como o "câmbio, desligo" do rádio, só que entre programas de computador. MCP (Model Context Protocol) é o protocolo que o módulo anterior apresentou: a linguagem comum que permite que o agente converse com um servidor — um programinha rodando (no seu computador ou na nuvem de alguém) que sabe fazer uma coisa específica e fica esperando pedidos. Uma ferramenta (em inglês, tool) é uma ação concreta que esse servidor oferece — um verbo. "Buscar o conteúdo de uma página", "mandar um e-mail", "ler uma linha de uma planilha". Cada servidor MCP declara sua lista de ferramentas junto com uma descrição curta de cada uma, e é essa descrição que o agente lê pra decidir qual usar — sem que você precise saber o nome técnico de nada.
💡 Conceito Principal
Pense na ferramenta como o nome do botão de um controle remoto. Você não precisa entender a eletrônica por trás — só saber que apertar aquele botão faz aquilo. O servidor MCP é o aparelho de TV; as ferramentas são os botões; você só aperta o botão certo dizendo em português o que quer.
Legenda: entre a sua frase em português e a ação de verdade acontecendo, existe um passo invisível — o agente decidindo qual ferramenta do servidor MCP resolve aquele pedido.
🔍 Ver por dentro
O que "trafega" entre o agente e o servidor é uma mensagem estruturada — não é o texto solto que você digitou, é um pacote com o nome da ferramenta escolhida e os valores que ela precisa. O servidor lê esse pacote, roda a ação no serviço de verdade (um site, um banco de dados, uma API — a "porta" que outro programa abre pra conversar com o seu) e devolve o resultado no mesmo formato. Você nunca vê essa troca crua; o agente traduz o resultado de volta pra português normal.
🎛️ Parâmetro: o que a ferramenta precisa saber antes de agir
Novo aqui? Parâmetro é uma informação extra que a ferramenta precisa pra funcionar direito — o endereço do site, o formato do arquivo de saída, o número máximo de páginas. Você não escreve isso na mão: o agente extrai esses valores do seu pedido em português e preenche sozinho.
✓ Exemplo de pedido claro
"Extraia os preços da página inema.club/planos, no máximo 5 páginas." — o agente já tem tudo que a ferramenta precisa: URL e limite.
✗ Exemplo de pedido vago
"Pega os preços por aí" — sem endereço, o agente vai ter que perguntar de volta antes de conseguir preencher os parâmetros.
Todo parâmetro tem um "formato esperado" — a ferramenta pode exigir um número (limite de páginas), um texto (a URL) ou uma opção de uma lista fixa (formato de saída: csv ou json, por exemplo). Quando o parâmetro é opcional, o servidor MCP costuma ter um valor padrão — se você não disser quantas páginas, ele assume um limite razoável sozinho, geralmente pequeno, pra não gastar tempo nem chamadas à toa.
💡 Dica Prática
Quando não tiver certeza do que uma ferramenta precisa, basta pedir: "quais parâmetros essa ferramenta de busca aceita?" — o agente lê a descrição técnica e traduz pra você em português, sem você precisar abrir nenhuma documentação.
🔑 Autenticação: a chave que prova quem é você
Novo aqui? Autenticação é a prova de que você tem permissão pra usar aquele serviço — geralmente uma "chave de API", um código secreto único que o serviço reconhece. É como o cartão magnético que abre a porta de um prédio: sem ele, ninguém entra, nem o agente.
💡 Dica Prática
Guarde sempre essa chave num arquivo .env — nunca digite ela direto na conversa com o agente. O módulo 2.3 mostra o passo a passo completo.
A chave normalmente vem de um cadastro no site do serviço — você cria uma conta, gera a chave numa página de configurações e cola ela no arquivo .env do seu projeto. O servidor MCP lê esse arquivo sozinho toda vez que precisa autenticar; ele nunca aparece na tela do chat nem é enviado pro agente como texto. Alguns serviços cobram por chamada ou têm um limite mensal de uso grátis — vale checar isso antes de deixar um agente rodar sem supervisão em loop.
Erros comuns nessa etapa
Chave inválida ou expirada: o servidor devolve um erro de autenticação e a ferramenta não roda. Fix: confira se colou a chave inteira no .env, sem espaço extra, e se ela ainda está ativa no painel do serviço.
Limite de uso estourado: planos grátis costumam ter um teto mensal de chamadas. Quando estoura, o serviço recusa até o mês virar ou você fazer upgrade. Fix: peça ao agente pra checar quantas chamadas restam antes de rodar tarefas em massa.
🧩 As três peças juntas: um pedido real do início ao fim
Legenda: as três peças de qualquer servidor MCP — as ferramentas disponíveis, os parâmetros que cada uma exige e a chave de autenticação que garante que só você (ou quem você autorizar) usa aquele serviço em seu nome.
Quando você pede "traga os preços dessa página", o agente: (1) escolhe a ferramenta certa dentre as disponíveis, (2) monta os parâmetros — a URL que você mencionou, o formato de saída — e (3) o servidor MCP usa a chave de autenticação guardada pra fazer a chamada de verdade ao serviço externo. Você só viu uma frase em português; por baixo, as três peças trabalharam juntas.
Linha do tempo de um pedido, do "enter" à resposta
Você escreve o pedido em português normal, sem pensar em ferramenta nenhuma.
O agente escolhe a ferramenta certa, lendo as descrições que o servidor MCP publicou.
O agente monta os parâmetros a partir do que você disse — URL, formato, limites.
O servidor autentica com a chave guardada no .env e chama o serviço de verdade.
O resultado volta — ou um erro, se algo deu errado — e o agente traduz pra você em português.
🔍 Ver por dentro: quando o serviço responde com erro
Se o passo 4 falhar — chave inválida, serviço fora do ar, resultado vazio porque não achou nada — o servidor MCP não trava: ele devolve uma mensagem de erro estruturada, e é essa mensagem que o agente lê pra decidir o próximo passo: tentar de novo, avisar você, ou sugerir um caminho diferente. Um resultado vazio (a busca não achou nada) não é a mesma coisa que um erro — vale pedir ao agente pra distinguir os dois antes de assumir que algo quebrou.
📖 Onde ver a lista de ferramentas de um servidor
Todo servidor MCP publica sua documentação — geralmente uma página no site do serviço listando cada ferramenta, os parâmetros esperados e exemplos. Vale a pena dar uma passada de olho antes de instalar, mesmo que você nunca vá escrever esses nomes na mão: ajuda a entender o que o agente vai conseguir fazer por você.
🔍 Por dentro
Dentro do Claude Code, rodar /mcp mostra os servidores MCP ligados naquela sessão e o status de cada um — ligado, autenticado, com erro.
Copy-run: checar o status dos seus servidores MCP
Objetivo: ver, em segundos, quais servidores MCP estão ligados na sessão atual e se algum precisa de autenticação.
/mcp
Como verificar: a lista deve mostrar cada servidor conectado com um status — "connected", "needs auth" ou algo parecido. Se um servidor que você instalou não aparecer na lista, o problema está na instalação, não na ferramenta em si (isso é assunto do módulo 2.3).
⚖️ Nem toda ferramenta é segura por padrão
Algumas ferramentas só leem informação (buscar, listar) — baixo risco. Outras escrevem ou enviam algo pra fora (mandar e-mail, publicar um post, apagar um registro) — risco real, porque a ação já aconteceu quando o agente terminar. O Claude Code pede sua confirmação antes de rodar ferramentas sensíveis; não desative essa confirmação sem pensar duas vezes.
Ferramentas de leitura
Buscar, listar, ler — rodam sem grande risco, geralmente sem pedir confirmação extra.
Ferramentas de escrita
Enviar, apagar, publicar — o Claude Code pede sua confirmação antes de executar.
Uma ferramenta comum de leitura é o scraping — a extração automática de informação de uma página de internet, sem passar por uma API oficial daquele site. É útil, mas exige responsabilidade: sites têm termos de uso que às vezes proíbem scraping, alguns bloqueiam pedidos automatizados por padrão (e o servidor MCP simplesmente devolve erro ou uma página vazia), e dados pessoais de terceiros que você encontrar nunca devem virar planilha ou automação sem cuidado com privacidade. Trate scraping como visitar uma loja física fora do horário de expediente: só porque a porta não está trancada não significa que você tem permissão de entrar sempre que quiser, em qualquer volume.
Legenda: ferramentas de leitura não deixam rastro irreversível, então rodam direto; ferramentas de escrita passam por uma confirmação porque, depois de executadas, muitas vezes não dá pra desfazer.
💡 Dica Prática
Se o resultado de uma ferramenta de leitura vier vazio, não assuma que "não existe" — pode ser um site bloqueando scraping automatizado. Peça ao agente pra tentar de novo ou pra confirmar se o site devolveu algum erro, antes de concluir que a informação não está lá.