Sem MCP, a IA só sabe conversar. Com MCP, ela age: lê e-mails, consulta um banco, busca uma página na web, manda mensagem no Slack. O truque é que você não conecta uma ação por vez — você conecta um server (um serviço inteiro, como o e-mail) e ele já anuncia todas as suas ferramentas de uma vez. O agente vê o cardápio e escolhe o prato certo para o pedido.

Diagrama ilustrativo — uma conexão (o server) entrega um conjunto de ferramentas. O agente lê o que está disponível e decide, a cada pedido, qual ferramenta usar.

O que é

MCP (Model Context Protocol) é uma linguagem comum para a IA conversar com serviços externos. Em vez de você ligar uma ação por vez, uma única conexão expõe muitas ferramentas daquele serviço. Pense num serviço de e-mail: ao conectar o server de e-mail, o agente passa a ter acesso a "enviar", "rascunhar", "buscar mensagem" — tudo de uma vez.

O protocolo resolve o problema do "como a IA descobre e usa uma ação": ele padroniza a descrição das ferramentas. Por isso o agente consegue, sozinho, decidir qual ferramenta chamar, quando chamar e com quais parâmetros. É assim que a IA ganha "braços" — sai de só conversar para de fato agir no mundo.

Por que aprender

Conceitos-chave

O que é

Assim que o agente e o server MCP se conectam, o agente passa a conhecer todas as ferramentas disponíveis daquele server — nomes, descrições e parâmetros. A partir daí, a decisão é dele: você descreve o resultado em linguagem natural ("mande um aviso pro time"), e o agente escolhe a ferramenta certa ("enviar mensagem") e preenche os parâmetros.

Diagrama ilustrativo — você não diz "use a tool X". Você descreve o resultado; o agente compara o pedido com as ferramentas conhecidas e escolhe a melhor.

Por que aprender

Saber que a decisão é do agente muda como você pede: você foca no resultado, não em apontar a ferramenta. E quando ele escolher errado, você corrige com contexto ("não rascunhe, envie de fato") em vez de microgerenciar. Também explica por que um server "ligado mas inútil" ainda atrapalha: suas tools entram na lista que o agente precisa avaliar.

Conceitos-chave

O que é

Instalar um server MCP gera (ou edita) um arquivo .mcp.json: ele guarda a configuração do server e, quando o serviço exige autenticação, um espaço reservado para a chave de API. A chave em si você cola manualmente no arquivo. Nunca no chat, e nunca pedindo para o agente inserir por você.

{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "API_KEY": "<cole-sua-chave-aqui>"
      }
    }
  }
}

Por que aprender

Chave colada no chat vira parte do histórico da conversa — que pode ser registrado, compartilhado ou vazar. Colar no arquivo mantém o segredo onde só você (e o programa) alcança. Essa é uma regra de segurança, não uma preferência de estilo: trate toda chave como senha.

Conceitos-chave

O que é

A configuração de MCP pode viver em dois escopos: global (vale para a máquina inteira, todos os projetos enxergam) ou por projeto (o .mcp.json fica dentro da pasta do projeto e só vale ali). A recomendação é por projeto: ele isola os segredos e o contexto de cada trabalho.

Diagrama ilustrativo — no global, um vazamento contamina tudo; por projeto, cada trabalho fica em sua bolha.

Por que aprender

Configuração global pode disparar um aviso de segurança a cada reinício (o programa avisa que servers globais estão ativos para qualquer projeto). A correção é mover a config para dentro da pasta do projeto. Por projeto, você também evita que um cliente "veja" ferramentas e chaves de outro — menos risco, menos ruído.

Conceitos-chave

O que é

Servers MCP ficam em dois lugares principais: diretórios de MCP (sites que catalogam servers, como o mcp.so) e no GitHub (busque "MCP server" + o nome do serviço que você quer). Antes de instalar, você procura o server do serviço alvo; depois, segue o README dele.

Por que aprender

Saber onde caçar evita reinventar a roda: na maioria dos casos, o server que você precisa já existe. Conhecer as categorias comuns também acelera a busca — você sabe que existe algo para web scraping, banco de dados, documentos e comunicação, e vai direto.

Categorias comuns de servers

Conceitos-chave

O que é

O comando /mcp lista os servers instalados e o status de cada um (conectado, com erro, etc.). É a sua "saúde do MCP". E há uma regra de ouro do diagnóstico: se um server recém-instalado não aparece na lista, reinicie o assistente primeiro — isso resolve na maioria das vezes.

/mcp

A sequência completa, passo a passo

Por que aprender

Sem o /mcp, você fica no escuro: não sabe se o server conectou, falhou ou nem foi lido. E sem o reflexo de reiniciar, perde tempo "consertando" o que não está quebrado. Reiniciar é o primeiro passo de qualquer troubleshooting de MCP — barato, rápido e quase sempre suficiente.

Conceitos-chave

O que é

Cada server ativo injeta as definições das suas ferramentas no contexto da IA — e isso consome tokens. Muitos servers ligados = mais texto que o modelo precisa ler antes de responder, mesmo que você não use nenhum deles. A regra: desligue os servers que você não está usando para liberar contexto.

Diagrama ilustrativo — cada server liga um bloco de definições. Menos blocos = mais espaço para a IA pensar, menos custo e menos ruído.

Por que aprender

Contexto entupido tem três custos: gasta mais tokens (mais caro), confunde o agente (mais ferramentas para avaliar = mais chance de escolher errado) e deixa tudo mais lento. Manter ativos só os servers do trabalho atual é a forma mais simples de cortar custo e erro de uma vez.

Conceitos-chave