Claude Code
Un comando en tu terminal. Luego escribe /mcp en Claude Code para ver que shalom quedó conectado.
claude mcp add --transport http shalom https://shalom.smartflow.pe/mcp \
--header "x-api-key: sk_tu_llave"
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».
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.
Un comando en tu terminal. Luego escribe /mcp en Claude Code para ver que shalom quedó conectado.
claude mcp add --transport http shalom https://shalom.smartflow.pe/mcp \
--header "x-api-key: sk_tu_llave"
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.
https://shalom.smartflow.pe/mcp/sk_tu_llave
https://shalom.smartflow.pe/mcp/sk_tu_llave
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.
{
"mcpServers": {
"shalom": {
"url": "https://shalom.smartflow.pe/mcp",
"headers": { "x-api-key": "sk_tu_llave" }
}
}
}
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.
| Herramienta | Qué hace | Ruta |
|---|---|---|
ver_cuenta | Tu plan, consumo de hoy y del mes, y tus cuentas Shalom. | GET /v1/yo |
ver_perfil | Remitente de la cuenta y estado del cobro seguro. | GET /v1/perfil |
buscar_agencias | Por texto, departamento, provincia, distrito o cercanía. | GET /v1/agencias |
cotizar | Precio entre dos agencias, por tamaño o medidas. | POST /v1/cotizar |
registrar_guia | Crea una guía real. Exige confirmado: true: el asistente debe mostrarte los datos y el precio y esperar tu «sí». | POST /v1/guias |
rastrear | Estado y movimientos de una guía. | GET /v1/rastreo/{guia} |
consultar_dni | Nombres y apellidos de un DNI. | GET /v1/dni/{numero} |
listar_guias | Tus guías con filtros de estado y fecha. | GET /v1/guias |
anular_pendiente | Anula 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.