PunchLink PunchLink
Add-on PunchLink AI · 49 EUR / mes

Manual de uso : conecte su IA a PunchLink

Audite sus proyectos, cree reservas, envíe situaciones en lenguaje natural desde Claude, Cowork o GitHub Copilot. Sin instalación pesada, sin duplicación de datos.

Un conector, todos los asistentes IA

PunchLink AI se basa en el estándar MCP (Model Context Protocol), abierto y compatible con todos los principales asistentes IA profesionales.

Auditoría instantánea

"Dame una auditoría completa del proyecto REVAMP" — respuesta en 2 segundos con avance, reservas, pagos, HSE, DOE (Dossier de Trabajos Ejecutados / dossier de replanteo / as-built). Cada cifra trazable.

Acciones concretas

"Crea una reserva bloqueante en el lote tuberías : soldadura piquaje P-103 a rehacer" — ejecutada directamente. No necesitas abrir PunchLink.

Memorandos automáticos

"Síntesis para el COMEX semanal" — informe markdown estructurado con avance, alertas críticas, importes pendientes, en 5 segundos.

3 formas de conectar PunchLink AI

Elija el asistente IA que ya está utilizando.

Antes de comenzar : 2 pasos obligatorios

1

Activar su add-on PunchLink AI

En Configuración → PunchLink AI, haga clic en Suscribirse 49 EUR / mes. Pago Stripe seguro, cancelable en cualquier momento.

2

Generar su clave API

Una vez el add-on activo, en la misma sección, haga clic en + Nueva clave API. Déle un nombre (ej. "Claude Desktop personal").

La clave se muestra en la forma pl_live_XXXXXXXX.... Cópiela inmediatamente : nunca será mostrada de nuevo.

Conectar Claude Desktop

Método recomendado : el conector nativo (Claude Desktop 1.0+).

1
Abra Claude Desktop.
2
Haga clic en su avatar → Configuración → pestaña Conectores.
3
Haga clic en Añadir conector personalizado.
4
Rellene :
  • Nombre : PunchLink
  • URL : https://ztavpcgkjsomfngpuxle.supabase.co/functions/v1/mcp-punchlink
  • Autenticación : Token de Portador
  • Token : su clave pl_live_...
5
Haga clic en Conectar. Claude detecta automáticamente las 10 herramientas PunchLink.
6
En una conversación, pregunte : "Lista mis proyectos PunchLink".
Verificación : Si Claude le responde con la lista de sus proyectos (código, nombre, sector, presupuesto, contadores), la conexión está OK.

Conectar Cowork

Cowork es el modo "sin desarrollador" de Claude Desktop. Particularidad: la clave se pasa directamente en la URL.

1
Abra CoworkCustomize → pestaña Conectores.
2
Haga clic en + arriba a la derecha → Añadir un conector MCP personalizado.
3
Rellene:
  • Nombre: PunchLink
  • URL (con su clave al final):
https://ztavpcgkjsomfngpuxle.supabase.co/functions/v1/mcp-punchlink?key=SU_CLAVE
4
Haga clic en Guardar. Cowork detectará las 10 herramientas.
5
En una conversación, escriba: "Listar mis proyectos PunchLink".
Seguridad: Como la clave está en la URL, aparece en los registros. Esto sigue siendo aceptable porque la clave es revocable en cualquier momento, pero no la reutilice en otro lugar. Si cambia de PC, genere una nueva clave.

Conectar GitHub Copilot (VS Code)

Particularmente relevante en empresa: la mayoría de los DSI autorizan Copilot (Microsoft) para usos profesionales. PunchLink AI se conecta sin instalación adicional.

Método rápido: paleta de comandos

1
Abra VS Code.
2
Ctrl + Shift + P (Windows/Linux) o Cmd + Shift + P (Mac).
3
Escriba MCP: Add Server y seleccione.
4
Elija el tipo HTTP Server.
5
Rellene:
  • Server name: punchlink
  • URL: https://ztavpcgkjsomfngpuxle.supabase.co/functions/v1/mcp-punchlink
  • Headers: nombre Authorization, valor Bearer SU_CLAVE
6
Elija el alcance: User (todos los proyectos) o Workspace (esta carpeta).
7
Abra Copilot Chat → escriba @punchlink o en modo Agent: "Auditoría del proyecto REVAMP".

Método alternativo: archivo mcp.json

Si se siente cómodo, cree .vscode/mcp.json en la raíz de un proyecto:

{
  "servers": {
    "punchlink": {
      "type": "http",
      "url": "https://ztavpcgkjsomfngpuxle.supabase.co/functions/v1/mcp-punchlink",
      "headers": { "Authorization": "Bearer SU_CLAVE" }
    }
  }
}
Argumento empresarial: Como Copilot ya está aprobado por la mayoría de los DSI (política Microsoft 365), PunchLink AI se conecta sin validar una nueva pila de IA. Sus datos van de PunchLink → su VS Code → Copilot. Ninguna superficie de ataque adicional.

10 herramientas disponibles

PunchLink AI MVP v2 expone 10 herramientas MCP, clasificadas en 2 categorías: lectura (sin riesgo) y escritura (con verificaciones de derechos).

HerramientaDescripciónDerechos
list_projectsLista sus proyectos activos con KPICualquier rol
get_project_summaryAuditoría completa del proyecto (KPI, reservas, HSE, pagos)Miembro del proyecto
list_reservesLista reservas filtradas (criticidad/estado/lote)Miembro del proyecto
list_orders_with_paymentsVista financiera: pagado / pendiente / validadoMiembro del proyecto
search_doeBúsqueda en documentos DOEMiembro del proyecto
create_reserveCrear una reserva (menor/mayor/bloqueante)DO/AMO/CDP/Sup./OPC/HSE/Presta
submit_situationEnviar una situación en un pedidoProveedor del pedido
validate_situationValidar o rechazar una situaciónDO/AMO/CDP/Compras
create_demo_projectCrear un proyecto vacío para pruebaCualquier rol
invite_memberInvitar un miembro por correo electrónicoDO/AMO/CDP

Biblioteca de indicaciones útiles

Auditoría matutina

"Dame una auditoría completa del proyecto [NOMBRE] para mi reunión de las 9h"

Síntesis de dirección

"Síntesis de todos mis proyectos: avance, reservas bloqueantes, montos pendientes"

Riesgo de pago

"En el proyecto [NOMBRE], ¿qué pedidos tienen pagos pendientes desde hace más de 30 días?"

Creación de reserva

"Crear una reserva bloqueante en el lote [LOTE]: [descripción]"

Validación de situación

"¿La situación 4700030247 se ajusta al porcentaje de avance real?"

Detección de bloqueadores

"¿Qué reservas bloqueantes están abiertas desde hace más de 15 días en todos mis proyectos?"

Seguridad y mejores prácticas

Garantías técnicas ofrecidas por PunchLink AI.

Autenticación estricta

Cada llamada requiere una clave válida + complemento activo. Clave ausente → rechazo.

Hash bcrypt

Las claves se almacenan con hash. Ni siquiera L2V puede leerlas en texto plano.

Interruptor de emergencia global

L2V puede suspender instantáneamente todos los accesos MCP en caso de incidente.

RLS Postgres

Cada herramienta verifica que sea miembro del proyecto antes de devolver datos.

Registro de auditoría completo

Cada llamada se registra: quién, qué, cuándo, éxito / fracaso.

Datos nunca enviados a LLM

La IA solo solicita herramientas. Sus datos de PunchLink permanecen en PunchLink.

Si sospecha una fuga de clave

  1. Vaya a Configuración → PunchLink AI
  2. Encuentre la clave sospechosa en la lista
  3. Haga clic en Revocar
  4. Genere una nueva clave y reconfigure su cliente de IA

Solución rápida de problemas

ErrorCausaSolución
NO_API_KEYClave no transmitidaVerificar header Authorization o ?key= en URL
KEY_INVALIDClave incorrecta o truncadaRegenerar + copiar completamente
KEY_NOT_FOUND_OR_REVOKEDClave revocadaGenerar nueva clave
USER_SUBSCRIPTION_INACTIVEComplemento canceladoSuscribirse / reactivar en Configuración
MCP_DISABLED_GLOBALLYMantenimiento L2VReintentar en 10 min, sino contact@punchlink.app
Project not accessibleNo es miembro del proyectoSolicitar acceso al DO

¿Listo para pilotar PunchLink en lenguaje natural?

Active PunchLink AI en 30 segundos — cancelable en cualquier momento, sin compromiso.

Activar en mi cuenta Descargar la guía PDF

¿Una pregunta? contact@punchlink.app

PunchLink AI complemento MCP: conexión Claude Desktop, ChatGPT, Cursor, Cline, Continue, Cowork, GitHub Copilot — 49 €/mes

PunchLink AI — asistente IA nativo

Pilotar sus proyectos en lenguaje natural desde Claude Desktop, ChatGPT, Cursor o Copilot. 10 herramientas BDD expuestas en MCP: auditoría de proyecto, creación de reservas, envío de situaciones, validación, búsqueda DOE, invitación de miembros. Complemento 49 €/mes, desactivable por proyecto para clientes sensibles.

Carpeta Única IA PunchLink con análisis automático multi-formato: PDF, DOCX, XLSX, PPTX, DWG, DXF, IFC, imágenes, ZIP — patente en trámite

Depósito único IA — método patentado

Arrastra y suelta un documento — cualquiera: PDF, Word, Excel, PowerPoint, plano DWG/DXF, modelo BIM IFC, ZIP de obra. La IA analiza, clasifica, encamina al módulo correcto con puntuación de confianza. Método patentado L2V SASU, patente en trámite en el INPI.