Connect ConvertSite MCP to Codex
Connect Codex to ConvertSite through the MCP server to build, edit, and check projects directly in ConvertSite. The MCP server lives at https://convertsite.com/mcp and authenticates with an API key you generate in ConvertSite.
Step 1: Create an API key
Generate an API key in ConvertSite to authenticate the MCP connection. Each key is scoped to one workspace and should be treated like a password.
In ConvertSite, go to Workspace Settings → Integrations.
Scroll to the API keys section.
Enter a label in the Label (optional) field — for example, "Codex" — so you can tell which key belongs to which tool.
Click Generate API key.
Copy the key immediately. It is shown only once at creation, and ConvertSite stores it hashed.
Store your API key securely. You will not see it again after creation. If you lose it, revoke the old key and generate a new one.
You can revoke any key at any time from the same page. Revoking a key invalidates it immediately. Each key also shows a last-used date, updated at most hourly, so you can confirm whether a tool is actively using it.
Step 2: Add the MCP server to Codex
Ask Codex to add the ConvertSite MCP server using the server URL and your API key. Codex supports MCP servers and handles the configuration when you provide the details.
Give Codex these two pieces of information:
Server URL:
https://convertsite.com/mcpAuthorization header:
Authorization: Bearer [your API key]
Ask Codex to add an MCP server with the URL https://convertsite.com/mcp and the Authorization header Bearer [your API key]. Codex adds the server and verifies the connection.
Use this prompt and make sure to replace the API key:
Add MCP server with the following:
https://convertsite.com/mcp
Headers:
Authorization: Bearer {API KEY HERE}
Restart after adding the server
In Codex, the bearer token is stored in config.toml. Restart Codex or open a new task so the server becomes available.
Create a separate API key for each tool (for example, one labeled "Codex" and one labeled "Claude"). This lets you revoke one tool's access without affecting the other.
Why use the MCP over the built-in AI
ConvertSite includes a built-in AI assistant that builds sites through a chat conversation inside ConvertSite, using AI credits tied to your plan. Connecting the MCP lets you use the AI subscription you already have — such as Claude or Codex — instead of consuming ConvertSite AI credits.
Save your ConvertSite AI credits
The MCP uses your existing AI subscription instead of consuming ConvertSite AI credits. This makes larger projects and repeated revisions more affordable.
Bring all your project context
Your AI tool can use reference files the built-in assistant cannot — Excel models, documents, PDFs, screenshots, and other files you upload to the chat. Depending on the AI application you use, the assistant can also research websites and current information online.
Build directly in ConvertSite
The assistant turns your instructions and reference materials into real sites, forms, calculators, quote tools, quizzes, and configurators — without rebuilding everything manually.
Make smarter, more precise changes
The assistant can inspect your existing structure, styles, formulas, defaults, and interactions before editing. This helps it change what you asked for while preserving the rest of your site.
Check and improve the result
The assistant can review desktop and mobile layouts, calculations, interactions, conditional states, and conversion actions — and fix issues it finds.
Why connect before starting
Connecting the MCP before you start building lets the assistant use your source material and the real ConvertSite structure from the beginning. This reduces duplicate work and makes validation part of the build process rather than an afterthought.
After connecting
Return to your AI assistant and describe what you want to build. The assistant will use the ConvertSite MCP to create and edit your project directly.
For details on how API keys work across ConvertSite, see the Convert Zapier API reference.
Using Claude instead? See Connect ConvertSite MCP to Claude.