Business Assistant MCP

Servidor MCP remoto, multiempresa y stateless para un asistente conversacional de negocios.

Responsabilidad

El MCP no contiene el LLM. Su función es:

• Resolver el negocio correcto desde un widget público o una sesión administrativa.

• Buscar conocimiento activo sin mezclar tenants.

• Preparar altas, ediciones, borrados lógicos y restauraciones.

• Exigir confirmación humana antes de persistir cambios.

• Aplicar guardrails determinísticos.

• Validar JWT, membresía y rol.

• Mantener auditoría.

El agente se encarga de interpretar lenguaje natural y redactar. Supabase persiste y protege los datos.

Related MCP server: MCP Help Article Server

Stack

• Node.js 22+

• TypeScript

• @modelcontextprotocol/sdk v1.x

• Streamable HTTP stateless con respuesta JSON

• Express para desarrollo local

• Supabase PostgreSQL + Auth + RLS

• Zod 4

• Vercel Functions

Inicio local

cp .env.example .env
npm install
npm run typecheck
npm test
npm run dev

Endpoints:

GET  http://localhost:3001/health
POST http://localhost:3001/mcp

Aplicar base de datos

npm install -g supabase
supabase login
supabase link --project-ref TU_PROJECT_REF
supabase db push

La migración principal está en:

supabase/migrations/202607100001_business_assistant_mcp.sql

Inspector MCP

Con el servidor local ejecutándose:

npm run inspect

Configurar estos headers en el Inspector:

X-Internal-Service-Key: valor de MCP_INTERNAL_SERVICE_KEY
X-Widget-Key: UUID público del widget
X-Client-Origin: http://localhost:3000

Para herramientas administrativas, agregar además:

Authorization: Bearer <SUPABASE_ACCESS_TOKEN_DEL_USUARIO>

Seguridad

• MCP_INTERNAL_SERVICE_KEY solo lo conocen la API del agente y el MCP.

• SUPABASE_SECRET_KEY solo existe en el MCP y Vercel.

• El navegador nunca llama directamente al MCP.

• Las contraseñas se envían desde el formulario a Supabase Auth, no al agente ni al MCP.

• Las herramientas administrativas requieren JWT válido y rol suficiente.

• Toda búsqueda filtra por business_id dentro de PostgreSQL.

• El borrado es lógico.

• El commit es transaccional mediante RPC.

GitHub: crear y subir a nucky1

Desde la raíz del proyecto:

git init
git add .
git commit -m "feat: initialize multi-tenant business assistant MCP"
git branch -M main

Con GitHub CLI autenticada:

gh auth login
gh repo create nucky1/business-assistant-mcp \
  --public \
  --source=. \
  --remote=origin \
  --push

Si el repositorio ya existe:

git remote add origin https://github.com/nucky1/business-assistant-mcp.git
git push -u origin main

Documentación

• Contrato MCP

• Implementación y decisiones