By Ira Bodnar, Ryze AI · Updated · How this page was checked
Quick answer
The main way to connect Claude to Ahrefs is the Ryze AI connector. Add your Ahrefs API key under Integrations in Ryze AI, then add https://connector.get-ryze.ai/mcp to Claude as a custom connector and sign in. Ahrefs also runs its own MCP server at https://api.ahrefs.com/mcp/mcp, listed in the Claude connector directory, which covers much more of Ahrefs and is 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 Claude open Customize > Connectors and add the Ryze AI URL as a custom connector
- Start a new Claude chat and ask about backlinks, referring domains or keywords
Claude to Ahrefs at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector: one hosted MCP address added to Claude as a custom connector |
| Server address | https://connector.get-ryze.ai/mcp |
| Sign-in | OAuth in the browser, with Ryze AI. No key or header goes into Claude. Ahrefs itself is reached with your Ahrefs API key, saved in Ryze AI |
| Ahrefs tools | 1: ahrefs__read, a read-only call to the Ahrefs API v3 |
| Can it change things in Ahrefs | No. The tool only sends GET requests |
| Other data in the same chat | Tools for the other platforms connected in the same Ryze AI workspace are served from the same address |
| Claude plan needed | Custom connectors work on Free (one connector only), Pro, Max, Ultra, Team and Enterprise |
| Ahrefs plan needed | An Ahrefs subscription with API access. Calls use your Ahrefs API units, not Ryze AI credits |
| Ryze AI price | SEO Starter is $129 per month with a 3-day free trial. Paid Ads is $89 per month with a 7-day free trial. Adding the connector is free |
| Ahrefs's own option for Claude | A hosted MCP server at https://api.ahrefs.com/mcp/mcp, on Ahrefs plans from Lite |
| Last checked | Sources opened November 18, 2026. No connector call was run for this page |
Before you start
- A Claude account. Custom connectors using remote MCP work on Free, Pro, Max, Ultra, Team and Enterprise, according to Anthropic. A Free account can hold one custom connector. On Team only Owners and Primary Owners can add one; on Enterprise Owners, Primary Owners and people with a custom role that includes Manage access to Libraries can. Members then connect to it one by one.
- An Ahrefs workspace with API access and an owner or admin role. Ahrefs says only workspace owners and admins can open the API keys section. A plan without API access is rejected.
- A Ryze AI workspace on a plan or free trial. SEO Starter is $129 per month with a 3-day free trial, and Paid Ads is $89 per month with a 7-day free trial. Adding the connector is free, but the Ahrefs tool needs an active plan or trial.
How to connect Claude to Ahrefs
Two steps happen in Ahrefs and Ryze AI, two in Claude, and the last is your first prompt. The connector URL is the same for every user.
Generate an Ahrefs API key
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
Create a Ryze AI account or sign in, open Integrations, click Connect on the Ahrefs card, paste the key into API key and click Continue. Alternatively, ask the Ryze AI agent in Claude to connect Ahrefs: it sends a one-time link, valid once and for 24 hours, to a page where you paste the key.
Add the Ryze AI connector to Claude
In Claude open Customize > Connectors, click + Add, then Add custom connector. Enter the name Ryze AI and the URL https://connector.get-ryze.ai/mcp, click Continue, review the authentication settings Claude detected and click Continue. Do not pick No sign in: the Ryze AI server requires OAuth. Then click Add.
https://connector.get-ryze.ai/mcpSign in and allow the connection
Click Connect on the Ryze AI connector. On the Ryze AI page, sign in or sign up, choose the workspaces Claude can reach (up to 20 per connection) and click Allow connection.
Ask your first question in Claude
Start a new chat. Connectors can be switched on or off per conversation from the + button, then Connectors. Try: What is the Domain Rating of the site I name, and how many referring domains does it have?
On individual plans the dialog is Customize > Connectors > + Add > Add custom connector. In the Ryze AI app, Integrations > Claude MCP > Open Claude MCP copies the connector URL and opens that dialog.
Anthropic's add dialog shows an OAuth client choice (Use Claude's published identity, Register automatically or Use your own OAuth client). Keep the options Claude marks as Detected. Which option Claude picks for the Ryze AI server was not tested for this page; the server advertises dynamic client registration.
The Ryze AI help center page for Ahrefs covers the key and the connection, and the Ryze AI Claude guide covers the Claude side.
Sources: Anthropic custom connectors guide, Ahrefs API keys, Ryze AI Ahrefs guide. Checked November 18, 2026.
Team plans, directory and mobile
Team and Enterprise organizations
- An Owner or Primary Owner (on Enterprise, also a person with a custom role that includes Manage access to Libraries) opens Organization settings > Connectors and clicks Add.
- Hover over Custom, select Web, enter the name Ryze AI and the URL https://connector.get-ryze.ai/mcp, then click Continue.
- Review the authentication settings Claude detected and click Continue. Under Authentication choose Sign in now or Sign in when needed, not No sign in, then click Add.
- Each member opens Customize > Connectors, finds Ryze AI (usually labeled Custom) and clicks Connect.
- The member signs in on the Ryze AI page, picks workspaces, clicks Allow connection and starts a new chat.
Claude Directory listing
The Ryze AI listing in the Claude Directory is at claude.ai/directory/ryze-ai. It carries the Community label: Anthropic says community connectors get automated reviews and are not verified by Anthropic. Add it from the listing, finish the Ryze AI sign-in, choose workspaces, click Allow connection and start a new chat. The result is the same connector as the custom one.
Mobile and where the call comes from
Claude reaches the connector from Anthropic's cloud on every Claude app, the web, Desktop and mobile included. Anthropic names Claude Desktop and the web as the main places to add a custom connector, and calls adding one from the mobile apps a beta.
Claude and MCP: the facts in one table
| Topic | What Anthropic's documentation says |
|---|---|
| Where connectors are added | Customize > Connectors. Team and Enterprise Owners use Organization settings > Connectors |
| Transports | Streamable HTTP for remote servers. The older HTTP+SSE transport still works and is being deprecated |
| Sign-in | OAuth 2.0 with PKCE S256, or no sign-in, or a fixed credential in a request header where the account has that beta |
| Where the call comes from | Anthropic's cloud, not your device. The address must be HTTPS on port 443 and reachable from the public internet |
| Tool approval | Customize > Connectors > the connector > Tool permissions: Always allow, Needs approval or Blocked, per tool or group |
| Plans | Free (one custom connector), Pro, Max, Ultra, Team and Enterprise |
| Admin controls | Organization settings > Connectors on Team and Enterprise: per-tool policy members cannot exceed. Enterprise custom roles can restrict single tools |
| Editing a connector | To change sign-in settings, remove the connector and add it again |
| Size and time limits | A tool result of about 150,000 characters and a tool call of 240 seconds |
Sources: Anthropic custom connectors guide, Anthropic: add a custom connector. Opened November 14, 2026.
ChatGPT and Claude Code
The same URL works in other MCP clients. Ahrefs is connected once in Ryze AI, so nothing changes on the Ahrefs side.
ChatGPT
Add the same URL as an app under Settings > Apps, pick the workspaces and start a new chat. If the connector was added before Ahrefs was connected in Ryze AI, remove and re-add it so the tool list refreshes.
Claude Code
Claude Code has its own setup with a command in a terminal. Ahrefs also documents a Claude Code route for its own server, with claude mcp add ahrefs https://api.ahrefs.com/mcp/mcp -t http.
Ahrefs access and API key
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 Claude can reach.
- Which Ahrefs account
- The one whose API key you pasted into Ryze AI. There is one Ahrefs connection per workspace. To switch keys, click View on the Ahrefs card in Ryze AI, disconnect with the trash icon and connect again. Another workspace can hold a different key.
- What the key allows
- Ahrefs says an API key is created in Account settings > API keys, that only workspace owners and admins can open that section, and that a key stops working if the user who created it is removed from the workspace. You pick its expiration date when you create it.
- What Claude asks first
- The Ahrefs tool only reads, so nothing in Ahrefs can be changed. In Claude you can still set tools under Customize > Connectors > Ryze AI > Tool permissions. Set write and delete tools to Needs approval if you also use other Ryze AI platforms through the same connector.
What decides the access
Ryze AI does not list OAuth scopes for Ahrefs. Access comes from the API key and the Ahrefs plan behind it. This table shows what each part decides.
| Part | What it decides | Detail |
|---|---|---|
| API key | Which Ahrefs workspace is read | Created by an owner or admin in Account settings > API keys |
| Ahrefs plan | Whether the API accepts the call at all | A plan without API access is rejected |
| API units | How many calls you can make in a month | Each call draws on your own monthly unit balance, not Ryze AI credits |
| Per-key unit limit | A cap on one key's monthly 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 |
Not included: any change to Ahrefs. The tool is GET only, so it cannot edit Rank Tracker projects, keyword lists or Brand Radar settings. Ahrefs's own MCP server has a management group for those, which the Ryze AI connector does not expose.
Source: Ahrefs API keys creation and management. Checked November 18, 2026.
Removing access
To remove access, disconnect Ahrefs from its card in Ryze AI and delete the key in Ahrefs under Account settings > API keys. In Claude, open Customize > Connectors, click Ryze AI and choose Disconnect or Remove.
What Claude can do in Ahrefs
The Ryze AI connector exposes one Ahrefs tool, and it only reads. Everything below goes through it.
| 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. |
Every call spends your own Ahrefs API units. Ask Claude for fewer rows and fewer fields to spend fewer, and ask for your API limits and usage when you want to see what is left. Ahrefs lists the same figure in Account settings > Limits & usage.
Because the tool is read-only, there is nothing in Ahrefs for Claude to change. To be asked before every call anyway, set the tool to Needs approval under Customize > Connectors > Ryze AI > Tool permissions. Separately, the Ryze AI chat has its own Tool approvals picker, which starts on Skip all approvals.
Limits in numbers
| Limit | Number |
|---|---|
| Cost of one request | max(base cost, per-row cost x rows). The base cost is 50 units. |
| Per-row cost | The sum of the 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 example | 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 | Requests served from cache do not use units. |
| Free test queries | Site Explorer calls for ahrefs.com, yep.com or firehose.com, and Keywords Explorer calls using only ahrefs, yep or firehose as the keyword, are free on any paid plan. |
| Monthly allowance | Set by your Ahrefs plan. Enterprise customers can buy more units. Track use in Account settings > Limits & usage. |
| Keys | Up to 1,000 API keys. A key created by hand has no per-key unit limit by default, but plan limits still apply. |
| Claude side | A tool result of about 150,000 characters and a tool call of 240 seconds (Anthropic). |
Sources: Ahrefs limits consumption, Ahrefs free test queries, Ahrefs MCP introduction, Anthropic: add a custom connector. Checked November 18, 2026.
First 3 prompts to run
1. Check a site's authority and link count
What is the Domain Rating of the domain I give you, and how many referring domains and backlinks does it have?
Tools used: ahrefs__read
What comes back: The Domain Rating and the backlink and referring-domain counts that Ahrefs reports for that target. Nothing is changed.
2. List broken backlinks to fix
List the broken backlinks pointing at my domain, with the page that links and the page that is missing.
Tools used: ahrefs__read
What comes back: A list of broken backlinks as Ahrefs returns them. Ask for a small number of rows first, 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 the first five in the United States.
Tools used: ahrefs__read
What comes back: The organic keywords Ahrefs holds for the site, then the overview metrics for the keywords you chose in that country.
This page shows no sample output, because no Ahrefs call was run to write it. Replace the placeholders with your own domain, and expect numbers that come from your own Ahrefs account.
10 jobs to hand to Claude
Ten jobs to hand to Claude, each matched to the Ryze AI tool it uses. All ten use the one Ahrefs tool and none changes anything in Ahrefs. None of them was run for this page.
| Job | Ask Claude | 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 |
| Referring domains | List the referring domains for this site, five rows only. | ahrefs__read | No |
| Backlinks list | List backlinks to this page, five rows only. | 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 |
| Organic 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 |
3 ways to connect Claude to Ahrefs
There are three ways to give Claude Ahrefs data. This guide uses the first, the Ryze AI connector, as the main way: you paste one API key into Ryze AI and add one address to Claude, and the same address serves the other Ryze AI platforms you connect. The second is Ahrefs's own hosted MCP server, which reaches much more of Ahrefs. Both were checked on the day this page was updated.
| Way | Runs where | Setup in Claude | What it reaches in Ahrefs | Price and units |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted. One address for every user | Add https://connector.get-ryze.ai/mcp under Customize > Connectors, sign in with Ryze AI | 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 is $129 per month with a 3-day free trial, Paid Ads is $89 per month with a 7-day free trial. Calls use your Ahrefs API units |
| Ahrefs MCP server (Ahrefs's own) | Hosted by Ahrefs at https://api.ahrefs.com/mcp/mcp | Customize > Connectors > + Add, search for Ahrefs in the approved connectors, click Connect, choose the workspace and click Allow. Ahrefs also documents a second method with an MCP key from Account settings > API Keys | 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 the monthly API units of your plan. Keys made through OAuth 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 and that custom scripts or standalone clients against it are not permitted | Everything in API v3, with a key in the Authorization header | Needs API access on your plan. Calls use API units |
Two options that do not fit this job
- Local servers in a config file. Anthropic treats a local server in claude_desktop_config.json as a separate mechanism from connectors. Such servers run on your computer and are not available in claude.ai in a browser.
- 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.
Which one to pick
Ryze AI is the best way to connect Claude to Ahrefs when you already run the Ryze AI connector for other platforms and want Ahrefs behind the same 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 Claude, or when you want those groups. Both can be connected in Claude at the same time, and both draw on the same Ahrefs API units.
Sources: Ahrefs MCP introduction, Ahrefs MCP tool categories, Ahrefs: Claude Desktop and Web, Ahrefs: Claude Code, Ahrefs API introduction, Anthropic custom connectors guide, Ryze AI Ahrefs guide. Checked November 18, 2026.
Claude, Ahrefs and MCP: dates that matter
| Date | What happened |
|---|---|
| May 1, 2025 | Anthropic launched Integrations, remote MCP servers in the Claude web and desktop apps, first in beta on Max, Team and Enterprise. |
| June 3, 2025 | Anthropic added Pro to the plans with remote MCP integrations. |
| July 14, 2025 | Anthropic launched the connectors directory at claude.ai/directory. |
| February 25, 2026 | Anthropic added a Customize section to Claude Desktop that groups skills, plugins and connectors. |
| November 18, 2026 | Ahrefs's MCP documentation describes a hosted server at https://api.ahrefs.com/mcp/mcp for users on a Lite plan or higher, with setup guides for Claude Desktop and Web, Claude Mobile and Claude Code. |
Sources: Anthropic: Integrations, Anthropic: connectors directory, Claude release notes, Ahrefs MCP introduction. Checked November 18, 2026.
How this page was checked
This page was written from documentation. No call to Ahrefs was made through the Ryze AI connector for it, so it carries no tested result and no sample numbers.
| What was done | What it covered |
|---|---|
| Ahrefs MCP and API documentation | Read on November 18, 2026: the MCP introduction, tool categories, the Claude Desktop and Web guide, the Claude Code guide, the API introduction, limits consumption, free test queries and API key pages. |
| Ryze AI facts for Ahrefs | The Ryze AI Ahrefs entry, checked November 8, 2026, gives the one tool, the key steps and the limits quoted here. The tool name comes from Ryze AI's app source and was not seen in a live tool list. |
| Anthropic connector facts | From Anthropic's custom connector pages, opened November 14, 2026, and the Ryze AI Claude entry. |
Not run for this page: the steps inside Claude, any sign-in, and any call to ahrefs__read. The prompts and jobs describe what you can ask. They show no results because none were produced. Treat the setup steps as the documented route, not as a recorded session.
Claude and Ahrefs problems and fixes
No exact error messages are listed for Ahrefs, because no call was run to produce them. These are the problems the documentation points to.
- The Ahrefs tool does not appear in Claude
- If Ahrefs was connected in Ryze AI after the connector was added, remove the connector in Claude, add it again and start a new chat so the tool list refreshes.
- Claude never asks me to sign in
- Open Customize > Connectors, click Ryze AI and choose Connect. If the add dialog shows Authentication, do not pick No sign in.
- Ahrefs rejects the key
- A plan without API access is rejected. Check the plan, and that the key is still active in Account settings > API keys. A key also stops working if the user who created it leaves the workspace.
- Calls stop working during the month
- You may have used up your Ahrefs API units, or a per-key limit. Ask Claude for your API limits and usage, or open Account settings > Limits & usage in Ahrefs.
- The one-time connection link is refused
- The link is refused while Ahrefs is already connected in that workspace. Switch keys in the Ryze AI app: View, disconnect, then connect again.
- The tools reply that a subscription is required
- The Ahrefs tool needs an active Ryze AI plan or free trial. Start the trial, then retry.
- I am on a Free Claude plan and cannot add another connector
- Free accounts can hold one custom connector. Remove another one or upgrade.
- A Team member cannot add the connector
- On Team only Owners and Primary Owners can add a custom connector. Ask one to add it under Organization settings > Connectors, then connect from Customize > Connectors.
- Claude says it could not reach the MCP server
- Anthropic documents this message for a failed connection handshake. Remove the connector, add it again with the exact URL and try once more.
Terms on this page
- MCP
- The Model Context Protocol, an open standard for connecting AI applications to outside systems. Claude, ChatGPT and Ahrefs support it.
- MCP server
- A program that offers tools over MCP. The Ryze AI connector runs on Ryze AI's side, so there is nothing to install.
- Custom connector
- Claude's name for a remote MCP server added by its URL instead of from the directory.
- 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 to a page that no longer loads.
Source for MCP: modelcontextprotocol.io. Checked November 18, 2026.
Frequently asked questions
How do I connect Claude to Ahrefs?
Generate an Ahrefs API key under Account settings > API keys, connect Ahrefs in Ryze AI by pasting it into the Ahrefs card, then add https://connector.get-ryze.ai/mcp in Claude under Customize > Connectors as a custom connector and sign in. Start a new chat afterwards.
Is there an Ahrefs MCP server for Claude?
Yes, two. Ahrefs hosts its own server at https://api.ahrefs.com/mcp/mcp for plans from Lite, and Claude's connector directory lists it. The Ryze AI connector at https://connector.get-ryze.ai/mcp has 1 Ahrefs tool that reads Ahrefs API v3 data.
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.
Does Ahrefs have an official MCP server?
Yes. Ahrefs documents a hosted MCP server for users with a Lite plan or higher, with setup guides for Claude Desktop and Web, Claude Mobile, Claude Code, ChatGPT Web, Copilot Studio, Lovable, n8n, Manus, Le Chat and OpenClaw.
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, and both can be connected at once.
Can Claude 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 Claude 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.
Which Claude plan do I need?
Anthropic says custom connectors using remote MCP work on Free, Pro, Max, Ultra, Team and Enterprise. Free users can add one custom connector. On Team only Owners and Primary Owners can add one.
Do I need an Ahrefs API subscription?
Yes. The Ryze AI tool uses your own Ahrefs API key and API units, and a plan without API access is rejected. Ahrefs says its MCP server needs a plan 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.
Who can create an Ahrefs API key?
Only workspace owners and admins can open Account settings > API keys in Ahrefs. You can create up to 1,000 keys and set an expiration date for each.
Can I connect more than one Ahrefs account?
One Ahrefs connection fits one Ryze AI workspace. To change keys, disconnect on the Ahrefs card and connect again. A different key can live in another workspace, and one Claude connection can cover up to 20 workspaces.
Why does the Ahrefs tool not show up in Claude?
If you connected Ahrefs in Ryze AI after adding the connector, remove the connector in Claude, add it again and start a new chat so Claude loads the new tool list.
How much does it cost to connect Claude to Ahrefs?
Adding the connector costs nothing, 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 and Paid Ads is $89 per month with a 7-day free trial. Annual billing takes 30% off the first year. Ahrefs bills its own API units separately.
How do I disconnect Ahrefs from Claude?
Open Customize > Connectors, click Ryze AI and choose Disconnect or Remove. To cut Ahrefs access itself, disconnect the Ahrefs card in Ryze AI and delete the key in Ahrefs.