🔌 El protocolo en lenguaje cotidiano

¿Eres nuevo aquí? Hasta ahora, en la Ruta 0 y la Ruta 1, tu agente ya sabía leer y escribir archivos, ejecutar comandos en la terminal y organizar una carpeta de proyecto. Eso es mucho — pero tiene un límite estricto: solo ve lo que está dentro del computador donde se ejecuta. Pedirle que «mire tal sitio» o «lea mi hoja de cálculo de Google» sin ayuda adicional es como pedirle a alguien encerrado en una habitación sin ventanas que describa la calle de afuera.

¿Eres nuevo aquí? Una API (sigla de interfaz de programación de aplicaciones) es la "puerta de entrada" que un sitio o servicio deja abierta para que los programas se comuniquen con él; sin API, la única forma de obtener datos de un sitio es abrir el navegador y copiarlos a mano. Y "protocolo" es simplemente un conjunto acordado de reglas: cómo pedir, qué informar y en qué orden. Todo protocolo existe para que dos partes desconocidas puedan entenderse sin tener que negociar desde cero cada vez; es el mismo principio que un enchufe eléctrico o un idioma común.

Leyenda: sin un puente instalado, todo lo que está fuera de la carpeta del proyecto —sitios, hojas de cálculo, bases de datos— es invisible para el agente, aunque la información exista y esté a un clic de distancia en tu navegador.

¿Eres nuevo aquí? MCP significa Model Context Protocol — en palabras sencillas, un "acuerdo" sobre cómo un agente de IA se comunica con un servicio externo. Piensa en un tomacorriente estandarizado: cualquier aparato que siga el mismo formato de enchufe encaja en el mismo tomacorriente, sin adaptador. Antes de MCP, cada herramienta externa requería un "cable" (código) distinto para conectarse. Con MCP, todos hablan el mismo formato: el agente se conecta y ya entiende qué ofrece ese servicio.

Leyenda: a la izquierda, un agente sin MCP solo ve los archivos de la carpeta local. A la derecha, con MCP activado, se conecta a un «enchufe estandarizado» y accede a servicios externos, sin que tengas que escribir una línea de código de conexión.

Vale la pena reforzar lo que hace el MCP no es: no es una inteligencia artificial, no es un sitio web, no es una app. Es solo un conjunto acordado de mensajes, parecido al formato de un correo electrónico (asunto, destinatario, cuerpo), que tanto el agente como el servidor MCP saben crear y leer. Antes de que existiera este estándar, cada empresa que quería conectar su herramienta con un agente de IA inventaba su propio formato, y cada integración se convertía en un proyecto de programación aparte. MCP acabó con esa reinvención: un estándar publicado que cualquier servicio puede adoptar.

¿Eres nuevo aquí? Uno servidor MCP es un programita que se ubica entre tu agente y el servicio real (Firecrawl, Google Drive, una base de datos, etc.). «Traduce» el pedido del agente al formato que ese servicio espera y traduce la respuesta de vuelta. No escribes este traductor: ya viene listo; solo lo conectas (módulo 2.3) y lo autenticas con tu propia clave.

¿Eres nuevo aquí? "Autenticar" quiere decir demostrarle a un servicio que eres quien dices ser, normalmente con una clave de API, una secuencia larga de letras y números que funciona como una contraseña solo tuya, generada en el sitio del servicio. El servidor MCP guarda esa clave en un archivo llamado .env dentro de tu proyecto (crearás este archivo en el módulo 2.3): nunca dentro de la conversación con el agente, porque todo lo que pasa por el chat puede terminar guardado en algún lugar. El ejemplo de abajo es solo el formato: nunca uses una clave real en un lugar público.

# arquivo .env na raiz do projeto
NOME_DO_SERVICO_API_KEY=SUA_CHAVE_AQUI

Cómo verificar: pídele al agente «enumera las herramientas MCP disponibles». Si responde con la lista del servicio, la clave se leyó correctamente; si aparece un error de autenticación, revisa el siguiente bloque.

Cuando un servidor MCP está conectado, expone una lista de «herramientas» disponibles, como el menú de un restaurante. El agente lee ese menú (el proceso técnico se llama descubrimiento de herramientas) y, según lo que pediste, elige por su cuenta cuál llamar y con qué parámetros. No necesitas saber el nombre exacto de la función ni memorizar ninguna sintaxis: solo tienes que describir lo que quieres en portugués.

En la práctica, una solicitud tuya se convierte en una breve secuencia de pasos automáticos. Mira la línea de tiempo de «trae los precios de esta página» con un servidor de scraping conectado:

¿Eres nuevo aquí? Un servidor MCP puede ejecutarse de dos formas: local (un programita instalado en tu computadora, que Claude Code activa al abrirse) o remoto (una dirección en internet que ya funciona en algún servidor; solo tienes que apuntar a ella). Para el curso, usarás principalmente servidores locales instalados con un solo comando: son más fáciles de entender y auditar.

Una nota importante, que aplica desde ahora y vuelve con fuerza en el módulo 2.5 (scraping): cuando un servidor MCP busca información en un sitio de terceros, está sujeto a los términos de uso de ese sitio y a los límites de solicitudes que impone. Algunos sitios bloquean el acceso automatizado por defecto; en ese caso, el servidor devuelve un error o una página vacía, y la solución no es «insistir más», sino comprobar si ese sitio permite ese tipo de acceso. Y si los datos incluyen información personal de terceros, trátala con el mismo cuidado que tratarías tu propia información: recopila solo lo necesario, guarda solo lo necesario.

Ahora que entiendes el «porqué» del MCP, los próximos módulos se basan en esto: la anatomía de un servidor (2.2), cómo instalar y autenticar de forma segura (2.3), cómo mantener al agente informado sobre qué herramienta usar sin sobrecargar el CLAUDE.md (2.4), un build real que hace scraping de un sitio (2.5) y, por último, ejecutar varios agentes MCP en paralelo (2.6).

Leyenda: la ruta 2 es una escalera — cada módulo depende del anterior. Estás en el 2.1 (el "porqué"); del 2.2 al 2.6 se construye el "cómo", hasta terminar con varios agentes MCP trabajando al mismo tiempo.