MCP e automação

Como conectar o Vexday ao Claude, ChatGPT e outros assistentes de IA (MCP)

Pergunte ao seu assistente de IA se uma CVE tem exploit público ou afeta um cliente e receba a resposta com os dados do Vexday e a fonte de cada um. O passo a passo vale para o Claude, o ChatGPT, o Cursor, o VS Code, o n8n e outras aplicações.

  • Para quemPara SOC, MSSP e quem usa IA no dia a dia da segurança.
  • PlanoPlanos SOC e MSSP
  • Tempocerca de 5 min

O que você precisa

  • Uma conta do Vexday com o plano SOC ou MSSP.
  • Um assistente ou editor compatível com MCP, como o Claude, o ChatGPT, o Cursor ou o VS Code.

Consultas por dia nos planos com o MCP: SOC, 5.000 · MSSP, 20.000.

Passo a passo

  1. Escolha como entrar

    Pelo conector, sem chave: a aplicação abre a tela do Vexday, você entra com o e-mail ou o Google e clica em Permitir. Ou pela chave da API, nas aplicações que aceitam um cabeçalho. Na lista abaixo, cada aplicação diz qual dos dois ela aceita.

  2. Gere a chave, se for usar uma

    No painel, abra Integrações e clique em Nova chave. Copie a chave na hora: ela começa com vx_live_ e só aparece uma vez. Quem entra pelo conector pula este passo.

  3. Adicione o servidor na aplicação

    O endereço do servidor é https://api.vexday.io/mcp. Abra a sua aplicação na lista abaixo e siga o passo a passo dela, com o arquivo de configuração quando houver.

  4. Faça a primeira pergunta

    Peça, por exemplo: "O CVE-2024-3400 tem exploit público? Afeta alguma tecnologia que eu monitoro?". O assistente consulta o Vexday e responde com a fonte de cada dado.

  5. Acompanhe o uso e desconecte quando quiser

    Cada chamada de ferramenta conta uma consulta no limite da conta, o mesmo da API. O conector aparece em Integrações como a chave "Conector: nome da aplicação": para desconectar, revogue a chave.

Cada aplicação, passo a passo

Assistentes de conversa

Claude.ai e Claude DesktopConector, sem chave

No plano Free cabe um conector personalizado. No Team e no Enterprise, quem adiciona é o dono da organização (em Organization settings → Connectors), e cada membro clica em Connect. O Claude Desktop usa os mesmos conectores da conta.

  1. Em Customize → Connectors, clique em + Add → Add custom connector.
  2. Dê o nome Vexday e cole o endereço https://api.vexday.io/mcp.
  3. Na autenticação, escolha entrar agora e deixe o cliente OAuth no registro automático (sem preencher as configurações avançadas).
  4. Entre com a sua conta do Vexday e autorize.
  5. Numa conversa, ligue o Vexday em + → Connectors.

Documentação oficial ↗

ChatGPTConector, sem chave

O ChatGPT só entra pelo login: ele não envia chave da API. O servidor MCP personalizado está nos planos Business e Enterprise (no Business, quem cria é o administrador) e, no Pro, no modo desenvolvedor. Em versões anteriores, o caminho é Settings → Apps & Connectors → Advanced settings → Developer mode → Create.

  1. Abra chatgpt.com/plugins e clique em + → Add custom MCP server.
  2. Dê o nome Vexday e, em Server URL, cole https://api.vexday.io/mcp.
  3. Em Authentication, escolha OAuth e deixe os campos do cliente vazios.
  4. Aceite o aviso, clique em Create as a plugin, confira as ferramentas e entre com a sua conta do Vexday.
  5. Numa conversa, digite @ e escolha o Vexday.

Documentação oficial ↗

Microsoft Copilot StudioConector ou chave

Pede a orquestração generativa ligada no agente. Depois de conectar, confira a lista de ferramentas.

  1. No agente, abra Tools → Add a tool → New tool → Model Context Protocol.
  2. Preencha o nome, a descrição (o agente usa a descrição para decidir quando consultar o Vexday) e o Server URL https://api.vexday.io/mcp.
  3. Para o login: OAuth 2.0, tipo Dynamic discovery. Para a chave: API key, tipo Header, com o nome Authorization.
  4. Em Add tool, crie a conexão: no login, entre com a conta do Vexday; na chave, cole Bearer vx_live_SUA_CHAVE (com o Bearer na frente).
  5. Clique em Add to agent.

Documentação oficial ↗

Le Chat (Mistral Vibe)Conector, sem chave

O Le Chat passou a se chamar Vibe; o endereço chat.mistral.ai continua o mesmo. Só o administrador da conta adiciona conectores.

  1. Abra Connectors (em Context, no menu) e clique em + Add Connector → Custom MCP Connector.
  2. Nome: vexday (sem espaços); Server URL: https://api.vexday.io/mcp.
  3. Clique em Connect e entre com a sua conta do Vexday.
  4. Em My Connectors, abra o Vexday e, nas funções, escolha Always allow para não confirmar cada consulta.

Documentação oficial ↗

5ireChave da API

O 5ire não tem login (OAuth): entra pela chave da API.

  1. Gere a chave da API no painel do Vexday, em Integrações.
  2. Em Tools, abra a seta do botão + Local e escolha Remote.
  3. Nome Vexday, URL https://api.vexday.io/mcp e, em Http Headers, Name Authorization e Value Bearer vx_live_SUA_CHAVE.
  4. Salve e ligue o Vexday.

Documentação oficial ↗

Editores de código e terminais

Claude CodeConector ou chave
  1. Gere a chave da API no painel do Vexday, em Integrações.
  2. No terminal, rode o comando abaixo (com --scope user, vale para todos os seus projetos).
  3. Confira com claude mcp list: o vexday aparece como Connected. Sem o --header, o Claude Code oferece o login do Vexday em /mcp.
claude mcp add --transport http --scope user vexday https://api.vexday.io/mcp \
  --header "Authorization: Bearer vx_live_SUA_CHAVE"

Documentação oficial ↗

CursorConector ou chave
  1. Gere a chave da API no painel do Vexday, em Integrações.
  2. Guarde a chave na variável de ambiente VEXDAY_API_KEY (no terminal: export VEXDAY_API_KEY=vx_live_…) e abra o programa a partir desse terminal.
  3. Cole o bloco abaixo no arquivo e confira, nas configurações de MCP do Cursor, se o vexday está ligado. Sem headers, o Cursor abre o login do Vexday.

Arquivo: ~/.cursor/mcp.json (ou .cursor/mcp.json no projeto)

{
  "mcpServers": {
    "vexday": {
      "url": "https://api.vexday.io/mcp",
      "headers": { "Authorization": "Bearer ${env:VEXDAY_API_KEY}" }
    }
  }
}

Documentação oficial ↗

VS Code com GitHub CopilotConector ou chave

Este é o formato novo, o mesmo do GitHub Copilot CLI. O formato antigo (.vscode/mcp.json, com "servers" no lugar de "mcpServers" e ${env:VEXDAY_API_KEY}) ainda funciona.

  1. Gere a chave da API no painel do Vexday, em Integrações.
  2. Guarde a chave na variável de ambiente VEXDAY_API_KEY (no terminal: export VEXDAY_API_KEY=vx_live_…) e abra o programa a partir desse terminal.
  3. Cole o bloco abaixo no arquivo. Em MCP: List Servers, escolha o vexday para ver o estado e a saída dele. Sem headers, o VS Code abre o login do Vexday.

Arquivo: ~/.copilot/mcp-config.json (ou .mcp.json na raiz do projeto)

{
  "mcpServers": {
    "vexday": {
      "type": "http",
      "url": "https://api.vexday.io/mcp",
      "headers": { "Authorization": "Bearer ${VEXDAY_API_KEY}" },
      "tools": ["*"]
    }
  }
}

Documentação oficial ↗

Windsurf (Devin Desktop)Conector ou chave

O Windsurf passou a se chamar Devin Desktop em junho de 2026. Nas versões com o nome antigo, o arquivo é ~/.codeium/windsurf/mcp_config.json e o endereço vai em "serverUrl".

  1. Gere a chave da API no painel do Vexday, em Integrações.
  2. Cole o bloco abaixo no arquivo. No .local.json do projeto, a chave fica fora do git.
  3. Em Customize → MCPs, atualize e confira se o vexday está ligado. Sem headers, ele pede o login do Vexday (Authenticate).

Arquivo: .devin/mcp_config.local.json no projeto (ou ~/.config/devin/mcp_config.json)

{
  "mcpServers": {
    "vexday": {
      "url": "https://api.vexday.io/mcp",
      "headers": { "Authorization": "Bearer vx_live_SUA_CHAVE" }
    }
  }
}

Documentação oficial ↗

ZedConector ou chave

No Zed, prefira o login: ele não lê variável de ambiente no cabeçalho. Se usar a chave, acrescente "headers": { "Authorization": "Bearer vx_live_SUA_CHAVE" } só nas configurações do usuário, nunca no .zed/settings.json do projeto.

  1. Cole o bloco abaixo nas configurações do usuário (ou em Settings → AI → MCP Servers → Add Server → Add Remote Server).
  2. Clique em Authenticate e entre com a sua conta do Vexday.
  3. Em Settings → AI → MCP Servers, o ponto do vexday fica verde.

Arquivo: ~/.config/zed/settings.json (no Windows, %APPDATA%\Zed\settings.json)

{
  "context_servers": {
    "vexday": {
      "url": "https://api.vexday.io/mcp"
    }
  }
}

Documentação oficial ↗

OpenCodeConector ou chave
  1. Gere a chave da API no painel do Vexday, em Integrações.
  2. Guarde a chave na variável de ambiente VEXDAY_API_KEY (no terminal: export VEXDAY_API_KEY=vx_live_…) e abra o programa a partir desse terminal.
  3. Cole o bloco abaixo no arquivo e confira com opencode mcp list (ou opencode mcp debug vexday). Para o login, tire "oauth" e "headers" e rode opencode mcp auth vexday.

Arquivo: ~/.config/opencode/opencode.json (ou opencode.json no projeto)

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "vexday": {
      "type": "remote",
      "url": "https://api.vexday.io/mcp",
      "oauth": false,
      "headers": { "Authorization": "Bearer {env:VEXDAY_API_KEY}" }
    }
  }
}

Documentação oficial ↗

Outros terminais e automação

Gemini CLIConector ou chave

Em versões antigas do Gemini CLI, troque "url" e "type" por "httpUrl": "https://api.vexday.io/mcp".

  1. Gere a chave da API no painel do Vexday, em Integrações.
  2. Guarde a chave na variável de ambiente VEXDAY_API_KEY (no terminal: export VEXDAY_API_KEY=vx_live_…) e abra o programa a partir desse terminal.
  3. Cole o bloco abaixo no arquivo e confira com gemini mcp list (Connected) ou /mcp na conversa. Para entrar com a conta do Vexday em vez da chave, tire "headers" e rode /mcp auth vexday na conversa.

Arquivo: ~/.gemini/settings.json (ou .gemini/settings.json no projeto)

{
  "mcpServers": {
    "vexday": {
      "url": "https://api.vexday.io/mcp",
      "type": "http",
      "headers": { "Authorization": "Bearer ${VEXDAY_API_KEY}" }
    }
  }
}

Documentação oficial ↗

Codex CLI (OpenAI)Conector ou chave

A mesma configuração vale para a extensão do Codex no editor.

  1. Gere a chave da API no painel do Vexday, em Integrações.
  2. Guarde a chave na variável de ambiente VEXDAY_API_KEY (no terminal: export VEXDAY_API_KEY=vx_live_…) e abra o programa a partir desse terminal.
  3. Cole o bloco abaixo no arquivo e confira com codex mcp list ou /mcp. Sem a linha da chave, codex mcp login vexday abre o login do Vexday.

Arquivo: ~/.codex/config.toml

[mcp_servers.vexday]
url = "https://api.vexday.io/mcp"
bearer_token_env_var = "VEXDAY_API_KEY"

Documentação oficial ↗

n8nConector ou chave

Pede o n8n 1.104 ou mais novo (HTTP Streamable). Para o login, use Authentication: MCP OAuth2.

  1. Gere a chave da API no painel do Vexday, em Integrações.
  2. No nó AI Agent, em Tool, adicione o MCP Client Tool.
  3. Endpoint: https://api.vexday.io/mcp; Server Transport: HTTP Streamable.
  4. Authentication: Bearer Auth, com uma credencial nova. Em Bearer Token, cole só a chave (vx_live_…), sem o Bearer: o n8n põe sozinho.
  5. Em Tools to Include, escolha Selected: se as ferramentas do Vexday aparecem na lista, a conexão está funcionando.

Documentação oficial ↗

Deu errado?

A aplicação diz que a chave é inválida (401)A chave foi revogada ou colada com espaço. Gere outra em Integrações e cole de novo. No n8n, cole só a chave: ele acrescenta o Bearer sozinho.
Aparece que o plano não libera o MCP (403)O MCP é dos planos SOC e MSSP. Confira o plano da conta em Conta e plano.
Muitas requisições por minutoO assistente chamou muitas ferramentas em sequência. Espere um minuto: o limite por minuto volta sozinho.
O conector não abre a tela de loginConfira se o endereço termina em /mcp e se a aplicação está no modo de login (OAuth), e não no de chave.

Perguntas frequentes

Preciso instalar alguma coisa?

Não. O servidor fica no Vexday: você só cadastra o endereço na aplicação.

Funciona com uma aplicação que não está na lista?

Sim, com qualquer cliente MCP que use HTTP: cadastre o endereço e mande a chave no cabeçalho Authorization.

O que o assistente vê da minha conta?

A stack monitorada, os alertas e a exposição da conta conectada, só para leitura. Nenhuma ferramenta muda a conta.

Continue