# 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.



{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}

|                     |                                                                     |
| ------------------- | ------------------------------------------------------------------- |
| **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 [#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 [#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.          |

<details>
  <summary>
    JSON Schema de entrada
  </summary>

  ```json
  {
    "$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"
    ]
  }
  ```
</details>

## Ejemplo [#ejemplo]

```bash title="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"}}'
```

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

```json title="MCP · meta-tool execute"
{
  "tool": "conexiones.conexion.crear",
  "params": {
    "sistema": "mercadopublico",
    "empresaRut": "76.123.456-0"
  }
}
```

**Salida esperada (200):**

```json
{
  "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 [#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. |

<details>
  <summary>
    JSON Schema de salida
  </summary>

  ```json
  {
    "$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
  }
  ```
</details>

## Errores de esta tool [#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](../errores).