• EXTERNO
  • LÓGICA
  • DADOS
  • HUMANO

Como disparar chamadas de API externas com seu AI

Conecte o Convex ao seu agente para executar lógica não transacional. Após a conexão, seu AI pode acionar serviços de terceiros usando sua estrutura atual do Convex.

Pergunte à IA sobre esta página

Resposta rápida

Como faço meu AI chamar APIs externas?

Seu agente chama Convex actions para alcançar serviços externos. Isso permite disparar webhooks, enviar notificações ou rodar códigos personalizados que ficam separados das transações do seu banco de dados. Você verá os resultados dessas chamadas direto no chat.

Onde as requisições chegam.

Os resultados das suas requisições.

Seu agente direciona seus comandos para o caminho de execução correto no Convex.

EXTERNO

Chamadas de serviços de terceiros

O agente usa Convex actions para acessar endpoints externos. Você recebe a resposta desse serviço diretamente na janela do chat.

LÓGICA

Execução de código personalizado

Seu agente executa lógica não transacional via Convex. Isso serve para tarefas como enviar mensagens ou disparar webhooks.

DADOS

Interações com o banco de dados

O agente usa Convex functions para ler ou gravar dados, mantendo seu estado sincronizado com suas instruções.

HUMANO

Confirmação manual

Para ações sensíveis, o agente para e pede sua aprovação. Você mantém o controle sobre o que é executado.

O fluxo

O que seu AI faz quando uma requisição chega.

O agente identifica a intenção e escolhe a ferramenta certa para resolvê-la.

  1. Identificar a tarefa

    O agente analisa seu comando para decidir se você precisa interagir com o banco de dados ou com um serviço externo.

    run_function

  2. Disparar lógica externa

    Se for necessário acessar uma API de terceiros, o agente executa uma Convex action para realizar a requisição.

    run_action

  3. Atualizar estado do banco

    Para alterações de dados, o agente roda uma Convex function para modificar seus registros.

    run_function

  4. Entregar o resultado

    O agente pega a saída da execução no Convex e informa o que aconteceu.

    run_actionrun_function

Teste

Copie estes exemplos.

Cole no seu chat para testar a conexão.

Pontos de partida

Estes são apenas exemplos. Substitua o nome do serviço ou da função pelo que você realmente usa.

Convex Connector

Tudo pronto. Escolha seu cliente MCP e siga as instruções de configuração.

Link do conectorhttps://edge.vinkius.com/vk_preview_MADGSG1GwcjX2nZFJX7QdDYmcBCtd1WoRLCUHsG9/mcp

Claude Desktop

Siga os passos abaixo para conectar em 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.
Configuração · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "convex-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_MADGSG1GwcjX2nZFJX7QdDYmcBCtd1WoRLCUHsG9/mcp"
    }
  }
}
Copie no chat04

  • Execute uma Convex action para enviar uma notificação para meu canal no Slack.

  • Use uma Convex function para buscar os registros de usuários mais recentes no meu banco de dados.

  • Dispare uma chamada de API externa para verificar a previsão do tempo em São Paulo.

  • Execute uma Convex action para enviar um resumo deste chat para o meu webhook.

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

Comece aqui

Conecte o Convex uma vez e pronto.

Clique no link para autorizar a conexão. Suas credenciais ficam criptografadas do nosso lado e você pode começar a usar as ferramentas imediatamente.

Conectar Convex ao seu AI

FAQ

Como essa tarefa funciona.

  • 01

    O AI pode alterar o schema do meu banco de dados?

    Não. O agente só pode executar as funções e actions que você já definiu no seu deployment do Convex.

  • 02

    O AI chama APIs automaticamente?

    Não. O agente só dispara uma chamada externa quando o seu comando exige a execução de uma action.

  • 03

    O AI pode deletar todo o meu banco de dados?

    Não. O agente é limitado às ferramentas específicas fornecidas no manifesto. Ele não pode realizar operações que não estejam explicitamente definidas ali.

  • 04

    O AI vai pedir permissão antes de executar uma action?

    O comportamento depende de como você configurou seu cliente, mas é possível definir que ele exija sua aprovação para tarefas específicas.

  • 05

    Como o agente sabe qual ferramenta do Convex usar?

    O agente mapeia sua solicitação em linguagem natural para as ferramentas listadas no manifesto do Convex.

  • Mais dúvidas sobre o Convex? Veja tudo o que o MCP do Convex pode fazer

Conecte Convex ao Claude, Cursor, ChatGPT e outros