Documentación

Cómo usarlo de verdad

Las tres cosas que un equipo nuevo necesita el primer día. Todo lo que hay aquí describe el producto tal y como se entrega hoy.

01

Qué es un agente, y cómo pedir uno

Un agente es un trozo de TypeScript escrito contra un solo objeto. No tiene por qué escribirlo usted: describa el trabajo en el chat y Naski lo escribe, y después le enseña el código antes de guardar nada.

  1. 1

    Diga qué debe ocurrir, y cuándo. «Todos los días laborables a las 8:00», «cada vez que llegue un PDF a una carpeta», «cuando alguien escriba a esta dirección». El horario y el disparador se leen del código sin ejecutarlo, así que se escriben como valores fijos.

  2. 2

    Lea lo que hace antes de guardar. El código es el comportamiento — no hay nada escondido detrás.

  3. 3

    Dele una carpeta si solo debe ver una parte de su espacio. Sus herramientas de archivos quedan entonces confinadas a ese subárbol.

  4. 4

    Déjele llevar un diario. Un agente escribe una línea en lenguaje llano por cada cosa que hizo, marcada como pendiente o hecha, y las relee en la ejecución siguiente. Así es como un trabajo largo sobrevive a repartirse en muchas ejecuciones cortas.

  5. 5

    Decida qué pasa por usted. Pedir una aprobación deja la ejecución en pausa hasta que una persona responda y trata el silencio como una negativa; archivar una revisión pone un elemento en cola para más tarde sin bloquear nada.

  6. 6

    Editar un agente crea uno nuevo, así que la versión que funcionaba sigue siendo recuperable.

Conviene saberloLos agentes no tienen acceso ambiental a la red. Todo lo que alcanzan — la web, su espacio, una herramienta conectada — pasa por una llamada con nombre que la plataforma realiza por ellos.

02

Cómo conectar una herramienta

Un conector es dato, no código: una dirección base, una forma de autenticación y una lista de operaciones. Naski construye la petición e inyecta su credencial en el servidor.

  1. 1

    Abra Ajustes → Conectores e instale desde el catálogo. También puede pedirle al chat que lo haga por usted.

  2. 2

    Allí donde el proveedor esté registrado en su despliegue, pulse Conectar y apruebe en su propia pantalla. Ninguna clave se copia en ningún sitio.

  3. 3

    Si no, pegue la clave en Ajustes. Nunca pegue una clave en un mensaje del chat: las claves viven en Ajustes, donde se guardan cifradas y se inyectan en el servidor.

  4. 4

    Algunos servicios viven en la dirección propia de su empresa — Salesforce, Zendesk, Jira, Confluence, Zoho CRM, Odoo, Shopify, DocuSign. Instalarlos pide la URL de su instancia y sin ella se rechaza.

  5. 5

    Las llamadas salientes van solo por HTTPS, y se rechazan cuando la dirección resuelve a una red privada o reservada.

  6. 6

    Si un proveedor se niega a renovar un token, la conexión se borra y se le dice que vuelva a conectar — en lugar de dejar que cada llamada falle en silencio.

Conviene saberloUn servicio fuera del catálogo sigue estando al alcance: el chat puede escribirle un conector con la misma forma declarativa, y un servidor MCP remoto cubre los servicios con forma de herramienta.

03

Cómo conectar un cliente de IA externo

Naski expone su propio servidor MCP, de modo que un cliente como Claude Code, Claude Desktop o ChatGPT puede listar, crear, ejecutar e inspeccionar sus agentes desde donde usted ya trabaja.

  1. 1

    Abra Ajustes → Servidores MCP. La dirección se muestra ahí, y es esta:

    https://api.blackbox.finance/mcp
  2. 2

    Claude Desktop y ChatGPT se conectan por OAuth: añada la dirección como conector y apruebe. No hay ningún token que copiar.

  3. 3

    Para un cliente de línea de comandos, genere un token en Ajustes y ejecute:

    claude mcp add --transport http naski https://api.blackbox.finance/mcp --header "Authorization: Bearer YOUR_TOKEN"
  4. 4

    Un token se muestra una sola vez y solo se guarda como hash. Revóquelo desde la misma pantalla; una cuenta puede tener hasta veinte.

  5. 5

    Las conexiones de IA externas forman parte de los planes de pago — el plan gratuito no las incluye.

Conviene saberloTodo lo que ve un cliente MCP se limita a la cuenta cuyo token usa: sus agentes, sus ejecuciones y sus créditos, y nada más.

¿Listo para probarlo sobre un flujo de trabajo real?

El plan gratuito incluye un agente activo y una ejecución programada — lo suficiente para ver si la forma encaja antes de que nadie firme nada.