Entendiendo el servidor MCP de ActivityInfo

Idioma: Español
Este artículo se ha traducido del inglés mediante IA y puede contener errores. Sus comentarios nos ayudarán a mejorar.

ActivityInfo ejecuta un Servidor MCP (Protocolo de Contexto de Modelo). Permite que un asistente de IA como Claude, ChatGPT, Microsoft Copilot, Gemini Enterprise o Mistral trabaje directamente con los datos de sus Bases de datos de ActivityInfo, en lugar de que usted exporte una hoja de cálculo y la pegue en un chat.

Herramientas

Un asistente de IA por sí solo solo puede trabajar con el texto que usted le proporciona. Los asistentes recientes también pueden llamar a herramientas: operaciones pequeñas y bien definidas que van más allá de la conversación. Con una herramienta que lista las bases de datos y otra que ejecuta un análisis, un asistente responde a una pregunta llamándolas en secuencia en lugar de pedirle que usted obtenga los datos.

Tome una pregunta como "¿Qué porcentaje de los agricultores que capacitamos en Malí aumentaron su rendimiento en el año posterior a la capacitación?". Un asistente conectado a ActivityInfo lo resuelve aproximadamente así:

  1. Listar las bases de datos a las que puede acceder, para ver cuáles podrían ser relevantes.
  2. Listar los formularios e informes en la base de datos prometedora.
  3. Listar los campos de los formularios que parecen relevantes, para encontrar los campos de rendimiento y fecha de capacitación y sus códigos.
  4. Ejecutar un análisis dinámico que compare el rendimiento antes y después de la fecha de capacitación.

Luego convierte el resultado en una respuesta: "En la base de datos de Medios de Vida de Malí, el 45% de los agricultores registraron un aumento del rendimiento de al menos el 20% en el año posterior a la capacitación. ¿Le gustaría que lo desglosara por distrito?"

Cada paso es una solicitud a ActivityInfo que usted mismo podría haber hecho. El valor es que el asistente elige los pasos, lee los resultados y corrige el rumbo cuando un formulario no contiene lo que esperaba.

Protocolo de Contexto de Modelo

El Protocolo de Contexto de Modelo (MCP) es un estándar abierto para conectar herramientas con asistentes. Un asistente de IA actúa como un cliente. Un sistema que contiene datos, como ActivityInfo, ejecuta un servidor que ofrece herramientas. El servidor describe sus herramientas a través de una conexión HTTPS, y el cliente las llama a través de la misma conexión.

El estándar es importante porque elimina la necesidad de una integración separada por asistente. ActivityInfo publica un único punto de conexión MCP, y cualquier asistente que hable MCP puede usarlo.

El punto de conexión de ActivityInfo es:

https://www.activityinfo.org/mcp

Utiliza el transporte HTTP Streamable, que es lo que esperan los asistentes actuales.

Qué puede hacer un asistente

Las herramientas se dividen en varios grupos. Dentro de los permisos del usuario que se conectó, un asistente puede:

  • Explorar una base de datos. Listar las bases de datos a las que puede acceder, las carpetas, formularios e informes en una base de datos, y los campos de un formulario, incluyendo subformularios.
  • Leer y analizar registros. Recuperar los registros de un formulario, o ejecutar un análisis dinámico que los agregue: una suma o un recuento, agrupados por categoría, por mes, o por un campo en un formulario relacionado.
  • Diseñar y cambiar formularios. Añadir un formulario, añadir campos, insertar un campo en una posición particular, cambiar la etiqueta, descripción, opciones o fórmula de un campo, y eliminar campos.
  • Ingresar y corregir datos. Añadir registros a un formulario, y editar registros existentes.
  • Construir informes. Crear un informe que contenga análisis dinámicos, leer un informe que ya existe y añadirle análisis. El asistente devuelve un enlace que usted puede abrir.
  • Traducir una base de datos. Listar los diccionarios de traducción, leer las cadenas traducibles para un idioma y guardar las traducciones para ellas.

Esto se adapta a algunas tareas mucho mejor que a otras. Los asistentes son buenos para revisar el diseño de un formulario en busca de lagunas e inconsistencias, para convertir un plan de monitoreo o un marco lógico en un primer borrador de un conjunto de formularios, para responder a una pregunta analítica que de otro modo requeriría varias tablas dinámicas manuales, y para redactar traducciones para una base de datos que debe ser recopilada en varios idiomas. Son más débiles en cualquier cosa donde el número exacto importa y no puede ser verificado, porque un asistente ocasionalmente elegirá el campo o la agregación incorrecta e informará el resultado con total confianza.

Pida a un asistente que muestre qué formularios y campos utilizó, y verifique que la cifra es la que esperaba.

Lo que no hace

  • No amplía el acceso de nadie. Un asistente actúa como el usuario que lo autorizó, y está sujeto al rol y a las concesiones de ese usuario. Consulte Entendiendo los permisos para los asistentes de IA.
  • No está activado por defecto. El Servidor MCP debe estar habilitado para cada base de datos. Consulte Habilitando el Servidor MCP para una base de datos.
  • No lee los datos adjuntos, y no lee datos de una base de datos cuya configuración de MCP esté desactivada, incluso si usted tiene acceso completo a esa base de datos.
  • No actúa por sí solo. Un asistente solo llama a una herramienta en respuesta a algo que usted le pide.

Recuperar registros y ejecutar análisis

El Servidor MCP de ActivityInfo proporciona herramientas tanto para recuperar datos brutos como para ejecutar análisis sobre los datos almacenados en ActivityInfo.

La recuperación de registros devuelve cada registro de un formulario. Ese es el enfoque correcto para un formulario con unos pocos cientos de registros, y para preguntas sobre registros individuales o texto libre. Para un formulario con decenas de miles de registros, llena la conversación y el asistente puede perder el hilo de la parte anterior.

Un análisis dinámico es calculado por ActivityInfo y devuelve solo el resultado agregado, como CSV. Se mantiene pequeño sea cual sea el tamaño del formulario, y es el enfoque correcto para totales, recuentos y desgloses. Si un asistente comienza a recuperar un formulario muy grande para responder a una pregunta sobre totales, pídale que ejecute un análisis dinámico en su lugar.

Antes de conectarse

Conectar un asistente envía datos de su base de datos a la empresa que gestiona el asistente. Para una base de datos que contiene datos personales, esa es una decisión que debe tomarse antes de que alguien se conecte, no después. Consulte Uso de asistentes de IA con datos sensibles.

Artículos relacionados

Siguiente elemento
Entender los permisos para los asistentes de IA