Saltar al contenido

Conexión nativa con IA En desarrollo

Habla con las IA. De forma nativa.

Un servidor MCP para que Claude, ChatGPT, Cursor, VS Code o tus propios agentes busquen, verifiquen y comparen actas sin que nadie escriba una línea de integración.

Una IA puede inventarse una respuesta. No una prueba.

O la huella cuadra, o no. Tus agentes citan hechos sellados, con su enlace de verificación, en vez de suponer.

Conectar

Añadir conector. Autorizar. Listo.

Servidor remoto en api.knowyourparcel.com/mcp, con transporte HTTP. Se autoriza con OAuth 2.1 y PKCE, con registro dinámico de clientes: es lo que esperan los asistentes cuando pulsas «añadir conector».

Tú eliges en el panel qué cuenta y qué permisos ve la IA, y lo revocas cuando quieras. Para agentes propios, también con clave de API en la cabecera.

{
  "mcpServers": {
    "kyp": {
      "type": "http",
      "url": "https://api.knowyourparcel.com/mcp"
    }
  }
}
{
  "mcpServers": {
    "kyp": {
      "command": "npx",
      "args": ["-y", "@knowyourparcel/mcp"],
      "env": { "KYP_API_KEY": "kyp_test_…", "KYP_ENV": "sandbox" }
    }
  }
}

También en local. El paquete @knowyourparcel/mcp corre en tu máquina, apuntando a producción, al entorno de test o a tu sandbox local.

Herramientas

Doce herramientas. Diez solo leen.

  • kyp_find_recordsBusca actas por pedido, tracking, cliente, estación o fecha.
  • kyp_get_recordDevuelve el acta: medidas, peso, imágenes por enlace temporal, etiqueta y sello.
  • kyp_verifyComprueba que un acta o un archivo sigue intacto.
  • kyp_compareEnfrenta dos actas, por ejemplo salida y retorno.
  • kyp_check_declarationCruza lo declarado con lo medido.
  • kyp_get_timelineEl pasaporte del paquete: cada mano, cada evento, cada acta.
  • kyp_get_riskPuntuación de riesgo con sus señales y la regla que las dispara.
  • kyp_transit_timesTiempos reales por transportista y ruta, con su muestra.
  • kyp_device_statusEstado de tus estaciones: en línea, calibración, incidencias.
  • kyp_usageConsumo del mes frente a lo incluido en tu licencia.
  • kyp_build_dossierArma el expediente de reclamación. Crea un documento; no toca las pruebas.escribe
  • kyp_create_journeyPublica la página de un paquete. Pide confirmación antes de hacerlo.escribe

Con la Bóveda y la Analítica llegan kyp_vault_manifest (solo el manifiesto, nunca los archivos) y kyp_journey_stats.

Recursos

  • kyp://records/{ref}

    El acta como JSON firmado, lista para citar.

  • kyp://docs/…

    Las guías de la documentación, para que el agente aprenda solo.

Prompts

  • Revisar una reclamación

  • Comparar salida y retorno

  • Resumen diario de dispositivos

Pruébalo con tus datos, desde el panel.

Un chat de ejemplo llama a las herramientas con tu cuenta para que veas qué respondería una IA antes de conectar la tuya.

Operador

El cliente dice que el pedido ORD-88213 llegó roto. ¿Cómo salió?

Know Your Parcel

kyp_find_records · reference: "ORD-88213" → 1 acta de salida

Know Your Parcel

kyp_verify · KYP-2026-000123 → intacta · captura atestada

Asistente

Salió el 16 de octubre a las 09:41 UTC: 32,0 × 24,5 × 18,0 cm y 2,340 kg, sin daños visibles en el embalaje en las dos imágenes. El acta está intacta. ¿Preparo el expediente para el transportista?

Operador

Sí, en inglés.

Know Your Parcel

kyp_build_dossier · claim: damage, lang: en, confirm: true → listo

Asistente

Expediente listo, con enlace de verificación pública. Lo adjunto a la reclamación.

Reglas

La IA ve lo justo. Y todo queda escrito.

  1. 01

    Solo lectura por defecto

    Las dos herramientas que escriben están desactivadas hasta que un administrador las activa.

  2. 02

    Confirmación al escribir

    Crear un expediente o publicar una página exige confirmación explícita en la llamada.

  3. 03

    Cada llamada, en el registro

    Con el nombre del asistente que la hizo. La ves en tu registro de API y en la auditoría de la cuenta.

  4. 04

    Solo tu cuenta

    Las herramientas devuelven datos de la cuenta autorizada y nada más. Imágenes por enlace temporal, nunca en bruto.

  5. 05

    Límites propios

    Un tope por minuto para agentes, aparte del de tu integración.

Documentación que leen las máquinas.

  • llms.txt y llms-full.txt

  • OpenAPI 3.1 listo para llamadas a funciones

  • Descripciones de herramientas con ejemplos y errores que explican qué hacer

  • Página «Para agentes» con la configuración lista para copiar

¿Quieres conectar tu agente de IA en el piloto?

Pedir acceso