MCP
DynamoMCP · desarrolladores

Correrlos en tu máquina (stdio)

Esta página es para quien desarrolla los MCP de Dynamo, no para usarlos. Si solo querés que Claude acceda a los datos de Dynamo, no sigas nada de acá: andá a la página de conexión, que es una URL y un login.

Hay exactamente dos razones para correr un MCP en local: (1) estás desarrollando o depurando el MCP en sí, y (2) necesitás las dos tools de migración PBIX, que no existen en el servidor remoto porque dependen de tu disco.

Los cuatro paquetes

Cada MCP vive con su dominio; el mcp/ de cada repo es el servidor stdio.

DominioRepoNombre stdioTools
opsops-dynamoops8 + tokens
analyticsanalytics-dynamodynamo-analytics23 + 2 PBIX
formsforms-dynamodynamo-forms11
authauth-dynamodynamo-auth11

Puesta en marcha, con analytics de ejemplo

Los cuatro se montan igual: compilar, generar la sesión, registrar el binario. Desde la raíz del repo clonado:

cd mcp
npm install
npm run build
npm run login

npm run build tiene que dejar mcp/dist/server.js. npm run login abre el login de Dynamo y guarda la sesión en ~/.dynamo/ — el server la lee de ahí, así que no se le pasan tokens por variable de entorno.

Registrarlo en Claude Code (ruta absoluta):

claude mcp add dynamo-analytics \
  --env ANALYTICS_GATEWAY_URL=<gateway del ambiente> \
  -- node /RUTA/ABSOLUTA/A/analytics-dynamo/mcp/dist/server.js

La identidad ya no viaja por variable de entorno: la pone npm run login (Entra) en ~/.dynamo/, y el server la lee de ahí. Lo único que sigue entrando por --env es la URL del backend de datos del dominio — el nombre exacto de esa variable (ANALYTICS_GATEWAY_URL, PG_GATEWAY_URL, …) y su valor por ambiente cambian de dominio a dominio: están en el README y el .env.example de cada repo, no se copian acá para que no queden desactualizados. Para Claude Desktop, el equivalente es el mismo bloque en claude_desktop_config.json.

El dist/ se pudre. Si cambiaste de rama o hiciste git pull, corré npm run build otra vez y reiniciá el cliente: el síntoma clásico es una tool que "existe pero no hace lo que dice".

Las dos tools que solo existen acá

La migración de un dashboard de Power BI empieza en tu disco, así que estas dos no se exponen en el servidor remoto:

ToolQué hacePor qué es local
pbix_extract Descomprime un .pbix a ~/.dynamo/pbix-work/ y extrae su estructura PBIR. Recibe una ruta absoluta de tu disco. En un container esa ruta no existe — y un .pbix de cliente tiene datos de cliente.
pbix_propose_spec Propone un dashboard_spec y escribe report.md + proposed_spec.json para que los leas. Escribe artefactos que un humano abre en su checkout. En un servidor stateless quedan huérfanos.

El flujo completo es mixto: extraer y proponer en local, revisar el report.md a mano, y aplicar desde cualquier cliente con analytics_set_dashboard_spec, que sí está en el servidor remoto.

Nombres de tools: local vs. remoto

DominioEn stdioEn el servidor remoto
analytics list_dashboards, get_field_config, … (sin prefijo) analytics_list_dashboards, analytics_get_field_config, …
ops / forms / auth Mismos nombres en los dos lados.

En stdio los nombres viejos de analytics siguen registrados como alias deprecados (su descripción empieza con [DEPRECADO — usar analytics_X]) durante un sprint. Escribí los nuevos.

Los *_session_status de cada dominio también siguen vivos en stdio. En el servidor remoto los reemplaza uno solo, dynamo_session_status.

El contrato compartido

Los cuatro MCP y el gateway comparten @dynamotechtvt/mcp-core (GitHub Packages, scope @dynamotechtvt): identidad, transporte HTTP, errores, caps y sesión. Si vas a construir un MCP de dominio nuevo, empezá por ahí en vez de copiar código de otro repo.

403 al instalar el paquete. El scope es de una org Team: cada repo consumidor necesita el grant de lectura en Package settings, o el npm ci falla con 403. No es tu token.

El servidor remoto sigue existiendo si esto falla

Y al revés: stdio es el plan B real si el servidor remoto se cae. Los cuatro paquetes se siguen publicando y corriendo localmente — no es un camino muerto, es el modo de desarrollo.