How to connect Vexday to Claude, ChatGPT and other AI assistants (MCP)
Ask your AI assistant whether a CVE has a public exploit or affects a client and get the answer with Vexday's data and the source of each item. The steps work for Claude, ChatGPT, Cursor, VS Code, n8n and other apps.
What you need
- A Vexday account on the SOC or MSSP plan.
- An MCP-compatible assistant or editor, such as Claude, ChatGPT, Cursor or VS Code.
Calls per day on the plans with the MCP: SOC, 5,000 · MSSP, 20,000.
Step by step
Choose how to sign in
Through the connector, no key: the app opens the Vexday screen, you sign in with email or Google and click Allow. Or with the API key, in apps that accept a header. In the list below, each app says which of the two it supports.
Create the key, if you use one
In the dashboard, open Integrations and click New key. Copy the key right away: it starts with vx_live_ and is shown only once. If you use the connector, skip this step.
Add the server to the app
The server address is https://api.vexday.io/mcp. Open your app in the list below and follow its steps, with the config file where there is one.
Ask the first question
Ask, for example: "Does CVE-2024-3400 have a public exploit? Does it affect any technology I monitor?". The assistant queries Vexday and answers with the source of each item.
Track usage and disconnect any time
Each tool call counts as one request against the account limit, the same as the API's. The connector shows up under Integrations as the key "Conector: app name": to disconnect, revoke the key.
Each app, step by step
Chat assistants
Claude.ai e Claude DesktopConnector, no key
The Free plan allows one custom connector. On Team and Enterprise, the organization owner adds it (Organization settings → Connectors) and each member clicks Connect. Claude Desktop uses the same account connectors.
- In Customize → Connectors, click + Add → Add custom connector.
- Name it Vexday and paste the address https://api.vexday.io/mcp.
- For authentication, choose to sign in now and leave the OAuth client on automatic registration (no advanced settings).
- Sign in with your Vexday account and authorize.
- In a chat, turn Vexday on under + → Connectors.
ChatGPTConnector, no key
ChatGPT only connects by signing in: it doesn't send API keys. Custom MCP servers are on the Business and Enterprise plans (on Business, admins create them) and, on Pro, in developer mode. In older versions, the path is Settings → Apps & Connectors → Advanced settings → Developer mode → Create.
- Open chatgpt.com/plugins and click + → Add custom MCP server.
- Name it Vexday and paste https://api.vexday.io/mcp in Server URL.
- Under Authentication, choose OAuth and leave the client fields empty.
- Accept the warning, click Create as a plugin, review the tools and sign in with your Vexday account.
- In a chat, type @ and pick Vexday.
Microsoft Copilot StudioConnector or key
The agent needs generative orchestration on. After connecting, check the tool list.
- In the agent, open Tools → Add a tool → New tool → Model Context Protocol.
- Fill in the name, the description (the agent uses it to decide when to call Vexday) and the Server URL https://api.vexday.io/mcp.
- To sign in: OAuth 2.0, type Dynamic discovery. For the key: API key, type Header, named Authorization.
- Under Add tool, create the connection: to sign in, log in with your Vexday account; with the key, paste Bearer vx_live_SUA_CHAVE (with Bearer in front).
- Click Add to agent.
Le Chat (Mistral Vibe)Connector, no key
Le Chat is now called Vibe; the chat.mistral.ai address is the same. Only the account admin adds connectors.
- Open Connectors (under Context in the menu) and click + Add Connector → Custom MCP Connector.
- Name: vexday (no spaces); Server URL: https://api.vexday.io/mcp.
- Click Connect and sign in with your Vexday account.
- In My Connectors, open Vexday and set its functions to Always allow so you don't confirm each lookup.
5ireAPI key
5ire has no sign-in (OAuth): it connects with the API key.
- Create an API key in the Vexday dashboard, under Integrations.
- In Tools, open the arrow on the + Local button and choose Remote.
- Name Vexday, URL https://api.vexday.io/mcp and, under Http Headers, Name Authorization and Value Bearer vx_live_SUA_CHAVE.
- Save and turn Vexday on.
Code editors and terminals
Claude CodeConnector or key
- Create an API key in the Vexday dashboard, under Integrations.
- In the terminal, run the command below (with --scope user, it applies to all your projects).
- Check with claude mcp list: vexday shows as Connected. Without --header, Claude Code offers the Vexday sign-in under /mcp.
claude mcp add --transport http --scope user vexday https://api.vexday.io/mcp \ --header "Authorization: Bearer vx_live_SUA_CHAVE"
CursorConnector or key
- Create an API key in the Vexday dashboard, under Integrations.
- Put the key in the VEXDAY_API_KEY environment variable (in the terminal: export VEXDAY_API_KEY=vx_live_…) and start the app from that terminal.
- Paste the block below into the file and check in Cursor's MCP settings that vexday is on. Without headers, Cursor opens the Vexday sign-in.
File: ~/.cursor/mcp.json (or .cursor/mcp.json in the project)
{
"mcpServers": {
"vexday": {
"url": "https://api.vexday.io/mcp",
"headers": { "Authorization": "Bearer ${env:VEXDAY_API_KEY}" }
}
}
}VS Code com GitHub CopilotConnector or key
This is the new format, shared with the GitHub Copilot CLI. The old format (.vscode/mcp.json, with "servers" instead of "mcpServers" and ${env:VEXDAY_API_KEY}) still works.
- Create an API key in the Vexday dashboard, under Integrations.
- Put the key in the VEXDAY_API_KEY environment variable (in the terminal: export VEXDAY_API_KEY=vx_live_…) and start the app from that terminal.
- Paste the block below into the file. In MCP: List Servers, pick vexday to see its status and output. Without headers, VS Code opens the Vexday sign-in.
File: ~/.copilot/mcp-config.json (or .mcp.json at the project root)
{
"mcpServers": {
"vexday": {
"type": "http",
"url": "https://api.vexday.io/mcp",
"headers": { "Authorization": "Bearer ${VEXDAY_API_KEY}" },
"tools": ["*"]
}
}
}Windsurf (Devin Desktop)Connector or key
Windsurf was renamed Devin Desktop in June 2026. In versions with the old name, the file is ~/.codeium/windsurf/mcp_config.json and the address goes in "serverUrl".
- Create an API key in the Vexday dashboard, under Integrations.
- Paste the block below into the file. In the project's .local.json, the key stays out of git.
- In Customize → MCPs, refresh and check that vexday is on. Without headers, it asks for the Vexday sign-in (Authenticate).
File: .devin/mcp_config.local.json in the project (or ~/.config/devin/mcp_config.json)
{
"mcpServers": {
"vexday": {
"url": "https://api.vexday.io/mcp",
"headers": { "Authorization": "Bearer vx_live_SUA_CHAVE" }
}
}
}ZedConnector or key
In Zed, prefer signing in: it doesn't read environment variables in headers. If you use the key, add "headers": { "Authorization": "Bearer vx_live_SUA_CHAVE" } only in your user settings, never in the project's .zed/settings.json.
- Paste the block below into your user settings (or use Settings → AI → MCP Servers → Add Server → Add Remote Server).
- Click Authenticate and sign in with your Vexday account.
- In Settings → AI → MCP Servers, the vexday dot turns green.
File: ~/.config/zed/settings.json (on Windows, %APPDATA%\Zed\settings.json)
{
"context_servers": {
"vexday": {
"url": "https://api.vexday.io/mcp"
}
}
}OpenCodeConnector or key
- Create an API key in the Vexday dashboard, under Integrations.
- Put the key in the VEXDAY_API_KEY environment variable (in the terminal: export VEXDAY_API_KEY=vx_live_…) and start the app from that terminal.
- Paste the block below into the file and check with opencode mcp list (or opencode mcp debug vexday). To sign in instead, remove "oauth" and "headers" and run opencode mcp auth vexday.
File: ~/.config/opencode/opencode.json (or opencode.json in the project)
{
"$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}" }
}
}
}Other CLIs and automation
Gemini CLIConnector or key
In older Gemini CLI versions, replace "url" and "type" with "httpUrl": "https://api.vexday.io/mcp".
- Create an API key in the Vexday dashboard, under Integrations.
- Put the key in the VEXDAY_API_KEY environment variable (in the terminal: export VEXDAY_API_KEY=vx_live_…) and start the app from that terminal.
- Paste the block below into the file and check with gemini mcp list (Connected) or /mcp in a chat. To sign in with your Vexday account instead of the key, remove "headers" and run /mcp auth vexday in a chat.
File: ~/.gemini/settings.json (or .gemini/settings.json in the project)
{
"mcpServers": {
"vexday": {
"url": "https://api.vexday.io/mcp",
"type": "http",
"headers": { "Authorization": "Bearer ${VEXDAY_API_KEY}" }
}
}
}Codex CLI (OpenAI)Connector or key
The same config applies to the Codex extension in your editor.
- Create an API key in the Vexday dashboard, under Integrations.
- Put the key in the VEXDAY_API_KEY environment variable (in the terminal: export VEXDAY_API_KEY=vx_live_…) and start the app from that terminal.
- Paste the block below into the file and check with codex mcp list or /mcp. Without the key line, codex mcp login vexday opens the Vexday sign-in.
File: ~/.codex/config.toml
[mcp_servers.vexday] url = "https://api.vexday.io/mcp" bearer_token_env_var = "VEXDAY_API_KEY"
n8nConnector or key
Needs n8n 1.104 or newer (HTTP Streamable). To sign in instead, use Authentication: MCP OAuth2.
- Create an API key in the Vexday dashboard, under Integrations.
- In the AI Agent node, under Tool, add the MCP Client Tool.
- Endpoint: https://api.vexday.io/mcp; Server Transport: HTTP Streamable.
- Authentication: Bearer Auth, with a new credential. In Bearer Token, paste just the key (vx_live_…), without Bearer: n8n adds it.
- In Tools to Include, choose Selected: if the Vexday tools show up in the list, the connection works.