PunchLink by IndustriaLink Solicitar una demo
Conector MCP · incluido en todas las ofertas

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.

El conector MCP está incluido en todas las ofertas PunchLink. Sin suplemento, sin casilla que marcar, sin suscripción aparte: está disponible en cuanto su cuenta está activa. Solo necesita una clave API — o una conexión OAuth con un clic. En otros productos este tipo de conector suele facturarse aparte.

¿Qué es un MCP?

Si nunca ha oído estas siglas, esta sección basta.

Una toma normalizada entre su asistente de IA y PunchLink

MCP significa Model Context Protocol. Es una toma estándar, como un enchufe: de un lado su asistente de IA (Claude, Cowork, GitHub Copilot), del otro PunchLink. Cualquier asistente que respete el estándar se conecta — sin desarrollo específico, sin pasarela a medida, sin exportar sus datos a otro sitio.

Sin MCP su asistente no sabe nada de su proyecto: hay que copiar y pegar extractos de hojas de cálculo o de PDF. Con MCP consulta directamente PunchLink, con sus permisos y nada más. Cada llamada queda registrada.

Lo que cambia en una obra

El asistente solo pide herramientas a PunchLink. Sus datos permanecen en PunchLink: no se utilizan para entrenar ningún modelo.

Un conector, todos los asistentes IA

El conector MCP PunchLink 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

Elija el asistente IA que ya está utilizando.

Antes de comenzar: un solo paso

1

Generar su clave API

El conector MCP ya está disponible en su cuenta: no hay nada que activar. En Configuración → Conector MCP, 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.

Con Claude Desktop y Cowork, la conexión OAuth con un clic evita incluso la clave.

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://www.punchlink.app/mcp
  • Authentication: OAuth — deje vacíos los campos Client ID / Secret. Al hacer clic en Connect se abre la página de acceso de PunchLink: identifíquese con su cuenta.
5
Haga clic en Conectar. Claude detecta automáticamente las 11 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 "no desarrollador" de Claude. La misma dirección que en todas partes, con acceso OAuth: ninguna clave que manejar.

1
Abra Cowork → Personalizar → pestaña Conectores.
2
Haga clic en + arriba a la derecha → Añadir conector MCP personalizado.
3
Rellene: Nombre PunchLink · URL https://www.punchlink.app/mcp — sin clave, campos avanzados vacíos.
4
Guarde y haga clic en Conectar: se abre la página de acceso de PunchLink — identifíquese con su cuenta PunchLink.
5
Cowork detecta las 11 herramientas. En una conversación, escriba: "Lista mis proyectos PunchLink".
Seguridad: ninguna clave circula. Su asistente recibe un token revocable, limitado a sus proyectos — y el servidor rechaza cualquier clave colocada en una URL.

Conectar GitHub Copilot (VS Code)

Particularmente relevante en empresa: la mayoría de los DSI autorizan Copilot (Microsoft) para usos profesionales. El conector MCP 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://www.punchlink.app/mcp
  • 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://www.punchlink.app/mcp",
      "headers": { "Authorization": "Bearer SU_CLAVE" }
    }
  }
}
Argumento empresarial: Como Copilot ya está aprobado por la mayoría de los DSI (política Microsoft 365), el conector MCP se conecta sin validar una nueva pila de IA. Sus datos van de PunchLink → su VS Code → Copilot. Ninguna superficie de ataque adicional.

11 herramientas disponibles

El conector MCP PunchLink expone 11 herramientas, 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 del conector MCP.

Autenticación estricta

Cada llamada requiere una clave válida o una sesión OAuth activa. 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 → Conector MCP
  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 transmitidaCompruebe el encabezado Authorization (Bearer pl_live_...) — o repita el acceso OAuth. Las claves en la URL se rechazan.
KEY_INVALIDClave incorrecta o truncadaRegenerar + copiar completamente
KEY_NOT_FOUND_OR_REVOKEDClave revocadaGenerar nueva clave
USER_SUBSCRIPTION_INACTIVECuenta PunchLink sin oferta activaVerificar el estado de la cuenta con su administrador
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?

El conector MCP está incluido en su oferta. Genere su clave API y conecte su asistente en 3 minutos.

Generar mi clave API Descargar la guía PDF

¿Una pregunta? contact@punchlink.app · +33 9 72 10 52 94

Conector MCP PunchLink: conexión Claude Desktop, ChatGPT, Cursor, Cline, Continue, Cowork, GitHub Copilot

Conector MCP PunchLink

Pilotar sus proyectos en lenguaje natural desde Claude Desktop, ChatGPT, Cursor o Copilot. 11 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. Incluido en todas las ofertas, 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.