• EXTERNO
  • LÓGICA
  • DATOS
  • HUMANO

Cómo ejecutar llamadas a APIs externas con tu IA

Conecta Convex a tu agente para ejecutar lógica no transaccional. Una vez vinculado, tu IA podrá activar servicios de terceros mediante tu configuración actual de Convex.

Pregunta a la IA sobre esta página

Respuesta rápida

¿Cómo puedo hacer que mi IA llame a APIs externas?

Tu agente utiliza acciones de Convex para comunicarse con servicios externos. Esto te permite activar webhooks, enviar notificaciones o ejecutar código personalizado de forma independiente a las transacciones de tu base de datos. Verás los resultados de estas llamadas directamente en el chat.

Destino de las peticiones.

Resultados de tus peticiones.

Tu agente dirige tus comandos a la ruta de ejecución de Convex adecuada.

EXTERNO

Llamadas a servicios de terceros

El agente usa acciones de Convex para contactar endpoints externos. Recibirás la respuesta del servicio directamente en tu chat.

LÓGICA

Ejecución de código personalizado

Tu agente ejecuta lógica no transaccional mediante Convex. Esto sirve para tareas como enviar mensajes o activar webhooks.

DATOS

Interacciones con la base de datos

El agente utiliza funciones de Convex para leer o escribir datos, manteniendo tu estado sincronizado con tus instrucciones.

HUMANO

Confirmación manual

Para acciones sensibles, el agente se detiene y te pide aprobación. Tú mantienes el control de lo que se ejecuta.

El flujo

Qué hace tu IA cuando llega una petición.

El agente identifica la intención y elige la herramienta adecuada para gestionarla.

  1. Identificar la tarea

    El agente analiza tu prompt para decidir si necesitas interactuar con la base de datos o con un servicio externo.

    run_function
  2. Activar lógica externa

    Si necesitas contactar una API de terceros, el agente ejecuta una acción de Convex para realizar la petición.

    run_action
  3. Actualizar estado de la base de datos

    Para cambios de datos, el agente ejecuta una función de Convex para modificar tus registros.

    run_function
  4. Entregar el resultado

    El agente toma la salida de la ejecución en Convex y te informa sobre lo ocurrido.

    run_actionrun_function

Pruébalo

Copia estos ejemplos para empezar.

Pega estos textos en tu chat para probar la conexión.

Puntos de partida

Estos son ejemplos iniciales. Sustituye el nombre del servicio o la función por el que utilices realmente.

Convex Connector

Todo listo. Elige tu cliente MCP y sigue las instrucciones de configuración.

Enlace del conectorhttps://edge.vinkius.com/vk_preview_MADGSG1GwcjX2nZFJX7QdDYmcBCtd1WoRLCUHsG9/mcp

Claude Desktop

Sigue los pasos siguientes para conectarte en segundos.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Convex capabilities are ready to use.
Configuración · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "convex-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_MADGSG1GwcjX2nZFJX7QdDYmcBCtd1WoRLCUHsG9/mcp"
    }
  }
}
Copia en el chat04
  • Ejecuta una acción de Convex para enviar una notificación a mi canal de Slack.

  • Usa una función de Convex para obtener los últimos registros de usuarios de mi base de datos.

  • Activa una llamada a una API externa para consultar el clima en San Francisco.

  • Ejecuta una acción de Convex para enviar un resumen de este chat a mi webhook.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Empieza aquí

Conecta Convex una vez y empieza a preguntar.

Haz clic en el enlace para autorizar la conexión. Tus credenciales se mantienen cifradas en nuestro sistema y podrás usar las herramientas de inmediato.

Conectar Convex a tu IA

FAQ

Cómo funciona esta tarea.

  • 01

    ¿Puede la IA cambiar el esquema de mi base de datos?

    No. El agente solo puede ejecutar las funciones y acciones que hayas definido previamente en tu despliegue de Convex.

  • 02

    ¿Llama la IA a las APIs de forma automática?

    No. El agente solo activa una llamada externa cuando tu prompt requiere específicamente la ejecución de una acción.

  • 03

    ¿Puede la IA borrar toda mi base de datos?

    No. El agente está limitado a las herramientas específicas proporcionadas en el manifiesto. No puede realizar operaciones que no estén definidas allí.

  • 04

    ¿Pedirá la IA permiso antes de ejecutar una acción?

    El comportamiento depende de cómo hayas configurado tu cliente, pero puedes establecer que se requiera tu aprobación para tareas específicas.

  • 05

    ¿Cómo sabe el agente qué herramienta de Convex usar?

    El agente mapea tu petición en lenguaje natural con las herramientas listadas en el manifiesto de Convex.

Conecta Convex a Claude, Cursor, ChatGPT y más