Saltar al contenido
Shalom APIConectar con IA
Conectar con IA

Opera Shalom hablando con tu asistente

Shalom API trae un servidor MCP (Model Context Protocol): Claude, ChatGPT, Cursor y otros asistentes pueden cotizar, buscar agencias, registrar guías y rastrear envíos con tu llave. Pídele, por ejemplo: «cotiza un paquete S de Lima a Arequipa y regístralo para el DNI 11111111».

POSTDirección del servidor MCP
https://shalom.smartflow.pe/mcp

Autenticación: tu misma llave sk_… del panel, en la cabecera x-api-key o Authorization: Bearer sk_…. Transporte Streamable HTTP sin sesión.

Claude Code

Un comando en tu terminal. Luego escribe /mcp en Claude Code para ver que shalom quedó conectado.

Terminal
claude mcp add --transport http shalom https://shalom.smartflow.pe/mcp \
  --header "x-api-key: sk_tu_llave"

Claude (claude.ai y app de escritorio)

En Configuración ▸ Conectores ▸ Agregar conector personalizado, pon un nombre (Shalom) y la dirección con tu llave al final. Ese formulario no deja poner cabeceras, por eso la llave va en la dirección.

La dirección con llave da acceso a tu cuenta: no la compartas. Si se filtra, rota la llave en el panel.

URL del conector
https://shalom.smartflow.pe/mcp/sk_tu_llave

ChatGPT

  1. Activa Configuración ▸ Apps y conectores ▸ Avanzado ▸ Modo desarrollador (planes que lo permiten).
  2. En Apps y conectores elige Crear, pon el nombre Shalom y la dirección con tu llave.
  3. Autenticación: sin autenticación (la llave ya va en la dirección).
  4. En un chat nuevo, activa el conector desde el botón +.
URL del servidor MCP
https://shalom.smartflow.pe/mcp/sk_tu_llave

Cursor, VS Code y otros clientes

Cursor: ~/.cursor/mcp.json (o .cursor/mcp.json en tu proyecto). VS Code: .vscode/mcp.json con la misma forma bajo "servers" y "type": "http". Cualquier cliente que hable MCP por HTTP sirve con la dirección y la cabecera.

mcp.json
{
  "mcpServers": {
    "shalom": {
      "url": "https://shalom.smartflow.pe/mcp",
      "headers": { "x-api-key": "sk_tu_llave" }
    }
  }
}

Herramientas que ve tu asistente

Cada una llama a la misma ruta de la API, con el mismo límite por minuto y el mismo registro de consumo. Si no indicas cuenta_id, se usa tu primera cuenta Shalom conectada.

HerramientaQué haceRuta
ver_cuentaTu plan, consumo de hoy y del mes, y tus cuentas Shalom.GET /v1/yo
ver_perfilRemitente de la cuenta y estado del cobro seguro.GET /v1/perfil
buscar_agenciasPor texto, departamento, provincia, distrito o cercanía.GET /v1/agencias
cotizarPrecio entre dos agencias, por tamaño o medidas.POST /v1/cotizar
registrar_guiaCrea una guía real. Exige confirmado: true: el asistente debe mostrarte los datos y el precio y esperar tu «sí».POST /v1/guias
rastrearEstado y movimientos de una guía.GET /v1/rastreo/{guia}
consultar_dniNombres y apellidos de un DNI.GET /v1/dni/{numero}
listar_guiasTus guías con filtros de estado y fecha.GET /v1/guias
anular_pendienteAnula una guía aún no entregada en agencia. También exige confirmado: true.DELETE /v1/pendientes/{id}

Para que el asistente lea toda la API sin abrir el visor: llms.txt (índice) y llms-full.txt (rutas, campos y ejemplos). Prefieres código: inicio rápido.