Conecta LinkContrata con tu asistente de IA (MCP)

Qué es

El Asistente IA (MCP) deja que tu asistente de inteligencia artificial —Claude Desktop, Claude Code, ChatGPT y otros compatibles con MCP— opere LinkContrata por ti, en lenguaje natural: “busca normas sobre plazos de apelación de la buena pro”, “lista mis oportunidades abiertas”, “promueve mi proyecto 12 al marketplace”.

Funciona a través de un conector estándar llamado MCP (Model Context Protocol) que se conecta a la API de LinkContrata con tu token personal. El asistente solo puede hacer lo que tú podrías hacer en la web: ve únicamente la información de tu empresa y respeta tu rol y tu plan. No hay acceso a datos de otras empresas.

Qué puedes pedirle

• Normativa: buscar resoluciones y normas de contratación pública (búsqueda con IA sobre el corpus regulatorio) y abrir el documento de origen.
• Marketplace: listar y ver oportunidades, revisar pujas y recomendaciones.
• Proyectos y procurement: consultar tus proyectos, paquetes y contratos.
• Acciones (con permiso de escritura): crear un proyecto, crear/publicar una oportunidad, promover un proyecto al marketplace en un paso, o enviar una puja.

Paso 1 · Genera tu token de API

El token es tu llave personal. En LinkContrata ve a Configuración → Tokens de API y pulsa “Generar token”:

1. Ponle un nombre que reconozcas (por ejemplo, “Claude en mi laptop”).
2. Elige el permiso:
   • Solo lectura — buscar, listar y ver. Recomendado para empezar.
   • Lectura y escritura — además permite crear proyectos, publicar oportunidades y pujar.
3. Copia el token (empieza con lct_) en ese momento: por seguridad se muestra una sola vez y no se vuelve a ver. Si lo pierdes, revócalo y genera otro.

Paso 2 · Conéctalo en tu asistente

Elige la opción según tu asistente. Las dos usan el conector público @linkcontrata/mcp y tu token; no necesitas instalar nada del código de LinkContrata.

Opción A — Claude Code (recomendada)

Instala el plugin oficial desde su marketplace público (no requiere acceso a ningún repositorio privado):

/plugin marketplace add jordybc1503/linkcontrata-plugin
/plugin install linkcontrata@linkcontrata

Claude Code te pedirá tu token y la URL (https://linkcontrata.lat) al instalar. El plugin añade además atajos y agentes listos para usar.

Opción B — Claude Desktop, ChatGPT u otro cliente MCP

Agrega este bloque a la configuración MCP de tu cliente y reemplaza el token por el tuyo. En Claude Desktop: Ajustes → Desarrollador → Editar configuración.

{
  "mcpServers": {
    "linkcontrata": {
      "command": "npx",
      "args": ["-y", "@linkcontrata/mcp"],
      "env": {
        "LINKCONTRATA_TOKEN": "lct_tu_token_aqui",
        "LINKCONTRATA_URL": "https://linkcontrata.lat"
      }
    }
  }
}

El conector @linkcontrata/mcp es público (se descarga solo con npx; requiere tener Node.js instalado). Reinicia el asistente después de guardar.

Paso 3 · Pídelo en lenguaje natural

Una vez conectado, escribe a tu asistente como le hablarías a un colega:

• “Busca normas sobre causales de nulidad de oficio en contrataciones.”
• “¿Qué oportunidades tengo abiertas en el marketplace?”
• “Crea un proyecto llamado ‘Mejoramiento vial Av. Central’.”
• “Promueve mi proyecto 12 al marketplace.”

El asistente te pedirá confirmación antes de cualquier acción que escriba o publique.

Seguridad

• El token viaja cifrado y en el servidor solo se guarda su huella (nunca el valor en texto plano).
• Cada llamada respeta el aislamiento por empresa y tus permisos de rol y plan, igual que la web.
• Un token de solo lectura no puede crear ni publicar nada, aunque se lo pidas.
• Puedes revocar un token cuando quieras desde Configuración → Tokens de API; deja de funcionar al instante.
• Usa un token distinto por dispositivo o integración para poder revocarlos por separado.

Notas

• Tanto el plugin como el conector son públicos y abiertos: no contienen el código de la plataforma, solo traducen tus instrucciones a llamadas a la API de LinkContrata con tu token.
• El conector usa el transporte local stdio: corre en tu equipo y se conecta de forma segura a LinkContrata. No expone tu información a terceros.