Aprende

Antes de leer las páginas más técnicas de esta sección, conviene tener claras las palabras que se usan. Nada de fórmulas ni jerga: explicaciones que se entienden a la primera.

Qué es una API

API significa Application Programming Interface (interfaz de programación de aplicaciones). Suena técnico, pero la idea es simple:

Una API es la forma en que dos programas hablan entre sí, sin humanos de por medio.

La analogía del restaurante lo explica bien:

• Tú (una app) te sientas en la mesa.
• El camarero es la API.
• La cocina es el otro sistema (por ejemplo, la base de datos de un banco, o el servidor de Gmail).

Tú no entras en la cocina ni le gritas al cocinero. Le pides al camarero (la API), de una carta con opciones concretas («tráeme el plato 5»), y el camarero te trae exactamente eso. La carta es el contrato: define qué puedes pedir y qué te van a devolver. Ni más ni menos.

Ejemplos que usas sin darte cuenta:

• Cuando una web te deja «pagar con PayPal», esa web habla con PayPal por su API.
• Cuando ves el tiempo en el móvil, la app del tiempo pide los datos a la API de una empresa meteorológica.
• Cuando Vaucai lee tu Gmail, habla con la API de Google.

Qué es una «API REST»

REST es simplemente el estilo más común de construir una API hoy. No es otra cosa distinta, es una API que sigue unas convenciones concretas:

• Se habla por internet (HTTP), la misma tecnología que usa tu navegador.
• Cada cosa tiene una dirección (URL), por ejemplo .../facturas/123.
• Y usas unos verbos estándar:

GET

dame / lee (traer una factura)

POST

crea (crear una factura nueva)

PUT / PATCH

modifica

DELETE

borra

Cuando alguien dice «conéctate por API REST», quiere decir: «habla con mi sistema por internet, pidiendo cosas con esas URLs y esos verbos». La mayoría de servicios modernos (Holded, Factorial, un CRM, etc.) ofrecen una API REST.

Qué es MCP

MCP significa Model Context Protocol (protocolo de contexto para modelos). Es mucho más nuevo que las APIs (lo publicó Anthropic, la empresa que hace a Claude, a finales de 2024) y nació para un problema concreto:

Cómo conectar una IA (como el asistente) a herramientas y datos externos, de forma estándar.

La analogía más usada es el USB para la inteligencia artificial: antes, cada aparato tenía su cable propio y un lío de conectores. Llegó el USB y de repente todo se enchufa igual. MCP quiere ser eso: un enchufe estándar para que cualquier IA se conecte a cualquier herramienta sin tener que programar una integración a medida para cada una.

La diferencia clave con una API normal:

• Una API REST está pensada para que la usen programadores. La «carta» está escrita para humanos que programan.
• Un servidor MCP está pensado para que lo use una IA directamente. Expone sus herramientas de una forma que el modelo entiende solo: «tengo estas 3 acciones disponibles, se llaman así, y sirven para esto». El asistente lee esa lista y decide cuándo usarlas él mismo, en mitad de una conversación.

Ejemplo concreto: existe un servidor MCP de GitHub. Si conectas ese servidor MCP a un asistente, el asistente puede «abrir incidencias» o «leer código» por su cuenta cuando la conversación lo pide, porque el servidor MCP le ofrece esas herramientas ya masticadas para una IA.

En el fondo, por debajo, un servidor MCP muchas veces acaba llamando a una API REST normal. La gracia de MCP es la capa de traducción que hace que la IA lo entienda sin trabajo de programación por cada integración.

La distinción que lo ata todo: dos direcciones

Esto es lo más importante que quiero que te lleves, porque es la clave para entender qué hace Vaucai. Tanto con API como con MCP hay dos sentidos:

Casi toda la confusión con «MCP y APIs» viene de mezclar estas dos direcciones. En Vaucai vas a ver que ofrecemos unas cosas en un sentido y otras en el otro, y no todas. Las dos páginas siguientes de esta sección son, justamente, cada una de esas dos direcciones.