ChatGPT

There are two ways to add Ranktide to ChatGPT:

• The Ranktide plugin includes the MCP tools and the SEO skills. Use it when it's available for your account.
• A custom connection adds the MCP tools only. Use it when the plugin isn't available to you, or to connect a self-hosted Ranktide server.

Both sign in to Ranktide with OAuth, so you don't need an API key. ChatGPT chats and Codex use separate connections. To use Ranktide in Codex, see Codex.

Install the Ranktide plugin

1. Open the Ranktide plugin for ChatGPT and select Install plugin.
2. Sign in to Ranktide, pick your organisation and approve the connection.
3. Start a new chat. Type @ and select Ranktide, or select + and choose it.
4. Send the connection check.

The plugin works in ChatGPT on the web and in the desktop app. Whether you can install it depends on your ChatGPT plan, workspace and region. If you can't, use a custom connection.

Custom connection

OpenAI decides which ChatGPT plans can add custom MCP servers, and the list changes. On Business, Enterprise and Edu workspaces, an admin may need to allow it. Add the server on chatgpt.com. To use it in the ChatGPT desktop app, add it on the web first.

1. Go to ChatGPT Plugins.
2. Select +, then Add custom MCP server.
3. Name it Ranktide.
4. Under Connection, enter https://app.ranktide.io/mcp. Type the full URL, including https://.
5. Choose OAuth for authentication. If ChatGPT offers a registration method, choose dynamic client registration. You don't need a client ID or secret.
6. Review the risk warning and select I understand and want to continue.
7. Select Create as a plugin and review the Ranktide tools ChatGPT found.
8. Install the new plugin, then sign in to Ranktide and approve the connection.
9. Start a new chat, type @ and select Ranktide.

Older versions of ChatGPT put this under Settings → Apps → Create instead. Menu names in ChatGPT change often. If yours differ, follow OpenAI's connection guide with the same server URL.

A custom connection adds Ranktide's tools, not its skills. To add the skills, see the next section.

Add the skills

The Ranktide plugin already includes the skills. With a custom connection, you can upload them if your workspace has ChatGPT skills turned on. OpenAI offers skills on Business, Enterprise, Healthcare and Edu workspaces.

1. In ChatGPT, select Plugins in the sidebar and open the Skills tab.
2. Select Create, then Upload from your computer.
3. Choose a skill's zip from the skills page. If ChatGPT asks for a folder, unzip it first and choose the skill's folder.
4. Repeat for each skill. Upload the SEO report skill along with any others: the other skills use it to save their reports.

To use a skill, type @ and select it, or ask for it by name.

Check the connection

Send this in a new chat with Ranktide selected:

Use Ranktide to check my connection and list my projects. Don't run any research.

ChatGPT should return your account, credit balance and projects. These calls use no credits.

Update Ranktide

Ranktide updates its tools on the server. How you load the latest version depends on how you connected:

• Ranktide plugin: start a new chat to load the latest tools and skills. Reconnect only if ChatGPT asks you to sign in again.
• Custom connection: go to ChatGPT Plugins, open the Ranktide connection and select Refresh. Then start a new chat. Refresh updates the tools, not skills you uploaded.
• Uploaded skills: remove the old version from the Skills tab and upload the new zip from the skills page.

On Enterprise and Edu workspaces, a published workspace plugin keeps the tools it was published with until an admin refreshes it in the workspace settings.

Troubleshooting

For anything else, see the MCP reference or email support@ranktide.io.