Solución de problemas
Los problemas se dividen en dos: los que impiden conectar, y los que aparecen al operar con la conexión ya establecida. Empieza por la sección que corresponda.
No logro conectar
Tu cliente no soporta lo que el servidor exige
Es la causa más frecuente. El servidor solo acepta conexiones remotas por HTTP con OAuth 2.1, registro dinámico y PKCE con método S256. Un cliente que no implemente las tres cosas no puede conectarse, y el mensaje de error rara vez lo dice con claridad: suele fallar en silencio o quedarse esperando.
Los clientes verificados están en Conectarse al MCP Server. Si usas otro, esa página lista los requisitos para comprobar si te sirve.
Tu cliente está desactualizado
El soporte de MCP es reciente y cambia rápido de versión en versión. Antes de dar por imposible la conexión, actualiza tu cliente a la última versión disponible y vuelve a intentar. Muchos problemas de autorización se resuelven solo con esto.
No sabes si el problema es tuyo o del servidor
Esta consulta no necesita credenciales y responde siempre que el servidor esté disponible:
Si devuelve un JSON con los datos del servidor, está operativo y el problema está en tu cliente o en tu red. Si no responde o devuelve un error, el servidor no está disponible desde donde estás: prueba desde otra red antes de escalarlo.
Tu usuario todavía no puede operar
Conectarse requiere ser usuario de Global66 B2B con la verificación de tu empresa completa. Si la verificación está pendiente, la autorización se rechaza antes de llegar a la pantalla de consentimiento. Eso no se resuelve desde el cliente: lo resuelve tu empresa con Global66.
La conexión funcionaba y dejó de funcionar
Sesión revocada
Global66 puede revocar una sesión autorizada, por decisión del usuario o de la empresa. El cliente lo detecta en la siguiente llamada y deja de responder. Vuelve a Conectarse al MCP Server y completa de nuevo la autorización.
Token vencido
El remedio es el mismo: repetir la autorización. No hace falta borrar nada ni volver a configurar el cliente.
Veo menos tools de las que esperaba
No es un error. El servidor expone en cada sesión solo las tools que se autorizaron en la pantalla de consentimiento, cruzadas con lo que el nivel de tu usuario permite. Es normal ver menos de las siete disponibles.
Si esperabas una tool que no aparece, revisa qué permisos concediste al conectar. El catálogo completo está en Tools disponibles.
Errores al operar
Los errores de create_transaction llegan con un reason y sin texto explicativo: el detalle está en las tablas siguientes. Úsalas para saber si el error se corrige reintentando con otros datos, si hay que pedirle algo a la persona, o si no hay nada que hacer desde la conversación.
Errores de lo que enviaste
| reason | Qué pasó | Qué hacer |
|---|---|---|
REQUEST_PARAMETER_MISSING | Global66 recibió la operación sin un dato que necesita para resolver el destino | Revisa el inputSchema de la tool antes de reintentar: TRANSFER y P2P necesitan beneficiaryId, P2P además currencyCode, y CONVERSION necesita destinyAccountId |
REQUEST_PARAMETER_NOT_VALID | Enviaste un propósito sin monto, con monto cero o con el mismo purposeId repetido | Corrige para que cada propósito lleve su monto en USD y ningún purposeId se repita |
Errores del beneficiario o de las cuentas
| reason | Qué pasó | Qué hacer |
|---|---|---|
NOT_FOUND | El beneficiaryId no existe para esta empresa | Lista los contactos con list_beneficiaries y elige uno de esa lista, no inventes el id |
BENEFICIARY_NOT_ENABLED | El contacto existe pero no es cliente de Global66, así que no puede recibir un P2P | Avísale a la persona que a ese contacto hay que enviarle con TRANSFER, no con P2P |
ACCOUNT_NOT_FOUND | El contacto es cliente de Global66 pero no tiene billetera en la moneda que pediste | Consulta en qué monedas puede recibir y propone una de esas, o sugiere enviar con TRANSFER |
CUSTOMER_NOT_ENABLED | La empresa o el usuario no tienen la verificación aprobada para operar | No se resuelve desde la conversación: la empresa tiene que completar su verificación con Global66 |
Errores de los propósitos cambiarios
| reason | Qué pasó | Qué hacer |
|---|---|---|
PURPOSES_AMOUNT_EXCEEDS_OPERATION_TOTAL | La suma de los amountUsd que declaraste supera el monto de la operación en dólares | Ajusta los montos para que sumen como máximo el receiveAmountUsd que devolvió create_quote. Declarar menos si está permitido; declarar más, no |
Errores de la cotización
| reason | Qué pasó | Qué hacer |
|---|---|---|
QUOTE_NOT_AVAILABLE | Global66 no pudo cotizar ese par de monedas por ese monto | Prueba con otro monto antes de darlo por imposible |
ROUTE_NOT_FOUND | No hay ruta habilitada entre esas monedas y ese país | Verifica la moneda de origen con get_my_accounts y la de destino con list_beneficiaries; si son correctas, esa combinación no está habilitada hoy |
Errores del servicio
| reason | Qué pasó | Qué hacer |
|---|---|---|
HTTP_COMMUNICATION_FAILURE | No se pudo alcanzar el servicio de Global66 | Es transitorio: reintenta una vez. Si vuelve a fallar, avisa que el servicio no responde |
SERVICE_UNAVAILABLE | Global66 respondió con un error al crear la operación | No reintentes en bucle. Avisa que la operación no se pudo registrar |
INVALID_DATA_IN_SERVICE | Global66 respondió sin el identificador de la operación | No des la operación por creada. Avisa que no se pudo confirmar |
Si el reason no aparece en ninguna de estas tablas, es un rechazo de negocio de Global66 y no una falla del servicio: no reintentes, cuéntale a la persona el reason tal cual y avísale que la operación no quedó registrada.
Soporte
Si el problema persiste, escríbenos a soporte.tech@global66.com indicando el reason recibido, o la tool y el momento en que ocurrió si es un problema de conexión.