Vibe Coding · Explora las conexiones

API y MCP: De una fresa madura a la bandeja

Tres ideas sobre el mismo esquema de la cosecha. Usa las pestañas para cambiar de concepto y los botones para avanzar paso a paso.

Desliza el diagrama hacia los lados para ver todas las conexiones.

foto + parcela analizar orden / acuse Cámara R-03parcela 7 · fila 12 Backend 1 · Recibir foto 2 · Validar robot 3 · Consultar IA 4 · Asignar tarea lo que pasa detrás IA de visiónmadurez + posición Robot R-03pinza + sensores Base de datostareas de recolección POST /fotos POST /analizar POST /tareas driver · no HTTP

¿Dónde encajan API y MCP en un sistema de cosecha?

Las API conectan los servicios. MCP permite que una aplicación con un modelo de lenguaje descubra y utilice herramientas para consultar o actuar sobre ellos.

Cómo se utiliza en este recurso

Tres diagramas con pasos controlables muestran las API, la capa MCP y las decisiones de conexión.

Alcance y límites

Simulación didáctica sin conexiones reales. La lectura directa de la base de datos depende de los permisos y del diseño del sistema.

Preguntas frecuentes

¿Qué aporta MCP si ya tenemos una API?

La API ofrece las operaciones del sistema; MCP permite presentarlas como herramientas que una aplicación de IA puede descubrir y utilizar. Por ejemplo, el backend ya sabe consultar robots y bandejas. El servidor MCP publica listar_robots_libres y consultar_bandejas. Ante «¿podemos recoger la parcela 7?», el modelo puede proponer consultar esas herramientas y preparar una respuesta con los resultados. Hay que implementar las herramientas y sus permisos: MCP aporta una forma común de conectarlas, no crea por sí solo la lógica de la cosecha.

¿Qué ocurre cuando cambia el backend o añadimos otra finca?

Si cambia una URL, podemos adaptar el servidor MCP conservando el contrato de la herramienta. Ejemplo: la consulta pasa de GET /robots/libres a GET /flota?estado=disponible. Si listar_robots_libres sigue aceptando la misma parcela y devuelve los mismos datos, el host puede seguir utilizándola sin conocer esa nueva URL. Para añadir otra finca, la herramienta podría aceptar campo_id y el backend comprobar los permisos de ese campo. Si cambian los parámetros, las respuestas o lo que significa «disponible», también hay que revisar el contrato y probar las aplicaciones que lo usan. MCP concentra parte del mantenimiento en el adaptador; no evita todos los cambios.

¿Podemos cambiar de aplicación de IA y reutilizar las herramientas?

Un mismo servidor MCP puede servir a distintas aplicaciones compatibles. Por ejemplo, el encargado consulta las bandejas desde un asistente y el equipo técnico revisa tareas fallidas desde otro, reutilizando consultar_bandejas y consultar_tareas. Cada conexión necesita su configuración y sus permisos. Cambiar de modelo dentro de una aplicación depende de ese host, y puede cambiar cómo se eligen las herramientas. Conviene probar una petición concreta, como «resume las tareas pendientes de la finca Norte», y comprobar que el nuevo modelo interpreta bien los campos y los resultados.

¿Cuándo conviene usar la API directamente y cuándo añadir MCP?

Para el recorrido fijo cámara → backend → IA de visión → robot, una API directa encaja bien: llega una foto con su parcela, se analiza y se procesa la tarea siguiendo reglas definidas. MCP aporta más cuando una aplicación de IA necesita elegir entre varias consultas o acciones. Por ejemplo, ante «¿por qué hay menos bandejas listas hoy?», podría consultar el recuento de bandejas y los robots detenidos para explicar los datos disponibles. Si solo necesitamos enviar siempre la misma foto al mismo servicio, añadir MCP puede no compensar. También puede utilizarlo un agente automático: no requiere que siempre haya una persona escribiendo en un chat.

¿Cómo se controla una acción y se comprueba que sigue funcionando?

Consultar y actuar requieren permisos distintos. Por ejemplo, consultar_estado_robot puede devolver que R-03 está libre; asignar_tarea debe pasar por el backend, que comprueba batería, parcela, disponibilidad y duplicidades. La aplicación puede pedir confirmación antes de autorizar la tarea, y el sistema debe registrar el resultado. Tras una actualización, probamos casos concretos: robot disponible, batería insuficiente, parcela sin permiso y una tarea repetida que no debe ejecutarse dos veces. MCP Inspector ayuda a probar las herramientas; después se comprueba también la petición completa desde el asistente. Si se permite consultar la base de datos para informes, se limita el acceso a las vistas y permisos necesarios. MCP no aplica todos estos controles por sí solo.

Fuentes para contrastar y ampliar

Recursos relacionados