Connect ChatGPT
Connect RankX AI to ChatGPT as a custom connector using OAuth. The steps, the owner requirement, and the one status message that is not ours.
ChatGPT connects to RankX AI as a custom connector, using OAuth. Add the
connector, paste https://app.rankxai.com/api/mcp, leave the client id and
secret empty, and sign in. There is no header field in ChatGPT's connector
settings, so OAuth is the only way in.
Connecting
Open your connector settings
In ChatGPT, open Settings and find Connectors. Adding a custom connector may require developer mode or a paid plan depending on your ChatGPT account; that is a ChatGPT setting rather than a RankX AI one.
Add the endpoint
https://app.rankxai.com/api/mcpLeave the client id and client secret empty. RankX AI registers your client automatically, which is what the protocol expects for a public client.
Sign in and approve
You are sent to RankX AI to sign in. The consent screen names every capability it asks for and badges the ones that touch a live public website.
Only an account owner can approve. If you are not the owner, the screen says so rather than half-connecting.
Check it worked
Ask:
"Using RankX AI, list my websites."
It should call list_projects and return them.
What the connection can do
An OAuth connection is granted the full capability set in one decision, so a connected ChatGPT can read everything, create prompts and tasks, spend credits with your confirmation, and publish to a connected WordPress site.
Two safeguards travel with it and neither is optional:
- Every spend tool resolves its current price into its own description, and the server instructs the assistant to check your balance and confirm with you before calling one.
- Every WordPress write dry-runs first. The assistant gets the exact before and after, and applying it is a second, explicit call.
A status message that does not come from RankX AI
If ChatGPT's connector panel shows your connector as being in a development or unreviewed state, that is ChatGPT's own record of your connector, not anything RankX AI emits. It describes a connector you registered yourself that has not been through ChatGPT's own publishing flow. Nothing in RankX AI produces it and no change on our side clears it: it is an account step in ChatGPT.
Disconnecting
Remove the connector in ChatGPT, and disconnect it in RankX AI's MCP settings under connected apps. Use the second if you think the credential has leaked: it kills the connection and its current access token together.
Where to go next
- Examples for prompts that work.
- Authentication for what the connection is allowed to do.
- Troubleshooting if the connector will not attach.
Connect Claude Code
One command connects Claude Code to RankX AI, with either OAuth or a personal access token. Both forms, and when to pick which.
Connect Cursor, VS Code and Windsurf
Add RankX AI to an editor's MCP configuration with a bearer token. The three config blocks, whose key names differ, and how to keep the token out of git.