Conectar un sistema que no pide clave

Crea la conexión de un sistema público que no pide credenciales (hoy Mercado Público) para una empresa, y devuelve su connectionId.


Tool ID	`conexiones.conexion.crear`
Nombre MCP	`conexiones__conexion__crear`
Conector	`conexiones`
Plano	`action`
Scope (permiso)	`conexiones:write`
Auth	`none`
Versión	`1`
Sensible	sí
Deprecado	no
Comportamiento	readOnly=false, destructive=false, idempotent=true, openWorld=false

Qué hace

La conexión se cobra como cualquier otra del plan de la organización: créala sólo si la persona quiere usar ese sistema. Si esa empresa ya tiene una conexión activa con el sistema, devuelve la misma y no crea otra. Para los sistemas que piden clave usa conexiones.enlace.crear.

Entrada

Campo	Tipo	Requerido	Descripción
`sistema`	string	sí	Código del sistema, tal como lo devuelve conexiones.sistemas.listar. Sólo sirve para sistemas sin clave.
`empresaRut`	string	sí	RUT de la empresa para la que se usa el sistema, con dígito verificador. Ejemplo: 76.123.456-0.

JSON Schema de entrada

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "sistema": {
      "type": "string",
      "description": "Código del sistema, tal como lo devuelve conexiones.sistemas.listar. Sólo sirve para sistemas sin clave."
    },
    "empresaRut": {
      "type": "string",
      "description": "RUT de la empresa para la que se usa el sistema, con dígito verificador. Ejemplo: 76.123.456-0."
    }
  },
  "required": [
    "sistema",
    "empresaRut"
  ]
}

Ejemplo

curl

curl -X POST https://connect.emisso.ai/api/v1/tools/conexiones.conexion.crear/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "Content-Type: application/json" \
  -d '{"input":{"sistema":"mercadopublico","empresaRut":"76.123.456-0"}}'

SDK TypeScript

const data = await connect.tools.conexiones.conexion.crear({ sistema: "mercadopublico", empresaRut: "76.123.456-0" });

MCP · meta-tool execute

{
  "tool": "conexiones.conexion.crear",
  "params": {
    "sistema": "mercadopublico",
    "empresaRut": "76.123.456-0"
  }
}

Salida esperada (200):

{
  "data": {
    "id": "conn_01J8Z3Q6N1K5Y2T7W9R4M8B6C3",
    "sistema": "mercadopublico",
    "sistemaNombre": "Mercado Público",
    "nombre": "Mercado Público",
    "empresaRut": "76123456-0",
    "creada": true
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "conexiones.conexion.crear",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}

Salida

Campo	Tipo	Requerido	Descripción
`id`	string	sí	El id de la conexión (conn_…). Pásalo como connectionId al usar las tools de ese sistema.
`sistema`	string	sí	El código del sistema conectado.
`sistemaNombre`	string	sí	El nombre del sistema, para presentarlo.
`nombre`	string	sí	El nombre con que quedó la conexión en el panel.
`empresaRut`	string	sí	El RUT de la empresa de esta conexión, canonizado sin puntos y con guion (76123456-0).
`creada`	booleano	sí	true si esta llamada creó la conexión; false si esa empresa ya tenía una activa con este sistema y se devolvió la misma, sin crear otra ni sumar un cobro.

JSON Schema de salida

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "El id de la conexión (conn_…). Pásalo como connectionId al usar las tools de ese sistema."
    },
    "sistema": {
      "type": "string",
      "description": "El código del sistema conectado."
    },
    "sistemaNombre": {
      "type": "string",
      "description": "El nombre del sistema, para presentarlo."
    },
    "nombre": {
      "type": "string",
      "description": "El nombre con que quedó la conexión en el panel."
    },
    "empresaRut": {
      "type": "string",
      "description": "El RUT de la empresa de esta conexión, canonizado sin puntos y con guion (76123456-0)."
    },
    "creada": {
      "type": "boolean",
      "description": "true si esta llamada creó la conexión; false si esa empresa ya tenía una activa con este sistema y se devolvió la misma, sin crear otra ni sumar un cobro."
    }
  },
  "required": [
    "id",
    "sistema",
    "sistemaNombre",
    "nombre",
    "empresaRut",
    "creada"
  ],
  "additionalProperties": false
}

Errores de esta tool

Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.