MCP
Troubleshooting general
La mayoría de lo que ves acá no son bugs — son respuestas intencionales de los servidores (fail-closed por diseño). Buscá tu síntoma exacto.
MCP ops (remoto, HTTP)
| Lo que ves | Qué significa | Qué hacer |
|---|---|---|
401 / "unauthorized" |
Tu token no matchea ninguna lista/tabla configurada — mal copiado, vencido, o retirado. | Confirmá con Daniel que el token sigue activo y que lo copiaste completo (sin espacios, sin cortar opsmcp_). |
503 / "mcp-disabled" |
El servidor no tiene ningún token configurado en este ambiente — típico de producción antes de correr el runbook de activación. | Avisá a Daniel — no se resuelve del lado del cliente. |
[ops] scope 'read' cannot call ops_update — requires a write token |
Tu token es de solo lectura y pediste una tool de escritura. | Es esperado — pedí un token write si necesitás operar el board. |
status 'done' requires an admin token |
Un token write intentó cerrar como done un ítem raíz (sin parent_id). |
Dejalo en to_be_human_reviewed — Daniel lo promueve a done. Si el ítem SÍ tiene parent_id (subtask) y igual ves este error, es un bug — reportalo. |
405 en GET/DELETE manuales a /mcp |
El endpoint es stateless — no hay sesiones que resumir ni terminar. | Nada — no afecta el uso normal vía claude mcp add. |
Not Acceptable (al debuggear con curl) |
Falta el header Accept: application/json, text/event-stream — el SDK lo exige. |
Agregalo a tu curl junto con Content-Type: application/json. |
403 forbidden en /mcp/tokens o ops_token_* con "requiere un caller global-admin real" |
Llamaste una tool de administración de tokens sin ser global-admin real — ni un token admin de env-list ni un JWT humano común alcanzan. |
Pedile a un global-admin real que lo haga por vos. |
| Primera llamada muy lenta (~segundos) | Scale-to-zero del Container App — cold start esperado. | Nada, reintentá — las siguientes llamadas son rápidas. |
MCP dynamo-analytics (local, stdio)
| Lo que ves | Qué significa | Qué hacer |
|---|---|---|
Login falló: Invalid login credentials |
Email/password incorrectos, o tu usuario no tiene password (solo magic-link/OTP). | Usá el fallback OTP (DYNAMO_LOGIN_OTP=1) — ver MCP Analytics § 2. |
La sesión no está autenticada al llamar una tool |
El archivo de sesión no existe o los tokens son inválidos. | Repetí npm run login (paso 2 del manual). |
spec_version_conflict |
Optimistic locking: alguien escribió una versión nueva del spec después de que vos leíste la tuya. | Releé con get_dashboard_spec, tomá el spec_version nuevo, reintentá con ese base_version. |
invalid_spec |
El spec no pasó la validación de forma (ajv). | El mensaje trae el path exacto del campo que falló (ej. widgets[2].layout.w: ...) — corregilo ahí. |
"Already Used" al arrancar el server |
El refresh token en disco quedó desincronizado (versión vieja del MCP, o crash a mitad de escritura). | Repetí npm run login para generar una sesión nueva desde cero. |
Lista vacía [] en get_my_projects |
Tu usuario no tiene ningún proyecto con analytics habilitado — no es un error. | Probá con otro usuario o pedile a un admin que habilite analytics en un proyecto tuyo. |
| Métricas con hasta 24h de "drift" | El pipeline incremental recalcula 1x/día — esperado en distribution/avg/count/sum. |
Nada — la fila __presence__ ("Trabajadores en Mina Ahora") es la única que siempre es fresca (se computa on-the-fly). |
@dynamotechtvt/mcp-core (GitHub Packages)
| Lo que ves | Qué significa | Qué hacer |
|---|---|---|
403 en npm ci/npm install |
Tu repo no tiene grant Read sobre el package en la org Team DynamoTechTVT. |
Pedile a Daniel el grant Read en Package settings → Manage Actions access. Ver Para desarrolladores § 2. |
| Schemas de tools "raros"/instanceof roto | Doble instancia de zod (una del core, otra del consumidor) — zod-to-json-schema del SDK no reconoce shapes de otra copia. |
Verificá que tu package.json declara zod como dependencia directa alineada a la versión peer del core (^3.25.0), sin duplicarla. |
No encontrás tu problema acá
Si el error no está en esta lista, no lo inventes ni lo asumas: los manuales de cada MCP tienen la referencia técnica completa — MCP Ops, MCP Analytics — y en último caso, preguntale a Daniel.