Connecting ChatGPT to Virtarix with MCP

Wire ChatGPT or the OpenAI Codex CLI to Virtarix VPS tools through MCP. Use Access Token / Bearer authentication against https://api.virtarix.com/mcp/vps.

Before you start

  • A Virtarix client account and a Passport personal access token.
  • ChatGPT on a plan that supports custom MCP connectors/apps, and/or the Codex CLI.
Bearer only. Virtarix does not currently expose an OAuth MCP authorization URL. When creating a ChatGPT connector, choose Access Token / API key with the Bearer scheme—not OAuth.

Using Claude instead? See Connecting Claude via MCP. General transport notes: Connecting via MCP.

Connect via ChatGPT

Exact menu labels can move as ChatGPT ships UI updates; the flow below matches the developer connector pattern.

1
Enable developer features

In ChatGPT settings, turn on Developer mode (or the equivalent that unlocks custom apps / MCP connectors).

2
Create a connector

Give it a clear name such as Virtarix VPS and a short description like “Manage my Virtarix virtual servers and orders.” The description helps the model decide when to call the tools.

3
Enter the MCP URL and token
Connection URL
https://api.virtarix.com/mcp/vps

Under authentication, select Access Token / API key, set the header scheme to Bearer, and paste your Virtarix access token.

4
Test in a new chat

Ask: “Show me all my VPS services on Virtarix.” You should get a list from list-vps without using SSH.

Connect via Codex CLI

Codex stores MCP configuration in TOML—useful for terminal workflows and automation.

1
Install Codex (if needed)
Terminal
# requires Node.js 18+
npm install -g @openai/codex
2
Add the Virtarix server

Edit ~/.codex/config.toml (or .codex/config.toml in a project):

config.toml
[mcp.servers.virtarix-vps]
type = "http"
url  = "https://api.virtarix.com/mcp/vps"

[mcp.servers.virtarix-vps.headers]
Authorization = "Bearer YOUR_ACCESS_TOKEN"
3
Verify inside Codex

Launch Codex and run /mcp. You should see virtarix-vps connected to the Virtarix URL.

4
Start giving instructions

Codex can manage infrastructure alongside coding tasks—deploy, then reboot, in one conversation.

What you can say

  • List all my VPS services and their IP addresses.
  • Reboot my main Virtarix VPS after I confirm.
  • Show firewall rules for service 9105.
  • Create a backup of service 9105 before I deploy.
  • What is the power state of each VPS right now?
  • Browse the catalogue and explain the Johannesburg Linux plans.

More on tool groups and confirm: true in Using agents.

Security notes

  • Do not share your token or commit ChatGPT/Codex configs that embed it.
  • Prefer secrets managers or env injection where available.
  • Rotate the token yourself if you believe it was exposed.
Security reminder: Virtarix support will never ask you for your access token.