# Conectar tus fuentes

> Qué fuentes acepta Middleout, cómo se conecta cada una y qué acceso necesita.

Middleout **solo lee** tus fuentes: nunca modifica tus datos. Cada conexión pide el acceso de lectura mínimo que necesita.

Las fuentes se conectan desde la sección **Datos** de Middleout.

## Fuentes disponibles

| Fuente | Cómo se conecta | Personal o de la organización |
| --- | --- | --- |
| BigQuery | Das acceso de solo lectura a la cuenta de servicio de Middleout en tu proyecto de Google Cloud, o autorizas con tu cuenta de Google. | De la organización con cuenta de servicio; personal si autorizas con tu cuenta. |
| Google Sheets | Compartes la planilla con la cuenta de tu organización en Middleout, o autorizas con tu cuenta de Google. | Cualquiera de las dos. |
| Google Drive | Compartes la carpeta con la cuenta de tu organización en Middleout, o autorizas con tu cuenta de Google. | Cualquiera de las dos. |
| GitHub | Autorizas con tu cuenta de GitHub y eliges los repositorios. Middleout estudia su documentación y su estructura. | Personal. |
| Reuniones | Subes la grabación de audio (MP3, M4A, WAV, WebM u OGG, hasta 200 MB). | De la organización. |

## Fuentes personales y de la organización

- **Personal**: solo la ve y la consulta quien la conectó. Sirve para trabajar con datos propios sin compartirlos.
- **De la organización**: la pueden usar las personas con acceso, y también el trabajo que Middleout hace sin nadie presente (alertas, actualizaciones programadas, investigaciones que se refrescan solas). Ese trabajo nunca usa fuentes personales.

## BigQuery

Hay dos formas:

1. **Cuenta de servicio (recomendada para la organización).** En la consola de Google Cloud de tu proyecto, das a la cuenta de servicio de tu organización en Middleout roles de solo lectura. Middleout no guarda ninguna clave: el acceso se controla desde tu propio IAM y lo retiras cuando quieras.
2. **Tu cuenta de Google.** Autorizas en la pantalla de Google el permiso de solo lectura de BigQuery (`bigquery.readonly`). La fuente queda como personal.

Cada consulta tiene un límite de datos leídos que el propio BigQuery hace cumplir, para que una pregunta no se vuelva cara.

## Google Sheets y Drive

- **Para la organización**: comparte la planilla o la carpeta con la cuenta de tu organización en Middleout, como lo harías con una persona. No hay que autorizar nada más.
- **Personal**: autoriza con tu cuenta de Google el permiso de solo lectura de Drive (`drive.readonly`).

## GitHub

Autorizas con tu cuenta de GitHub y eliges los repositorios. Middleout lee su documentación (por ejemplo decisiones, procedimientos y archivos de instrucciones para agentes como `AGENTS.md` o `CLAUDE.md`) y su estructura, y se mantiene al día cuando hay cambios. No ejecuta código ni consulta el repositorio como una base de datos.

## Reuniones

Subes la grabación y Middleout la escucha y guarda lo que significa: los modelos mentales, las decisiones, los aprendizajes y las preguntas abiertas.

## Qué pasa después de conectar

Middleout estudia la fuente: lee sus tablas y columnas o sus documentos, usa las descripciones que ya existan y redacta las que falten. Puedes revisar y editar esas descripciones desde la ficha de cada tabla. Lo que comprende queda en la memoria y está disponible en el chat, en los artefactos y por MCP.