Volver al inicio

    Integraciones de agentes

    Conectá tu asistente de IA con Cresova

    Con esta conexión, ChatGPT, Claude u otro asistente puede consultar directamente la información de Cresova: qué hacemos, los paquetes web, los planes de membresía y — con la API key del equipo — las herramientas de negocio (ventas, cotizaciones, proyectos, clientes, tesorería y blog).

    Dirección del servidor

    Copiá esta dirección: es lo único que necesitás pegar en tu asistente.

    Si tu cliente MCP falla con esta dirección, probá la equivalente https://<tu-dominio>/api/public/mcp: responde exactamente lo mismo.

    Herramientas de negocio (API key)

    Además de las 3 herramientas públicas, el servidor expone 30 herramientas de negocio: resumen de ventas, cotizaciones (crear, listar, cambiar estado, registrar pagos), proyectos (kanban, asignar desarrollador, brief técnico), clientes, tesorería (gastos, cuentas, costos fijos) y el blog (crear, editar y publicar artículos).

    Estas herramientas piden el parámetro api_key. Los administradores ven y copian la clave en Ajustes → Conexión de agentes (MCP) — no la publiques ni la compartas fuera del equipo. Si el agente falla por autorización, que llame la tool check_api_key: devuelve el motivo exacto del rechazo.

    Para agentes sin OAuth (ej. OpenClaw):

    1. 1Conectá el servidor MCP con la dirección de arriba.
    2. 2En las instrucciones del agente, agregá: “Cuando uses tools de Cresova que pidan api_key, pasá tu API key en ese parámetro. Las tools públicas (get_company_info, list_web_packages, list_membership_plans) no la necesitan.”
    3. 3Guardá la API key en el gestor de secretos de tu agente y referenciala desde ahí, nunca en texto plano dentro de prompts compartidos.
    4. 4Probá con: “Listame las cotizaciones en borrador” o “¿Cómo vamos de ventas este mes?”.

    Prompt listo para tu bot

    Pegá estas instrucciones en el system prompt de tu agente (OpenClaw u otro) y reemplazá <TU_API_KEY> por el valor del secreto MCP_API_KEY. Con eso el bot ya sabe conectarse y usar todas las herramientas.

    Tienes acceso al servidor MCP de Cresova en:
https://<tu-dominio>/mcp

Conéctate por HTTP (Streamable HTTP). El servidor expone 33 herramientas del
negocio: ventas, cotizaciones, proyectos, clientes, tesorería y blog.

AUTENTICACIÓN:
Las 3 herramientas públicas (get_company_info, list_web_packages,
list_membership_plans) no piden clave. Las 30 herramientas de negocio requieren
el parámetro "api_key" en cada llamada. Tu API key es: <TU_API_KEY>

DIAGNÓSTICO:
Si una herramienta falla por autorización, llamá primero a check_api_key con tu
api_key: te dice exactamente si la clave es válida y por qué no lo es.

REGLAS:
- Pasá api_key en TODA llamada a herramientas de negocio.
- Nunca muestres la api_key en respuestas al usuario final.
- Si una herramienta responde "API key inválida", avisá en lugar de reintentar.
- Antes de crear cotizaciones o gastos, confirmá los datos conmigo.

    ChatGPT

    1. 1Abrí Ajustes → Aplicaciones (Avanzado) y activá el modo desarrollador (leé el aviso de riesgo que aparece ahí). Si no lo ves, pedile a un administrador de tu cuenta que lo habilite.
    2. 2Abrí el formulario de nueva aplicación.
    3. 3Poné Cresova como nombre y pegá la dirección de arriba en el campo de URL.
    4. 4Revisá los datos, marcá “I understand and want to continue” (ChatGPT muestra ese aviso para cualquier servidor propio) y tocá Create.
    5. 5Activá Cresova desde la barra del chat y pedile que use la app.

    Claude

    1. 1Abrí el formulario de conector personalizado (llega con el nombre y la dirección ya cargados).
    2. 2Revisá los datos y tocá Add.
    3. 3Si el formulario no se abre solo: entrá a la página de Connectors de Claude, elegí “Add custom connector”, ponele nombre y pegá la dirección de arriba.
    4. 4Activá el conector desde la barra del chat y pedile a Claude que use la app.

    Claude Code

    Corré esta línea en una terminal:

    claude mcp add --scope user --transport http cresova ''
    1. 1Después abrí Claude Code y ejecutá /mcp para confirmar que Cresova aparece conectado.
    2. 2Pedile a Claude Code que use la app.

    Otros asistentes

    1. 1Abrí la configuración de servidores MCP o conectores personalizados del asistente.
    2. 2Creá una conexión a un servidor MCP remoto.
    3. 3Ponele nombre y pegá la dirección de arriba.
    4. 4Completá cualquier paso de inicio de sesión o autorización que te pida.
    5. 5Activá la conexión y pedile al asistente que use la app.

    Actualizar la conexión cuando la app cambie

    Los asistentes guardan la lista de herramientas: si actualizamos la app, refrescá la conexión para ver lo último.

    ChatGPT

    1. 1Abrí la página de Plugins de ChatGPT y elegí Cresova.
    2. 2Bajá hasta “Information” y tocá Refresh.
    3. 3ChatGPT no permite cambiar la URL de una app existente: si la dirección cambió, borrala y volvé a agregarla con la de arriba.
    4. 4Abrí un chat nuevo y pedile que use la app.

    Claude

    1. 1Entrá a Connectors y elegí el conector de Cresova.
    2. 2Refrescá o actualizá sus herramientas.
    3. 3Claude tampoco permite editar la URL: si cambió, quitá el conector y volvé a agregarlo con la dirección de arriba.
    4. 4Pedile a Claude que use la app.

    Claude Code

    1. 1Iniciá una sesión nueva: ahí carga las herramientas más recientes.
    2. 2Si la dirección cambió, corré claude mcp remove cresova y volvé a correr el comando de instalación de arriba.
    3. 3Pedile a Claude Code que use la app.

    Otros asistentes

    1. 1Abrí la configuración de conectores del asistente.
    2. 2Elegí la conexión creada para Cresova.
    3. 3Refrescá la lista de herramientas, recargá el servidor o reconectalo.
    4. 4Si la dirección cambió, pegá la más reciente de arriba.
    5. 5Empezá un chat nuevo y pedile que use la app.