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.
| Dominio | Repo | Nombre stdio | Tools |
|---|---|---|---|
| ops | ops-dynamo | ops | 8 + tokens |
| analytics | analytics-dynamo | dynamo-analytics | 23 + 2 PBIX |
| forms | forms-dynamo | dynamo-forms | 11 |
| auth | auth-dynamo | dynamo-auth | 11 |
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:
| Tool | Qué hace | Por 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
| Dominio | En stdio | En 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.