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.
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
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.
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.
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.
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.
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.
- Em Customize → Connectors, clique em + Add → Add custom connector.
- Dê o nome Vexday e cole o endereço https://api.vexday.io/mcp.
- Na autenticação, escolha entrar agora e deixe o cliente OAuth no registro automático (sem preencher as configurações avançadas).
- Entre com a sua conta do Vexday e autorize.
- Numa conversa, ligue o Vexday em + → Connectors.
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.
- Abra chatgpt.com/plugins e clique em + → Add custom MCP server.
- Dê o nome Vexday e, em Server URL, cole https://api.vexday.io/mcp.
- Em Authentication, escolha OAuth e deixe os campos do cliente vazios.
- Aceite o aviso, clique em Create as a plugin, confira as ferramentas e entre com a sua conta do Vexday.
- Numa conversa, digite @ e escolha o Vexday.
Microsoft Copilot StudioConector ou chave
Pede a orquestração generativa ligada no agente. Depois de conectar, confira a lista de ferramentas.
- No agente, abra Tools → Add a tool → New tool → Model Context Protocol.
- 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.
- Para o login: OAuth 2.0, tipo Dynamic discovery. Para a chave: API key, tipo Header, com o nome Authorization.
- 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).
- Clique em Add to agent.
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.
- Abra Connectors (em Context, no menu) e clique em + Add Connector → Custom MCP Connector.
- Nome: vexday (sem espaços); Server URL: https://api.vexday.io/mcp.
- Clique em Connect e entre com a sua conta do Vexday.
- Em My Connectors, abra o Vexday e, nas funções, escolha Always allow para não confirmar cada consulta.
5ireChave da API
O 5ire não tem login (OAuth): entra pela chave da API.
- Gere a chave da API no painel do Vexday, em Integrações.
- Em Tools, abra a seta do botão + Local e escolha Remote.
- Nome Vexday, URL https://api.vexday.io/mcp e, em Http Headers, Name Authorization e Value Bearer vx_live_SUA_CHAVE.
- Salve e ligue o Vexday.
Editores de código e terminais
Claude CodeConector ou chave
- Gere a chave da API no painel do Vexday, em Integrações.
- No terminal, rode o comando abaixo (com --scope user, vale para todos os seus projetos).
- 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"
CursorConector ou chave
- Gere a chave da API no painel do Vexday, em Integrações.
- 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.
- 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}" }
}
}
}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.
- Gere a chave da API no painel do Vexday, em Integrações.
- 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.
- 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": ["*"]
}
}
}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".
- Gere a chave da API no painel do Vexday, em Integrações.
- Cole o bloco abaixo no arquivo. No .local.json do projeto, a chave fica fora do git.
- 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" }
}
}
}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.
- Cole o bloco abaixo nas configurações do usuário (ou em Settings → AI → MCP Servers → Add Server → Add Remote Server).
- Clique em Authenticate e entre com a sua conta do Vexday.
- 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"
}
}
}OpenCodeConector ou chave
- Gere a chave da API no painel do Vexday, em Integrações.
- 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.
- 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}" }
}
}
}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".
- Gere a chave da API no painel do Vexday, em Integrações.
- 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.
- 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}" }
}
}
}Codex CLI (OpenAI)Conector ou chave
A mesma configuração vale para a extensão do Codex no editor.
- Gere a chave da API no painel do Vexday, em Integrações.
- 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.
- 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"
n8nConector ou chave
Pede o n8n 1.104 ou mais novo (HTTP Streamable). Para o login, use Authentication: MCP OAuth2.
- Gere a chave da API no painel do Vexday, em Integrações.
- No nó AI Agent, em Tool, adicione o MCP Client Tool.
- Endpoint: https://api.vexday.io/mcp; Server Transport: HTTP Streamable.
- Authentication: Bearer Auth, com uma credencial nova. Em Bearer Token, cole só a chave (vx_live_…), sem o Bearer: o n8n põe sozinho.
- Em Tools to Include, escolha Selected: se as ferramentas do Vexday aparecem na lista, a conexão está funcionando.