Crear un enlace para conectar un sistema
Crea un enlace de un solo uso donde la persona entrega sus credenciales del sistema para conectarlo. Devuelve el enlace SIEMPRE con su dominio completo visible y explicando quién lo pidió y para qué; nunca lo presentes como un aviso del banco ni del SII. La credencial se cifra en el vault de esta misma organización y no la ve nadie más, tampoco tú. El enlace vence y sirve una sola vez. Puedes fijar 'acceso', 'emitir' y 'alcances' para que la persona solo entregue sus claves; si los omites, los elige ella. Los códigos de acceso salen de 'accesos' en conexiones.sistemas.listar. Si 'costoAdicional' no es null, la conexión nueva se suma al próximo cobro de la organización: díselo a la persona antes de entregar el enlace. Con modo 'activar_emision' y 'conexionId' de una conexión del SII con clave de persona que todavía no emite, la persona solo entrega la clave del certificado digital y la misma conexión pasa a emitir facturas, notas de crédito y boletas. Una conexión con la clave tributaria de la empresa no puede emitir: para eso crea una conexión nueva con modo 'crear', acceso 'portal_credentials_representante' y 'emitir' true. Con modo 'cambiar_clave_certificado' y 'conexionId' de una conexión del SII que ya emite, la persona solo entrega la clave nueva del certificado digital (por ejemplo, porque lo renovó o el SII rechazó la firma); la conexión sigue emitiendo con el mismo id y la clave se comprueba con el próximo documento que emita. Shopify sólo admite modo reconectar con una conexión existente; las tiendas nuevas se instalan desde Shopify App Store. Los demás sistemas de acceso 'oauth_source' (como Mercado Pago) no se conectan ni se renuevan por enlace: la persona los conecta en el panel (Conexiones → Conectar) o los vuelve a autorizar en Ajustes de la conexión. Después de que la persona lo complete, usa 'conexiones.estado.consultar' para saber si ya hay datos.
API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.
In: header
Request Body
application/json
La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/tools/conexiones.enlace.crear/execute" \ -H "Content-Type: application/json" \ -d '{ "input": {} }'{ "data": { "url": "string", "dominio": "string", "sistema": "string", "sistemaNombre": "string", "modo": "crear", "expiraEn": "string", "intentosMaximos": -9007199254740991, "acceso": "string", "emitir": true, "alcances": [ "string" ], "advertencia": "string", "costoAdicional": { "montoUsd": 0, "montoUsdConEmision": 0, "planNombre": "string", "incluidas": -9007199254740991, "mensaje": "string" } }, "meta": { "request_id": "string", "operation_request_id": "733a3a71-b72d-4633-94b1-070c6664565f", "tool_id": "string", "plane": "action", "latency_ms": 0, "audit_status": "recorded", "idempotency": "replayed" }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}Renombrar una conexión POST
Cambia el nombre visible de una conexión de esta organización: el que aparece en el panel, en la bitácora, en los cobros y en 'nombre' de conexiones.estado.consultar. No toca la credencial, los datos ni la sincronización. El nombre es único entre las conexiones del mismo sistema: si otra ya lo usa, falla sin cambiar nada. Si la conexión ya se llamaba así, no cambia nada y responde 'cambiada' en false.
Consultar el estado de las conexiones POST
Consulta las atenciones, el estado del acceso, las sincronizaciones recientes y la disponibilidad de datos de cada conexión. Úsala después de que la persona complete un enlace, y antes de intentar leer: un listado vacío no significa que no haya nada, puede ser que todavía no sincronizó. La primera sincronización de algunos sistemas puede tardar cerca de un minuto. El campo 'herramientas' trae los ids que ya puedes invocar; si tu cliente MCP todavía no los muestra en su lista, invócalos con la herramienta que indica su 'puerta' en 'search_docs', pasando el id en 'tool'. El campo 'uso' dice cuántas llamadas lleva cada conexión en su período, su límite y cuándo se renueva.