Ir al contenido
SShalom API

Conectar Claude o ChatGPT

Conecta tu cuenta de Shalom API a Claude o ChatGPT con OAuth y opera tus envíos desde el chat.

Shalom API tiene un conector MCP remoto. Al conectarlo, Claude o ChatGPT pueden rastrear tus guías, buscar agencias, cotizar, crear guías en tu cuenta de Shalom Pro y más, siempre con el permiso que elijas. Usa los mismos datos y la misma cuota que la API.

  • URL del conector: https://api.shalom-api.lat/mcp
  • Autenticación: OAuth. Al conectar se abre Shalom API para que inicies sesión y autorices el acceso. No necesitas copiar ninguna API key.

Conectar en un minuto

Abre el Conector en el panel

Entra a shalom-api.lat/dashboard/conector y pulsa Conectar en Claude o en ChatGPT.

Pega el mensaje en tu asistente

Copia el mensaje que te muestra el panel y pégalo en un chat nuevo. El asistente te guía para agregar el conector personalizado.

Autoriza el acceso

Se abre la pantalla de permiso de Shalom API. Elige el nivel de acceso y pulsa Autorizar.

Hacerlo a mano

En Claude, ve a Configuración → Conectores → Agregar conector personalizado, ponle de nombre Shalom y usa la URL https://api.shalom-api.lat/mcp. Después pulsa Conectar y autoriza.

Permisos

Al autorizar eliges uno de dos niveles. Puedes cambiarlo desconectando y volviendo a conectar.

NivelQué permite
Lectura y gestiónConsultar todo y además crear, anular y cambiar cosas (guías, autogestiones, instancias, API keys, webhooks).
Solo lecturaConsultar todo, sin cambiar nada.

Acciones que cuestan o no se pueden deshacer

Crear guías (una o en lote), anular un envío pendiente, confirmar una autogestión y eliminar el webhook piden tu confirmación antes de ejecutarse: el asistente te muestra un resumen y espera tu respuesta.

  • Cada herramienta consume cuota igual que su endpoint de la API (ver la Referencia de la API). Las que no consumen cuota lo dicen en su descripción.
  • Si tu plan venció, no puedes hacer cambios y solo funcionan las consultas que no consumen cuota (tus instancias y su estado, API keys, webhook y guías vigiladas, tipos de contenido, historial de autogestiones, ubigeo de reparto, plan y consumo).
  • Si no indicas la instancia, se usa la primera con la sesión iniciada; para iniciar sesión, la primera que no la tiene.
  • Puedes ver y desconectar tus asistentes en el panel, en Conector.

Qué puede hacer

ÁreaHerramientas
SeguimientoRastrear una guía o hasta 50, buscar una orden por ose_id, ticket oficial (PDF o imagen) y rótulo en PDF
AgenciasListar, buscar, las más cercanas a un punto, departamentos, provincias y distritos
Antes de enviarCotizar, tipos de contenido, consultar un DNI, buscar un destinatario guardado en tu cuenta
InstanciasVer tus instancias y su estado, crear una instancia e iniciar sesión en Shalom Pro
Tu cuenta Shalom ProEnvíos pendientes, en tránsito e historial, comprobantes, perfil del remitente, historial de autogestiones y ubigeo de reparto
Gestión de envíosCrear guías (una o hasta 100 en lote), anular un envío pendiente, cambiar la clave de recojo, iniciar y confirmar autogestiones
API keysVer tus API keys (sin la key completa) y crear una nueva
WebhooksVer, configurar o eliminar el webhook, ver sus entregas, vigilar una guía y dejar de vigilarla
CuentaPlan, vencimiento y consumo del mes

Tu contraseña de Shalom Pro

Para iniciar sesión en una instancia desde el chat le das tu usuario y contraseña de Shalom Pro al asistente, así que quedan en esa conversación. Shalom API no la devuelve ni la guarda en sus registros. Si lo prefieres, inicia sesión desde el panel en Instancias.

No puede: borrar instancias, cerrar la sesión de Shalom Pro, borrar API keys, cambiar contraseñas, pagar o cambiar tu plan, ni nada de administración.