innovas-workspace-mcp

Servidor MCP remoto multi-tenant para Google Workspace y el company brain en Drive.

Un tenant es una empresa. Agregar un cliente es agregar una entrada en tenants.json, no tocar el codigo.

Que expone

Tools semanticas del brain, que son el diferencial. El servidor habla el idioma del brain, no el de Google:

Primitivas de Google: drive_search, drive_read, gmail_search, gmail_draft, calendar_events.

Regla de diseno: si un paso puede fallar por olvido del modelo, va en el servidor. Que index.md y log.md queden al dia es un efecto de brain_upsert, no una instruccion.

Related MCP server: Google Workspace MCP Server

Modelo de auth

Dos ejes independientes.

Como se autentica quien llama (AUTH_MODE):

• apikey: header x-api-key. La key se guarda hasheada en sha256 y mapea a un email. Suficiente para un piloto.

• google: bearer token de Google. El dominio del email resuelve el tenant. Un usuario de otro dominio no resuelve a este tenant, y eso no depende de ninguna configuracion.

• both: acepta los dos.

Como el servidor llama a Google (auth.mode por tenant):

• user_token: usa el token del propio usuario. Privilegio minimo, sin admin del Workspace del cliente. No sirve desatendido.

• service_account: credenciales propias. Con impersonate: false alcanza para Drive si la service account es miembro del shared drive. Con impersonate: true usa domain-wide delegation, que hace falta para Gmail y Calendar y es la unica via de correr sin usuario presente.

La allow list allowedSubjects es dura: vacia es igual a nadie.

Setup local

cp .env.example .env
cp tenants.example.json tenants.json   # completar ids de drives y hashes de api key
npm install
npm run dev

Generar el hash de una api key:

node -e "console.log(require('crypto').createHash('sha256').update('LA_API_KEY').digest('hex'))"

Obtener el id de un shared drive: esta en la URL, drive.google.com/drive/folders/<ID>.

Deploy

Railway con NIXPACKS, ver railway.json. Variables minimas: MCP_SERVER_URL, TENANTS_JSON o TENANTS_FILE, la variable de credenciales de cada tenant, AUTH_MODE y MCP_ALLOW_WRITES.

El endpoint MCP es POST /mcp. Health en /.well-known/health.

Decisiones que no se re-discuten

• Transporte sin estado, una instancia de servidor por request. Cuesta milisegundos y elimina la fuga de contexto entre tenants.

• MCP_ALLOW_WRITES arranca apagado. Un despliegue nuevo no escribe hasta que alguien lo decida.

• gmail_draft crea borradores y no envia. El envio queda en manos de la persona.

• El JSON de las service accounts nunca vive en tenants.json: ahi va el nombre de la variable de entorno.