Documentación de BizCortex

Conectar herramientas de IA (MCP)

Use BizCortex desde Claude, ChatGPT, Cursor y otras herramientas de IA mediante el Model Context Protocol.

MCP (Model Context Protocol) es un estándar abierto que permite a herramientas de IA como Claude, ChatGPT o Cursor trabajar con otros programas. BizCortex ofrece dos servidores MCP.

El servidor de la empresa, en https://app.bizcortex.de/api/v1/mcp, trabaja con los datos de su empresa. Inicia sesión con una clave de API, y el rol de esa clave decide qué puede ver y hacer la herramienta de IA. Requiere el paquete Brain, y Brain debe estar activado en los ajustes de Brain.

El servidor de documentación, en https://docs.bizcortex.de/mcp, pone esta documentación a disposición de las herramientas de IA en los siete idiomas. Es público y no necesita clave.

Quién puede usarlo

  • Propietario
  • Administrador

Pasos

  1. 1. Cree una clave de API

    Abra «Ajustes» y la pestaña «Claves de API». Haga clic en «Crear clave», dé a la clave un nombre como «Claude» y elija el rol más pequeño que necesite la herramienta de IA. Copie la clave, solo se muestra una vez.

  2. 2. Copie la configuración de su herramienta

    Debajo de la tabla de claves, la tarjeta «Conectar por MCP» muestra el endpoint y una configuración lista para Claude Code, Claude Desktop y Cursor. Abra la pestaña de su herramienta, haga clic en el botón de copiar y sustituya el marcador ak_… por su clave.

  3. 3. Otras herramientas de IA

    En cualquier otro cliente MCP, añada un servidor remoto con la dirección del endpoint y la cabecera Authorization con el valor Bearer, seguido de un espacio y su clave.

  4. 4. Pregunte a la herramienta de IA

    Pregunte con sus propias palabras, por ejemplo «¿Qué facturas están vencidas?» o «Crea un cliente llamado Ejemplo SL». La herramienta de IA encuentra las funciones de BizCortex que su clave puede usar, lee los datos directamente y prepara cada cambio como una propuesta.

  5. 5. Confirme los cambios en Brain

    La herramienta de IA nunca ejecuta por sí misma un cambio (crear, editar, eliminar, enviar o aprobar). La propuesta aparece en Brain, en la conversación «MCP · <nombre de la clave>», y la herramienta de IA recibe un enlace a ella. La persona que creó la clave la abre y hace clic en «Confirmar» o «Rechazar». Después, la herramienta de IA puede consultar el resultado.

Campos y opciones

Servidor de la empresa

https://app.bizcortex.de/api/v1/mcp. Requiere una clave de API. Lee datos, busca registros y propone cambios.

Servidor de documentación

https://docs.bizcortex.de/mcp. Público, sin clave. Busca en esta documentación, lee una página y muestra el índice.

Consejos

  • Cree una clave distinta para cada herramienta de IA. Así podrá revocar una sin afectar a las demás.
  • Para hacer preguntas sobre sus datos basta una clave con el rol Lector. Una clave que deba proponer cambios necesita un rol que pueda hacerlos.
  • Añada también el servidor de documentación, para que la herramienta de IA pueda explicar además cómo funciona BizCortex.

Conviene saber

  • No se aceptan los inicios de sesión de personas. El servidor de la empresa solo funciona con claves de API.
  • Por defecto, una propuesta caduca a los 30 minutos si nadie la confirma.
  • Cada llamada aparece en el registro de auditoría, marcada como realizada a través de MCP.
  • Cada clave puede hacer hasta 60 llamadas por minuto.
  • Al revocar la clave, la herramienta de IA se desconecta de inmediato.

Relacionado

  • Claves de API

    Claves que permiten a otros programas acceder a los datos de su empresa a través de la API REST.

  • Confirmar lo que propone Brain

    Cómo funcionan los cambios propuestos: tarjetas de confirmación, estados, caducidad y el paso de seguridad adicional.

  • Ajustes de Brain

    Active o desactive Brain para la empresa, elija el modelo, fije el presupuesto y controle los datos de RR. HH.