By Ira Bodnar, Ryze AI · Updated · Connector tested November 19, 2026
Quick answer
The main way to connect ChatGPT to Ahrefs is the Ryze AI connector. Save an Ahrefs API key in a Ryze AI workspace, then add https://connector.get-ryze.ai/mcp as a custom MCP server in ChatGPT Plugins with OAuth, allow the workspace and start a new conversation. Ahrefs also hosts its own MCP server at https://api.ahrefs.com/mcp/mcp and documents a ChatGPT Web setup for it, compared below.
- In Ahrefs open Account settings, then API keys, and generate a key
- In Ryze AI open Integrations, click Connect on the Ahrefs card and paste the key
- In ChatGPT open Plugins, add a custom MCP server with the URL and OAuth
- Sign in to Ryze AI, click Allow connection, install the plugin and start a new conversation
ChatGPT to Ahrefs at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector. ChatGPT adds its address as a custom MCP server, and the Ahrefs key stays in Ryze AI instead of ChatGPT |
| Server address | https://connector.get-ryze.ai/mcp |
| Sign-in | OAuth with Ryze AI. ChatGPT cannot present a custom API key, so the Ahrefs key is saved in the Ryze AI app |
| Ahrefs tools | 1: ahrefs__read, a read-only Ahrefs API v3 GET request |
| Can it change Ahrefs | No. The one Ahrefs tool only sends GET requests |
| Other data in the same chat | Tools for the other platforms connected in the same Ryze AI workspace come from the same address |
| ChatGPT plan | OpenAI names Business and Enterprise/Edu for full MCP and Pro for read and fetch. Its help article is silent on Free, Go and Plus |
| Ahrefs access | An Ahrefs plan with API access and a key made by a workspace owner or admin. Calls spend your own Ahrefs API units |
| Ryze AI price | SEO Starter is $129 a month with a 3-day free trial. Paid Ads is $89 a month with a 7-day free trial. Adding the connector is free |
| Ahrefs's own option for ChatGPT | A hosted MCP server at https://api.ahrefs.com/mcp/mcp on plans from Lite, with a ChatGPT Web setup guide |
| Last tested | Connector address tested on November 19, 2026. No step inside ChatGPT and no Ahrefs call was run |
Before you start
- A ChatGPT plan with custom MCP. OpenAI's help article gives full custom MCP server support to Business and Enterprise/Edu customers using ChatGPT on the web, and read and fetch access to Pro users. It says nothing about Free, Go or Plus. Business restricts creating and publishing these plugins to admins and owners. Enterprise/Edu lets admins and owners do it, and admins can hand the permission to members through RBAC.
- An Ahrefs API key from an owner or admin. Per Ahrefs, only workspace owners and admins can open the API keys section, and a plan without API access is rejected. You choose an expiration date for each key when you create it.
- A Ryze AI workspace on a plan or free trial. SEO Starter costs $129 per month with a 3-day free trial, and Paid Ads costs $89 per month with a 7-day free trial. Connecting costs nothing, yet without a plan the connector can only list workspaces and connect platforms, so the Ahrefs tool stays locked.
How to connect ChatGPT to Ahrefs with Plugins
Steps 1 and 2 happen in Ahrefs and Ryze AI, steps 3 to 6 in ChatGPT on the web. The connector URL is the same for every user.
Generate an API key in Ahrefs
In Ahrefs open Account settings, then API keys, click Generate API key, name it (for example Ryze AI) and copy it. Only workspace owners and admins can do this.
Connect Ahrefs in Ryze AI
In the Ryze AI app open Integrations, click Connect on the Ahrefs card, paste the key into API key and click Continue. You can also ask the Ryze AI agent to connect Ahrefs: it sends a one-time link, valid once and for 24 hours, to a page where you paste the key.
Add a custom MCP server in ChatGPT
Open chatgpt.com/plugins in a browser, press the plus button and pick Add custom MCP server. Call it Ryze AI and, under Connection, give it the public URL https://connector.get-ryze.ai/mcp. OpenAI says Developer Mode is not a prerequisite for this flow, although account and workspace policies can still block it.
Pick OAuth and create the plugin
Set authentication to OAuth. A risk warning appears: tick I understand and want to continue, press Create as a plugin and look through the tools ChatGPT found on the server.
Sign in to Ryze AI and allow the workspace
ChatGPT sends you to Ryze AI when it needs a sign-in. Log in, pick the workspace that holds Ahrefs and click Allow connection. One connection reaches up to 20 workspaces. OpenAI does not say exactly when this screen shows up: some plugins ask at install time, others at the first tool call.
Install the plugin and ask your first question
Install the plugin, begin a new conversation, type @ and choose Ryze AI. A first question to try: What is the Domain Rating of the domain I name, and how many referring domains does it have?
The Ryze AI help center Ahrefs article covers the Ahrefs side of the connection, and the Ryze AI help center ChatGPT guide covers the ChatGPT side. OpenAI documents the same flow in Connecting custom MCP servers in ChatGPT.
The older Settings, Apps flow
Some accounts still show the earlier custom app flow under Settings, Apps, and OpenAI keeps documenting it. The Ryze AI help center and Ahrefs's own ChatGPT page both describe it with a Developer mode switch under Advanced settings. None of the OpenAI pages read on November 14, 2026 mention that switch, and OpenAI says the Plugins flow does not need Developer Mode first.
- Choose Create under Apps. Admins and owners find it in Workspace settings, authorized members in their own settings.
- Type https://connector.get-ryze.ai/mcp as the endpoint, fill the other fields the form shows and name it Ryze AI.
- Select OAuth as the authentication mechanism.
- Press Scan Tools. OpenAI puts the OAuth prompt in this step: log in to Ryze AI, pick the workspace with Ahrefs, click Allow connection and wait for the scan to end.
- Press Create. The draft appears under Settings, Apps, Enabled Apps with a Dev label.
- Open a new chat.
Either flow finishes on the same Ryze AI sign-in page, and OpenAI's plan rule covers both. Nothing here claims Plus accounts can connect.
Business and Enterprise/Edu publishing
In a Business or Enterprise/Edu workspace, an admin or owner sets up Ryze AI and tests it, then publishes it for everyone else.
- The admin or owner adds Ryze AI as described above and confirms the Ahrefs tool is listed.
- To publish, go to Admin Console, choose the workspace, then Plugins, Manage Legacy Apps, Drafts and press Publish. Read the safety warnings shown for write actions.
- Enterprise/Edu admins also get Configure Actions and Configure Access ahead of publishing.
- Members then look under Settings, Plugins.
OpenAI says ChatGPT works from a frozen snapshot of a server's tools once an admin approves it for a workspace. If Ahrefs is connected in Ryze AI after that, an admin must refresh and publish an update before members get the Ahrefs tool.
What OpenAI documents about custom MCP servers in ChatGPT
| Question | What OpenAI documents |
|---|---|
| Where a server goes in | Plugins on the web app (chatgpt.com/plugins), plus button, Add custom MCP server. OpenAI excludes mobile for this step |
| Config file | None for web chats. The config.toml OpenAI documents belongs to the Codex host, and ChatGPT web ignores it |
| Transports | SSE and streaming HTTP, reachable at a public HTTPS address or through a tunnel. There is no field for a command that launches a local program |
| Sign-in | OAuth with PKCE (S256), no authentication, or a mix. OpenAI says ChatGPT cannot send a custom API key, so the Ahrefs key stays in Ryze AI |
| Tool approval | Write actions on a custom MCP server wait for your confirmation by default, and any tool lacking the readOnlyHint annotation counts as a write action |
| Permission settings | Settings, Plugins, Permissions lists Always ask, Allow read actions and Allow low-risk actions |
| Plan | Full MCP for Business and Enterprise/Edu, read and fetch for Pro. The developer pages for this flow name no plan |
| Pricing page row | A Developer mode (beta) row shows Yes for Plus, Pro, Business and Enterprise and No for Free and Go. The page never explains the row or mentions MCP, so it is not read here as Plus support |
| Who may add one | Business: admins and owners. Enterprise/Edu: also members who hold the Create plugins with MCPs permission |
| Using it in a chat | Type @ and choose Ryze AI. The choice covers one message, so repeat it when a follow-up needs fresh Ahrefs data |
| Managing the connection | Settings, Plugins lists the connected account with Reconnect and Disconnect. A server you added yourself has a Refresh action that pulls new tools |
Sources: OpenAI's help article on custom MCP servers, Add custom MCP server guide, plugin authentication guide, app permissions article, app accounts article and pricing page. Checked November 14, 2026.
Other AI clients
The same URL works in other MCP clients. Ahrefs is connected once in Ryze AI, so nothing changes on the Ahrefs side.
Claude
In claude.ai open Customize, Connectors, click + Add, choose Add custom connector, enter the name Ryze AI and the URL, and click Connect. Ahrefs stays connected in Ryze AI, so the key step is not repeated.
Cursor
Add the server to .cursor/mcp.json, then sign in on the Ryze AI page when Cursor asks.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }Ahrefs key and access
Two sign-ins are involved: Ryze AI for the connector, and an Ahrefs API key that Ryze AI stores for your workspace. Three things decide what ChatGPT can reach.
- Which Ahrefs account
- The one whose API key you pasted into Ryze AI. A workspace holds one Ahrefs connection. To switch keys, click View on the Ahrefs card in Ryze AI, disconnect with the trash icon and connect again. Another Ryze AI workspace can hold a different key.
- What the key allows
- Ahrefs says keys are made in Account settings, API keys, that only owners and admins can open that section, and that a key is invalidated if the user who created it is removed from the workspace.
- What ChatGPT asks first
- The Ahrefs tool only reads, so nothing in Ahrefs can change. ChatGPT may still ask before a call, depending on your permission setting and plan.
What the Ahrefs key covers
Ryze AI lists no OAuth scopes for Ahrefs. Access comes from the API key and the Ahrefs plan behind it. The table shows what each part decides.
| Part | What it decides | Where it is set |
|---|---|---|
| API key | Which Ahrefs workspace is read | Account settings, API keys, by an owner or admin |
| Ahrefs plan | Whether the API accepts the call at all | A plan without API access is rejected |
| API units | How many calls fit in a month | Each call draws on your own monthly Ahrefs unit balance, not Ryze AI credits |
| Per-key unit limit | A cap on one key's usage | Set by workspace admins in Account settings, API keys, and in Limits & usage |
| Ryze AI plan or trial | Whether the Ahrefs tool runs | Without one the connector can only list workspaces and connect platforms |
The Ryze AI tool is GET only, so the key's role is the one limit that matters for reading: whatever the Ahrefs workspace lets that key see is what ChatGPT can ask for.
Not included: any change to Ahrefs. The tool cannot edit Rank Tracker projects, keyword lists or Brand Radar settings. Ahrefs's own MCP server has a management group for those, and the Ryze AI connector does not expose it.
Sources: Ahrefs' API keys page and the Ryze AI help center Ahrefs article. Checked November 19, 2026.
Removing access
To cut access, delete the key in Ahrefs under Account settings, API keys, and disconnect Ahrefs from its card in Ryze AI. In ChatGPT open Settings, Plugins, choose Ryze AI and press Disconnect next to the connected account. Two OpenAI pages disagree on whether uninstalling a plugin ends the connection, so disconnect first and uninstall afterward.
What ChatGPT can do in Ahrefs
The Ryze AI connector exposes 1 Ahrefs tool. It runs with the key you saved.
| Tool | Type | What it does |
|---|---|---|
| ahrefs__read | Read | Runs a read-only Ahrefs API v3 GET request, for example Domain Rating, site metrics, referring domains, backlinks, broken backlinks, anchors, organic keywords, a Keywords Explorer overview, or API limits and usage. |
OpenAI words Pro access as read and fetch permissions, which fits a tool that only reads. On a custom MCP server ChatGPT asks you to confirm write actions by default, and some risky actions may be blocked. To be asked before every call, set Settings, Plugins, Permissions to Always ask. In the Ryze AI chat, the Tool approvals picker starts on Skip all approvals, and scheduled tasks run without an approval step.
Ahrefs limits in numbers
Published limits from Ahrefs, plus a note on OpenAI's side, read on November 19, 2026 (OpenAI pages on November 14, 2026). None was measured for this guide.
| Limit | Value |
|---|---|
| Cost of one request | max(base cost, per-row cost x rows). The base cost is 50 units. |
| Per-row cost | The summed cost of each unique field in the result, the filter or the sort. A field costs 1 unit by default and some cost 5 or 10. |
| Ahrefs's own examples | Domain Rating returns 2 fields in 1 row, below the base cost, so it costs 50 units. A backlinks request with 12 units per row and 500 rows costs 6,000 units. |
| Cached results | A request served from cache uses no units. |
| Free test queries | Site Explorer calls for ahrefs.com, yep.com or firehose.com are free on any paid plan, as are Keywords Explorer calls whose only keyword is ahrefs, yep or firehose. |
| Monthly allowance | Set by your Ahrefs plan. Enterprise customers can buy more units. Usage shows in Account settings, Limits & usage. |
| Keys | Up to 1,000 API keys, each with an expiration date between today and 10 years out. A hand-made key has no per-key unit limit by default. |
| Ahrefs's own MCP server | Keys made through OAuth for Ahrefs MCP default to 200,000 units a month per key. This applies to api.ahrefs.com/mcp/mcp, not to the Ryze AI connector. |
| On ChatGPT's end | OpenAI states no maximum of tools on one server and no maximum of custom servers on an account. |
Sources: Ahrefs' limits consumption page, free test queries page, API keys page and MCP introduction, and OpenAI's pricing docs. Checked November 19, 2026.
First 3 prompts to run
Each prompt describes what to ask. Answers come from your own Ahrefs account, so this page shows no sample numbers.
1. Check a site's authority and links
Use the Ryze AI Ahrefs tool. What is the Domain Rating of the domain I name, and how many referring domains and backlinks does it have?
Tools used: ahrefs__read
What comes back: The Domain Rating and the link counts Ahrefs reports for that target. Nothing is changed. Naming the tool in the prompt helps ChatGPT pick it.
2. List broken backlinks
List five broken backlinks pointing at my domain, with the linking page and the missing page.
Tools used: ahrefs__read
What comes back: Broken backlinks as Ahrefs returns them. Asking for five rows keeps the unit cost down, because each row uses API units.
3. Pull organic keywords
List the organic keywords my domain ranks for, then show the Keywords Explorer overview for three of them in the United States.
Tools used: ahrefs__read
What comes back: The organic keywords Ahrefs holds for the site, then overview data for the keywords you chose in that country.
Replace the placeholders with your own domain. Ahrefs's own ChatGPT page advises explicit prompts that name the connector, the action and the fields, and that tell ChatGPT not to use web search. That advice is Ahrefs's, written for its own server.
10 jobs to hand to ChatGPT
Ten jobs for ChatGPT once Ryze AI is installed as a plugin, each beside the tool it calls. All ten use the one Ahrefs tool, and none changes anything in Ahrefs. None of them was run for this guide.
| Job | Ask ChatGPT | Tool | Changes Ahrefs |
|---|---|---|---|
| Authority check | What is the Domain Rating of this domain? | ahrefs__read | No |
| Link profile summary | Show the backlink and referring-domain counts for this domain. | ahrefs__read | No |
| New referring domains | List five referring domains for this site. | ahrefs__read | No |
| Backlinks to one page | List five backlinks to this URL. | ahrefs__read | No |
| Broken backlinks | Which broken backlinks point at my domain? | ahrefs__read | No |
| Anchor text | Show the anchor texts used for links to my domain. | ahrefs__read | No |
| Ranking keywords | List the organic keywords this site ranks for. | ahrefs__read | No |
| Keyword overview | Give me the Keywords Explorer overview for these keywords in this country. | ahrefs__read | No |
| Subdomain, path or URL metrics | Show site metrics for this subdomain, this path and this exact URL. | ahrefs__read | No |
| Budget check | Check my Ahrefs API limits and units used. | ahrefs__read | No |
Because the tool only reads, the Pro limit of read and fetch permissions does not stop any of these jobs.
3 ways to connect ChatGPT to Ahrefs
This guide covers three ways to give ChatGPT Ahrefs data. The Ryze AI connector is the main way here: the Ahrefs key is saved once in Ryze AI, and ChatGPT needs one address and an OAuth sign-in. The second is the server Ahrefs hosts itself, which has a ChatGPT Web page in its docs. The third does not fit ChatGPT. Ahrefs's pages were read on November 19, 2026 and none of the routes was run for this guide.
| Way | Runs where | Setup in ChatGPT | What it reaches in Ahrefs | Price and units |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI as a remote MCP server | Plugins, the plus button, Add custom MCP server, https://connector.get-ryze.ai/mcp and OAuth. The Ahrefs key goes into Ryze AI, never into ChatGPT | One read tool for Ahrefs API v3: Domain Rating, site metrics, backlinks, broken backlinks, referring domains, anchors, organic keywords, Keywords Explorer overview, API limits and usage | SEO Starter $129 a month with a 3-day free trial, or Paid Ads $89 a month with a 7-day free trial. Calls spend your Ahrefs API units |
| Ahrefs MCP server (Ahrefs's own) | Hosted by Ahrefs at https://api.ahrefs.com/mcp/mcp | Ahrefs's ChatGPT Web page: Settings, Apps, Advanced settings, turn on Developer mode, Create app, enter the URL, choose OAuth, leave the client ID and secret blank, then Allow | Tool groups for Site Explorer, Keywords Explorer, SERP Overview, Rank Tracker, Site Audit, Brand Radar, Web Analytics, Google Search Console data, social media, Content Helper, batch analysis, account management and subscription info | Needs an Ahrefs plan from Lite. Calls use your plan's monthly API units. OAuth keys default to 200,000 units a month per key |
| Ahrefs REST API with your own code | Your own scripts | Not an MCP route. Ahrefs says its MCP endpoint is not a general-purpose API | Everything in API v3, with a key in the Authorization header | Needs API access on your plan. Calls use API units |
Ahrefs's ChatGPT Web page describes Full MCP client access as in beta, available in Developer mode for Pro and Plus accounts on the web. OpenAI's own help article names Business and Enterprise/Edu for full MCP and Pro for read and fetch, and does not mention Plus, so the two vendors word the plan differently and this guide follows OpenAI. Ahrefs's server also advertises more tools than some clients accept, and lets you pick groups with a tools parameter on the URL, for example ?tools=essentials. Whether ChatGPT needs that parameter was not tested.
Three options that do not fit ChatGPT
- Scripts against Ahrefs's MCP address. Ahrefs states that using its external MCP endpoint through custom scripts, bridges or standalone HTTP and JSON-RPC clients is unsupported and not permitted. Use the REST API for code.
- An Ahrefs key in a header. ChatGPT's custom MCP form offers OAuth, no authentication or a mix, and OpenAI says ChatGPT cannot present custom API keys. Ahrefs documents a manually made MCP key for clients that take one, which gives ChatGPT's form no place to put it.
- A local server on your computer. The form takes a public URL or a tunnel, never a command that starts a program, and ChatGPT web does not read a local config file.
Which one to pick
Ryze AI is the best way to connect ChatGPT to Ahrefs when you want Ahrefs next to your other Ryze AI platforms behind one address, with one caveat: it has one read tool for Ahrefs, while Ahrefs's own server offers many tool groups, including Site Audit, Rank Tracker and Brand Radar. Pick the Ahrefs server when Ahrefs data is all you need in ChatGPT or you want those groups. Both draw on the same Ahrefs API units.
Sources: Ahrefs' MCP introduction, ChatGPT Web setup guide and tool categories page. OpenAI's help article on custom MCP servers and plugin authentication guide. Ryze AI help center Ahrefs article. Checked November 19, 2026.
ChatGPT, Ahrefs and MCP: dates that matter
| Date | What happened |
|---|---|
| June 4, 2025 | The earliest custom connector entry in OpenAI's release notes: connectors over MCP, in deep research only, on Pro, Team, Enterprise and Edu. |
| October 17, 2025 | OpenAI's release notes list full MCP support with developer mode, in beta, for Business, Enterprise and Edu. |
| July 9, 2026 | ChatGPT's Plugin Directory replaces the App Directory. Existing app connections are unaffected. |
| October 1, 2026 | OpenAI's Business release notes list plugin management in Admin console, including the Manage Legacy Apps link used in the publishing steps above. |
| November 19, 2026 | Ahrefs's MCP documentation describes a hosted server for users on a Lite plan or higher, with a ChatGPT Web setup page that calls MCP client access in ChatGPT a beta. |
OpenAI's release notes carry no dated entry for the move of Add custom MCP server into Plugins, and the Ahrefs pages give no launch date for the MCP server.
Sources: ChatGPT release notes, ChatGPT Business release notes and Ahrefs' ChatGPT Web setup guide. Checked November 19, 2026.
How this guide was tested
On November 19, 2026, at about 15:28 UTC, one request went to the live connector address and its OAuth discovery file was read. Ryze AI details come from the help center and app source. All other statements are a reading of Ahrefs and OpenAI pages.
| What was checked | Result |
|---|---|
| https://connector.get-ryze.ai/mcp, asked without a sign-in | HTTP 401 plus a WWW-Authenticate header that names the resource metadata address. OpenAI's authentication guide treats that header as how ChatGPT finds a server's sign-in details. |
| The connector's OAuth discovery file | Loaded fine. It names authorize, token and register endpoints, the authorization code and refresh token grants, the code challenge methods plain and S256, and the scopes mcp:read and mcp:write. S256 is the method OpenAI requires. |
| Calls to Ahrefs | None, because no Ahrefs account was connected for this build. |
| The ahrefs__read tool name | Never seen in a live tool list. The name comes from the Ryze AI app source. |
| The Plugins steps in ChatGPT | None. No server was added, no sign-in finished and no tool was called inside ChatGPT. |
Skipped on purpose: every step inside ChatGPT and every call to Ahrefs. The ChatGPT steps repeat OpenAI's pages as read on November 14, 2026. Because no Ahrefs call ran, there is no table of tested calls and no error text copied from a test. One question is open. OpenAI wants servers to advertise offline_access so a connection survives its first token. The discovery file shows a refresh token grant and only the scopes mcp:read and mcp:write, so how long ChatGPT stays signed in is unknown.
Ahrefs errors and fixes
- ChatGPT has no Add custom MCP server option
- Your plan may not be one OpenAI lists: Business or Enterprise/Edu get full support and Pro gets read and fetch only. On Business, ask an admin or owner to add it. Adding a custom server also works only on the web, never on mobile.
- Ryze AI says the Ahrefs key is rejected
- A plan without API access is rejected. Check the plan, that the key is still active under Account settings, API keys, and that the person who made it is still in the workspace.
- Calls stop working during the month
- You may have used your Ahrefs API units or a per-key limit. Ask ChatGPT for your API limits and usage, or open Account settings, Limits & usage in Ahrefs.
- The Ahrefs tool does not appear in ChatGPT
- ChatGPT holds the tool list from the moment the server was added. When Ahrefs was connected in Ryze AI later, remove the app, install it again and open a new conversation. A server added directly can also use Refresh in Plugins.
- ChatGPT answers from the web instead
- Name the Ryze AI Ahrefs tool in the prompt, type @ and pick Ryze AI first, and ask it not to use web search.
- A Business member cannot see Ryze AI
- Until an admin or owner publishes it for the workspace, members will not see it. New tools need an admin refresh and a published update.
- The tools say a subscription is required
- The Ahrefs tool runs only on an active Ryze AI plan or free trial. Begin the trial in Ryze AI and try again.
- The one-time connection link is refused
- The link is refused while Ahrefs is already connected in that workspace. Change the key in the Ryze AI app: View, disconnect, then connect again.
Terms on this page
- MCP
- The Model Context Protocol, a standard for tools an AI client can call. ChatGPT on the web reaches tools like ahrefs__read through plugins.
- Custom MCP server
- A server you give ChatGPT as a URL. ChatGPT wraps it in a plugin, and older OpenAI pages call the result an app or a connector.
- API unit
- Ahrefs's measure of API use. Each request costs at least 50 units, and your plan gives a monthly allowance.
- Domain Rating
- Ahrefs's score for the strength of a site's backlink profile.
- Referring domain
- A separate site that links to your site, counted once however many links it has.
- Backlink
- A link from another page to your page. A broken backlink points at a page that no longer loads.
- Keywords Explorer
- The Ahrefs tool for keyword research. Its overview data is for a keyword in a chosen country.
Sources: Ahrefs' API introduction and limits consumption page, and OpenAI's MCP docs. Checked November 19, 2026.
Frequently asked questions
How do I connect ChatGPT to Ahrefs?
Generate an Ahrefs API key under Account settings, API keys, save it on the Ahrefs card in Ryze AI, then open Plugins in ChatGPT on the web, add a custom MCP server named Ryze AI with the URL https://connector.get-ryze.ai/mcp and OAuth, allow the workspace, install the plugin and start a new conversation.
Is there an Ahrefs connector for ChatGPT?
Ahrefs hosts its own MCP server at https://api.ahrefs.com/mcp/mcp and documents a ChatGPT Web setup page for it. This guide did not find a listing for it in ChatGPT's plugin directory, which needs a signed-in account to browse. The Ryze AI connector at https://connector.get-ryze.ai/mcp is the other route and has 1 Ahrefs tool.
What is the Ahrefs MCP server URL?
Ahrefs's own server is a Streamable HTTP server at https://api.ahrefs.com/mcp/mcp. The Ryze AI connector uses https://connector.get-ryze.ai/mcp, the same for every user.
Which should I use, Ryze AI or Ahrefs's own MCP server?
Use Ahrefs's own server when Ahrefs data is all you need or you want groups such as Site Audit, Rank Tracker or Brand Radar. Use the Ryze AI connector when you want Ahrefs behind the same address as your other Ryze AI platforms. Both spend your Ahrefs API units.
Which ChatGPT plan do I need?
OpenAI names ChatGPT Business and Enterprise/Edu for full custom MCP support on the web, and Pro for read and fetch permissions only. Its article is silent on Free, Go and Plus. Ahrefs's own page mentions Pro and Plus in Developer mode, so the vendors differ.
Who can add Ryze AI in ChatGPT Business?
On Business, admins and owners are the only people who can create and publish plugins for custom MCP servers. Enterprise/Edu admins and owners can too, and admins may give members the permission through RBAC.
Does it work in the ChatGPT mobile app?
The setup cannot be done there: OpenAI says custom MCP servers cannot be connected on mobile, so add Ryze AI on the web. Whether the finished plugin then works in the mobile app is not stated on OpenAI's pages.
Can I paste my Ahrefs API key into ChatGPT?
No. The Add custom MCP server form has OAuth, no authentication or a mix, and OpenAI says ChatGPT cannot present custom API keys. Ryze AI keeps the key in its own app and ChatGPT signs in to Ryze AI through OAuth.
Can ChatGPT change anything in my Ahrefs account?
Not through the Ryze AI connector. Its one Ahrefs tool only sends GET requests, so it reads data and cannot edit projects, keyword lists or settings.
What can ChatGPT read from Ahrefs through Ryze AI?
Domain Rating and site metrics for a domain, subdomain, path or URL, backlinks, broken backlinks, referring domains, anchors, organic keywords, Keywords Explorer overview data for a country, and your API limits and usage.
Do I need an Ahrefs API subscription?
Yes. The Ryze AI tool uses your own Ahrefs API key and units, and a plan without API access is rejected. Ahrefs says its MCP server is available on paid plans from Lite.
How many Ahrefs API units does a call use?
At least 50. Ahrefs charges the larger of a 50-unit base cost and the per-row cost times the number of rows, where a field costs 1 unit by default and some cost 5 or 10. Cached results use none.
Can I connect more than one Ahrefs account?
Not in one workspace. Ryze AI holds one Ahrefs connection per workspace. To switch, disconnect with the trash icon under View on the Ahrefs card and connect again. Another key can live in another workspace, and one ChatGPT connection can cover up to 20 workspaces.
How much does it cost?
Connecting is free, but the Ahrefs tool needs an active Ryze AI plan or free trial. SEO Starter is $129 per month with a 3-day free trial, Paid Ads is $89 per month with a 7-day free trial and Agency is $279 per month. Annual billing takes 30% off the first year. Ahrefs bills its API units and OpenAI bills ChatGPT separately.
How do I disconnect Ahrefs from ChatGPT?
Any of three actions works: delete the API key in Ahrefs, use the trash icon under View on the Ahrefs card in Ryze AI, or choose Disconnect for Ryze AI under Settings, Plugins in ChatGPT.