🌱 Novo por aqui?
Você vai ver nomes como assistente de código, n8n, MCP, skill, workflow e agente. Cada um é explicado num quadrinho "O que é X?" na primeira vez. Não decore: o objetivo é entender o papel de cada peça. Pense num time: tem o cérebro (assistente), a esteira de montagem (n8n), as tomadas que ligam apps externos (MCP), os manuais de procedimento (skills) e o funcionário autônomo (agente).
Veja o ecossistema inteiro de uma vez. No centro está o assistente de código — o cérebro que lê, escreve e decide. À volta dele estão as peças que ele comanda ou usa: o construtor visual (n8n), o protocolo que liga ferramentas externas (MCP), as instruções reutilizáveis (skills/workflows), e o resultado final que pode rodar na sua máquina ou sozinho na nuvem.
Diagrama ilustrativo — o assistente (ciano) é o coordenador no centro; em volta, as peças que ele comanda ou usa; à direita, onde o resultado pode rodar. Você vai conhecer cada uma a seguir.
🧠 O assistente de código
O que é
O assistente de código é o cérebro do ecossistema: uma IA que vive dentro do seu editor de texto e sabe fazer quatro coisas concretas — ler os arquivos do seu projeto, escrever e editar código, rodar comandos no terminal e conectar ferramentas externas via MCP. É com ele que você conversa em linguagem natural; tudo o mais (n8n, skills, agentes) ou é comandado por ele ou alimenta o trabalho dele.
O que é?Editor de texto (editor de código) — o programa onde o assistente vive e onde os arquivos do projeto ficam visíveis (painel de chat, explorador de arquivos à esquerda, terminal embaixo). Terminal — a janela onde se digitam comandos para o computador; o assistente pode usá-la por você.
Uma disciplina importante já aqui: uma pasta por projeto. Você abre só a pasta dedicada daquele projeto — nunca uma pasta-raiz com vários projetos dentro. Assim o assistente vê só o que importa, e não se confunde nem mistura contextos. Há ainda modos de permissão (perguntar antes de editar, editar automaticamente, modo plano…) que controlam o quanto o assistente age por conta própria.
Por que aprender
Entender o assistente como coordenador muda tudo: você para de procurar "qual botão aperto" e passa a pensar "qual resultado descrevo". Ele é a peça que transforma a sua frase em arquivos, comandos e conexões reais.
- •Lê e escreve: enxerga seus arquivos e cria/edita o que for preciso.
- •Roda comandos: instala coisas, executa scripts — sem você decorar comandos.
- •Conecta o resto: via MCP, ganha acesso a apps e serviços externos.
Conceitos-chave
Coordena todas as peças.
Ler, escrever, rodar, conectar.
Abra só a pasta dedicada.
Controlam o quanto ele age.
🔗 n8n — o construtor visual
O que é
O n8n é um construtor visual de workflows (fluxos de automação) do tipo low/no-code: em vez de escrever código, você liga nós (nodes) numa tela, e cada nó faz uma coisa — ler um e-mail, filtrar, chamar uma API, gravar numa planilha. Conectando os nós, você cria automações que ligam apps, dados, IA e serviços externos.
O que é?Workflow (fluxo) — uma sequência de passos automatizados, do gatilho à ação. Nó (node) — cada caixinha do fluxo, com um trabalho só. Low/no-code — construir com pouca ou nenhuma escrita de código, ligando blocos visuais.
Construir n8n na mão é poderoso, mas trabalhoso e propenso a erro — uma única configuração errada num nó é difícil de achar. É exatamente aí que o assistente entra: conectado ao seu n8n, ele lê, cria, modifica, testa e depura os workflows por você. O n8n vira a "esteira de montagem" determinística; o assistente vira quem a monta e a conserta.
Diagrama ilustrativo — cada nó tem um trabalho e passa o resultado ao próximo. O assistente liga e ajusta esses nós por você.
Por que aprender
O n8n é onde muitas automações "moram". Saber que ele é determinístico (a mesma entrada gera a mesma saída) e visual ajuda a entender por que ele é confiável para tarefas repetitivas — e por que combinar n8n (a esteira previsível) com IA (o cérebro flexível) é tão potente.
Conceitos-chave
Liga blocos numa tela.
Cada um faz uma coisa.
E-mail, planilhas, APIs, IA.
Cria, testa e depura por você.
🔌 MCP — o protocolo das ferramentas
O que é
MCP (Model Context Protocol, "protocolo de contexto do modelo") é o padrão que dá ferramentas externas ao assistente. Pense numa tomada universal: uma única conexão (um MCP server) expõe um conjunto inteiro de ações. Por exemplo, um server de e-mail expõe "enviar", "rascunhar", "buscar mensagens" — e o assistente decide sozinho qual ação chamar, quando, e com quais parâmetros.
O que é?Protocolo — um "idioma" combinado para duas coisas conversarem. MCP server — o programinha que liga o assistente a um serviço externo (e-mail, banco de dados, raspador de sites…). Ferramenta (tool) — cada ação que esse server oferece. API — a "porta de entrada" de um serviço para outros programas falarem com ele.
Por que aprender
Sem MCP, o assistente só sabe o que está dentro do editor. Com MCP, ele alcança o mundo: raspar a web, ler um banco de dados, criar documentos, mandar mensagens. É o MCP que permite, por exemplo, conectar o assistente ao seu n8n para ele construir workflows ali dentro. Descobrir e instalar servers (via diretórios ou repositórios) abre o leque de tarefas.
✓ O que o MCP faz
- ✓Expõe muitas ferramentas por uma só conexão.
- ✓O assistente escolhe sozinho a ação e os parâmetros.
- ✓Conecta categorias: web, bancos, documentos, comunicação.
✗ O que evitar
- ✗Colar chave de API no chat (ela vai no
.env, não na conversa). - ✗Deixar muitos servers ligados sem usar (gasta contexto).
- ✗Configurar global quando o certo é por projeto.
Conceitos-chave
Uma conexão, muitas ações.
Liga o assistente ao serviço.
As ações disponíveis.
Ela escolhe qual usar.
📄 Skills & workflows
O que é
Workflows e skills são, no fundo, a mesma coisa: instruções reutilizáveis escritas em markdown (texto simples com títulos, listas e negrito). Funcionam como um manual de procedimento (SOP) que diz ao assistente o que fazer, passo a passo. A diferença é só onde vivem e como são chamadas: uma skill mora numa pasta especial e vira um comando rápido (slash command, ex.: /rascunhar-email) que você invoca sob demanda.
O que é?Markdown — um jeito simples de formatar texto (com # para títulos, - para listas). SOP — "procedimento operacional padrão", um manual de como fazer uma tarefa. Slash command — um atalho escrito com barra (/) que dispara uma skill.
Por que aprender
Skills te poupam de reexplicar a mesma tarefa toda vez. Elas trazem consistência (mesmo processo sempre), economia (carregam só quando chamadas, não pesam o contexto à toa), e compartilhamento (a equipe usa a mesma). E, como uma skill pode chamar ferramentas (scripts que fazem o trabalho), o sistema de instruções + ferramentas continua intacto por baixo.
🎯 Dica prática
Use uma skill quando a tarefa se repete, exige consistência ou tem passos fáceis de esquecer. Para algo de uma vez só, ou tão simples que cabe numa frase, é melhor só digitar — uma skill seria exagero.
Conceitos-chave
Instruções em texto simples.
Não reexplique toda vez.
Invoca sob demanda.
Pode acionar scripts.
🤖 Agentes — quando o sistema decide
O que é
Um agente é o que surge quando o sistema deixa de só "executar passos fixos" e passa a decidir sozinho. Numa automação tradicional, você fia cada passo e, se quebra, você conserta. Num workflow agêntico, você diz o resultado que quer e o agente raciocina, se adapta, faz perguntas de esclarecimento e até se auto-corrige quando algo falha.
O que é?Agêntico — comportamento de quem raciocina e escolhe o caminho, em vez de seguir um roteiro fixo. Auto-cura (self-healing) — quando o agente erra, diagnostica e conserta sozinho durante a sessão. Determinístico × não-determinístico — automação tradicional é previsível; o agente é flexível e pode variar.
Diagrama ilustrativo — a diferença está na linha de baixo: o agente não trava no erro; ele diagnostica e segue até o objetivo.
Por que aprender
Entender o que é um agente evita dois enganos: achar que toda IA "decide sozinha" (nem sempre), e achar que automação fixa é "burra" (ela é confiável de propósito). A analogia ajuda: contratar um desenvolvedor experiente (agente) é diferente de seguir uma receita à risca (automação tradicional). Você escolhe a peça certa para cada tarefa.
Conceitos-chave
Raciocina sobre o caminho.
Faz perguntas, ajusta.
Erra, diagnostica, conserta.
Você diz o "o quê".
🖥️☁️ Local vs hospedado
O que é
A última peça é uma escolha: rodar local ou rodar hospedado. Local = na sua máquina: você abre o assistente, dispara o trabalho e ele roda ali, com você presente. Hospedado = na nuvem: o código é colocado num serviço que o executa sozinho, na internet, num horário marcado ou em resposta a um evento — sem ninguém para apertar o botão.
O que é?Hospedar (deploy) — colocar o código para rodar num servidor na internet, não na sua máquina. Cron (agendamento) — um relógio que dispara a tarefa num horário (ex.: 7h todo dia). Webhook — uma "campainha digital": uma URL que, ao receber dados, acorda a tarefa.
Por que aprender
Local é ótimo para aprender e construir: você vê tudo acontecer e constrói intuição. Mas automação disparada por humano só escala na velocidade de uma pessoa aparecer. Hospedar é o que faz a automação trabalhar enquanto você dorme. O preço é o agentic gap: na nuvem o assistente não está olhando para se auto-curar, então confiabilidade (logs, tratamento de erro, alertas) passa a ser sua responsabilidade desde o início.
🖥️ Local — sua máquina
- ✓Você dispara e acompanha em tempo real.
- ✓O assistente se auto-cura na hora.
- ✓Ideal para aprender e prototipar.
☁️ Hospedado — a nuvem
- ✓Roda sozinho: por agenda (cron) ou por evento (webhook).
- ✓Escala sem você estar presente.
- !Exige logs, tratamento de erro e alertas (agentic gap).
Conceitos-chave
Na sua máquina, com você.
Na nuvem, sozinho.
Por agenda ou por evento.
Sem auto-cura na nuvem.
No ecossistema, quem é o coordenador que lê arquivos, escreve, roda comandos e aciona as outras peças?
📌 Resumo do Módulo
Próximo Módulo:
1.3 — Glossário Essencial (Parte 1: IA, Claude Code, n8n)