By Ira Bodnar, Ryze AI · Updated · Test record: nothing was run
Quick answer
The main way to connect Claude Code to Ahrefs is the Ryze AI connector. Save an Ahrefs API key on the Ahrefs card in Ryze AI, run claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp in your shell, then open Claude Code, run /mcp, select ryze and sign in. Ahrefs also hosts its own server at https://api.ahrefs.com/mcp/mcp with a one-line Claude Code command, compared below.
- In Ahrefs open Account settings, then API keys, and generate a key (owners and admins only)
- In Ryze AI open Integrations, click Connect on the Ahrefs card and paste the key
- In your terminal run the claude mcp add command, then /mcp in Claude Code to sign in
- Allow the workspace on the Ryze AI page and ask about backlinks, referring domains or keywords
Claude Code to Ahrefs at a glance
| Question | Answer |
|---|---|
| Main way to connect | The Ryze AI connector, a hosted MCP server added with one claude mcp add command |
| Server address | https://connector.get-ryze.ai/mcp |
| Sign-in to Ryze AI | OAuth in the browser from /mcp or claude mcp login ryze. A Ryze AI API key with --header suits scripts |
| What Ahrefs needs | An Ahrefs API key from a workspace owner or admin, on a plan with API access. It is saved in Ryze AI and never goes into Claude Code |
| Ahrefs tools | 1: ahrefs__read, a read-only call to the Ahrefs API v3 |
| Can Claude Code change Ahrefs | No. The tool only sends GET requests |
| Cost in Ahrefs | Every call spends your own Ahrefs API units, at least 50 per request. Ryze AI credits are not used |
| Claude Code plan | Pro, Max, Ultra, Team, Enterprise or Console. The free claude.ai plan has no Claude Code |
| 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; the Ahrefs tool needs a plan or trial |
| Ahrefs's own route | Its hosted MCP server at https://api.ahrefs.com/mcp/mcp, added with claude mcp add ahrefs https://api.ahrefs.com/mcp/mcp -t http. Needs an Ahrefs plan from Lite |
| Last checked | Ahrefs sources read November 21, 2026, Claude Code sources November 14, 2026. No Ahrefs call and no Claude Code step was run |
Before you start
- A Claude Code account. Anthropic says Claude Code requires a Pro, Max, Ultra, Team, Enterprise or Console account; the free claude.ai plan does not include it. It can also run through Amazon Bedrock, Google Cloud's Agent Platform or Microsoft Foundry. Anthropic's MCP page names no extra plan for remote MCP servers.
- An Ahrefs API key. Ahrefs says only workspace owners and admins can open Account settings, then API keys, and that you pick an expiration date when you create a key. A key also stops working if the user who created it is removed from the workspace. Ryze AI says a plan without API access is rejected, so check the plan first.
- A Ryze AI workspace on a 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; Agency is $279 per month. Connecting the connector is free, but the Ahrefs tool needs an active plan or trial. Ahrefs bills its API units itself.
How to connect Claude Code to Ahrefs
Two steps happen in Ahrefs and Ryze AI, three in Claude Code. 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
Sign in to Ryze AI or create an account, go to Integrations, click Connect on the Ahrefs card, paste the key into API key and click Continue. There is one Ahrefs connection per Ryze AI workspace.
Register the connector in Claude Code
In your terminal, not inside a claude session, run: claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp. The server is stored with local scope by default; add --scope user to make it available in all your projects. Until you sign in, claude mcp list shows it as Needs authentication.
Sign in from Claude Code
Inside Claude Code run /mcp, select ryze and choose Authenticate, or run claude mcp login ryze in the shell. Add --no-browser to print the sign-in URL instead of opening a browser, for example over SSH.
Allow the workspace and ask your first question
On the Ryze AI page, sign in if asked, choose the workspace that holds Ahrefs and click Allow connection. Check the result with claude mcp get ryze, start a new session and ask: What is the Domain Rating of the domain I name, and how many referring domains does it have?
The Ryze AI Ahrefs guide covers the Ahrefs side of the connection, and the Claude Code MCP docs cover the client commands.
Sources: Claude Code MCP documentation, Claude Code MCP quickstart, Ryze AI Ahrefs guide. Checked November 21, 2026.
OAuth, API key and claude.ai connectors
Claude Code accepts the Ryze AI connector three ways. Pick the one that matches where the session runs.
CLI with OAuth (a personal machine)
claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope userThis is the flow in the steps above. The default local scope keeps the server to the current project, --scope user loads it in all your projects, and --scope project writes a .mcp.json file the team can share. Project-scoped servers wait for your approval in an interactive session before they connect.
CLI with a Ryze AI API key
claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --header "Authorization: Bearer rk_live_..."This key belongs to Ryze AI and is separate from your Ahrefs API key. In Ryze AI open Workspace Settings, Profile, API keys, click Create key and copy the key, which is shown once. The Ryze AI help center says it works on the /mcp endpoint only, not on /sse. If Claude Code gets a rejected Authorization header it reports the connection as failed and does not fall back to OAuth, so replace a bad key.
claude.ai connectors inside Claude Code
Add Ryze AI at claude.ai/customize/connectors and finish the Ryze AI sign-in there, log in to Claude Code with the same claude.ai subscription account, then run /mcp. Connectors added in claude.ai appear with an indicator that they come from claude.ai. On Team and Enterprise plans only admins can add servers in claude.ai. These connectors load only when the active login is a claude.ai subscription; ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, apiKeyHelper or a third-party provider stops them from loading.
Scripts and limits
claude -p and Agent SDK runs cannot run the OAuth flow. Sign in first with /mcp or claude mcp login ryze, or use the Ryze AI API key method. Claude Code warns when a tool result passes 10,000 tokens and caps MCP output at 25,000 tokens by default; set MAX_MCP_OUTPUT_TOKENS to raise the cap. A call to an HTTP server that sends no response and no progress for five minutes is stopped.
Claude Code and MCP: the facts in one table
| Topic | What Anthropic's Claude Code docs say |
|---|---|
| Where the server entry is stored | Local and user scope: ~/.claude.json. Project scope: .mcp.json in the project root |
| Transports | HTTP, which Anthropic recommends for remote servers such as this one; SSE, now deprecated; stdio for local processes |
| Sign-in | OAuth 2.0. A server that answers 401 or 403 is marked as needing authentication until you choose Authenticate in /mcp. Tokens refresh on their own |
| Static credentials | --header (short form -H) or a headers object in the server entry |
| Tool approval | From version 2.1.283, interactive terminal sessions begin in auto mode if the session can use it. A call that matches an allow, ask or deny rule follows that rule |
| Where servers are managed | claude mcp list, get and remove in the shell, /mcp in a session, and Customize, then Connectors, in the desktop app |
| Tool loading | Tool search is on by default, so MCP tools are deferred and loaded on demand |
| Plan | A paid Claude plan that includes Claude Code, a Console account, or a provider such as Amazon Bedrock, Google Cloud's Agent Platform or Microsoft Foundry. The MCP page adds no plan for remote servers |
| Ryze AI in the Anthropic Directory | A Community listing with the connector address, added August 2026. Community means screened, without an in-depth review |
Sources: Claude Code MCP, permission modes, setup, changelog, Claude custom connectors, Ryze AI in the Anthropic Directory. Checked November 21, 2026.
Claude web, ChatGPT and Cursor
The same URL works in other MCP clients. Ahrefs is connected once in Ryze AI, so nothing changes on the Ahrefs side.
Claude on the web and Desktop
Open Customize, Connectors, click + Add, choose Add custom connector, name it Ryze AI and enter https://connector.get-ryze.ai/mcp. Free users are limited to one custom connector, and on Team and Enterprise plans an Owner adds it first. Ahrefs's own server is also listed there. Ryze AI has a separate Claude guide for Ahrefs, linked below.
ChatGPT
OpenAI says full custom MCP server support is for ChatGPT Business and Enterprise/Edu on the web, and Pro can connect custom MCP servers with read and fetch permissions only. Add the same URL as a custom MCP server with OAuth.
Cursor
Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project). Cursor runs OAuth with PKCE and asks for approval before using MCP tools by default.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }Ahrefs key access
Claude Code never holds an Ahrefs credential. Everything it can read passes through the API key saved in Ryze AI, and three settings bound that.
- Which Ahrefs account
- The one whose API key you pasted into the Ahrefs card. To switch keys, click View on the card, disconnect with the trash icon and connect again. Another Ryze AI workspace can hold a different key.
- Which key
- Ahrefs lets you create up to 1,000 keys and set an expiration date on each, and shows who created each one. If the key expires or its creator leaves the workspace, Claude Code loses the data with it.
- What Claude Code asks first
- An ask rule in Claude Code makes a matching call wait for you. The Ahrefs tool only reads, so a call never edits anything in Ahrefs.
The Ahrefs access behind the Ryze AI tool
Ryze AI lists no OAuth scopes for Ahrefs. Access comes from the key and the plan behind it. The rows below show what each part decides.
| Item | What it decides | Source |
|---|---|---|
| API key | Which Ahrefs workspace is read. Sent as a bearer token | Ahrefs API keys page |
| Ahrefs plan | Whether the API accepts the call at all. A plan without API access is rejected | Ryze AI Ahrefs guide |
| API units | How many calls fit in the month. Each call uses your own unit balance | Ahrefs limits consumption page |
| Per-key unit limit | A cap on one key's monthly use, set in Account settings, API keys | Ahrefs API keys page |
| Ryze AI plan or trial | Whether the Ahrefs tool runs. Without one the connector lists workspaces and connects platforms only | Ryze AI Ahrefs guide |
Outside what the tool can do: any change in Ahrefs. It is GET only, so it cannot edit Rank Tracker projects, keyword lists or Brand Radar settings. Ahrefs's own server lists a management group for those, which the Ryze AI connector does not expose.
Ahrefs says that to control monthly usage in a workspace you can limit particular API keys, and that on plans with pay-as-you-go charges you can cap or switch off pay-as-you-go units under Account settings, Limits and usage.
Sources: Ahrefs API keys, Ahrefs MCP introduction, Ahrefs MCP: Claude Code, Ryze AI Ahrefs guide. Checked November 21, 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 Code, run claude mcp logout ryze and then claude mcp remove ryze: remove alone deletes the stored tokens without revoking them at the sign-in server. To pause the server and keep its entry, toggle it off in /mcp.
What Claude Code can do in Ahrefs
There is a single Ahrefs tool on the connector and it is read-only. Its name comes from the Ryze AI app source in the facts file, not from a live tool list.
| 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. |
Because the only Ahrefs tool is a read tool, the connector does not change anything in Ahrefs. Claude Code has its own permission system: rules for an MCP tool follow the pattern mcp__<server>__<tool>, with your server name in place of <server>, and each rule allows, asks or denies. Add an ask rule for mcp__ryze__ahrefs__read if you want to see each call, and each unit spend, before it runs. In the claude.ai connector settings (Customize, Connectors, Ryze AI, Tool permissions) approvals are set per tool. In the Ryze AI chat the Tool approvals picker starts on Skip all approvals, and scheduled tasks in Ryze AI run without an approval step.
Limits in numbers
Three sources, three kinds of limit: Ahrefs for API units, Anthropic for Claude Code output, and the Ryze AI facts for the connection.
| Limit | What the docs say |
|---|---|
| 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 at 12 units per row and 500 rows costs 6,000 units |
| Cached results | Requests served from cache do not use units |
| Monthly allowance | Set by your Ahrefs plan. Track use in Account settings, Limits and usage |
| Ahrefs's own MCP server | OAuth keys made for it default to 200,000 units a month per key. Keys made by hand have no per-key limit by default |
| Claude Code tool output | A warning above 10,000 tokens and a cap of 25,000 by default, changed with MAX_MCP_OUTPUT_TOKENS |
| Claude Code idle timeout | Five minutes for an HTTP server that sends no response or progress |
| Ryze AI connection | One Ahrefs connection per workspace, and up to 20 workspaces per Claude or ChatGPT connection |
Sources: Claude Code permissions, Ahrefs limits consumption, Ahrefs MCP introduction, Ahrefs MCP: Claude Code, Claude Code MCP output limits. Checked November 21, 2026.
First 3 prompts to run
Type these into a Claude Code session. Results come from your own Ahrefs account, so no sample figures appear here. Ask for a few rows first, because each request costs at least 50 units.
1. Size up a site's link profile
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. Ahrefs is left untouched.
2. Find broken backlinks worth fixing
List five broken backlinks pointing at my domain, with the linking page and the missing page.
Tools used: ahrefs__read
What comes back: A short list of broken backlinks as Ahrefs returns them, which Claude Code can turn into a redirect checklist.
3. Pull organic keywords and check a few
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 three keywords in that country.
Swap in your own domain and keywords. Claude Code cannot see numbers the Ahrefs API does not return for your plan.
10 jobs to hand to Claude Code
Ten requests for a connected Claude Code, each with the tool behind it. None of them was run while writing this page.
| Job | What to type in Claude Code | Tool | Works on the default connection |
|---|---|---|---|
| Authority check | What is the Domain Rating of this domain? | ahrefs__read | Yes |
| Link profile summary | Show the backlink and referring-domain counts for this domain. | ahrefs__read | Yes |
| Referring domains | List the referring domains for this site, five rows only. | ahrefs__read | Yes |
| Backlinks to one page | List backlinks to this exact URL, five rows only. | ahrefs__read | Yes |
| Broken backlinks | Which broken backlinks point at my domain? | ahrefs__read | Yes |
| Anchor text | Show the anchor texts used for links to my domain. | ahrefs__read | Yes |
| Organic keywords | List the organic keywords this site ranks for. | ahrefs__read | Yes |
| Keyword overview | Give me the Keywords Explorer overview for these keywords in this country. | ahrefs__read | Yes |
| Budget check | Check my Ahrefs API limits and units used. | ahrefs__read | Yes |
| Create a Rank Tracker project or run a site audit | Add this keyword list to Rank Tracker. | none | No. The tool is read-only; Ahrefs's own server lists groups for Rank Tracker, Site Audit and management |
3 ways to connect Claude Code to Ahrefs
Claude Code can reach Ahrefs in three ways whose makers document them. This guide uses the Ryze AI connector as the main way: one claude mcp add command, a browser sign-in, and an Ahrefs key that stays in Ryze AI. Ahrefs's own server was read on November 21, 2026, and each row says what it takes inside Claude Code. None of them was run for this guide.
| Way | Where it runs | How you add it in Claude Code | What it can reach in Ahrefs | Cost |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI, one address for everyone | claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp, then Authenticate in /mcp. An API key with --header or a claude.ai connector also works | 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, plus your own Ahrefs API units |
| Ahrefs MCP server with OAuth (Ahrefs's own) | Hosted by Ahrefs at https://api.ahrefs.com/mcp/mcp | claude mcp add ahrefs https://api.ahrefs.com/mcp/mcp -t http, then /mcp, Authenticate, sign in to Ahrefs, pick the workspace and click 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, management and subscription info | Needs an Ahrefs plan from Lite. Calls use your plan's monthly API units |
| Ahrefs MCP server with an MCP key | Hosted by Ahrefs | Ahrefs says you can generate an MCP key in your account and use it in your agent's configuration. Claude Code accepts a header through --header | Same groups as above | Same as above. Whether Claude Code works with this key was not tested |
Options that do not fit Claude Code
- Ahrefs's connector in Claude's directory. Ahrefs documents it for Claude Desktop and Web. Anthropic says connectors added in claude.ai also load in Claude Code under a claude.ai subscription login, and Ahrefs's own Claude Code page uses the claude mcp add route above.
- 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. For code, use the Ahrefs public API.
Which one to pick
Ryze AI is the best way to connect Claude Code to Ahrefs when you already run the Ryze AI connector for other platforms and want read-only link and keyword data behind the same sign-in, 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, and the Ryze AI route needs a Ryze AI plan or trial. Pick Ahrefs's server when Ahrefs data is all you need in Claude Code, or when you want those groups. Both can sit in Claude Code at once under different names, such as ryze and ahrefs, and both spend the same Ahrefs API units. Use the Ryze AI API key option for scripts, because claude -p cannot run OAuth.
Sources: Ahrefs MCP introduction, Ahrefs MCP: Claude Code, Ahrefs API keys, Claude Code MCP, Ryze AI Ahrefs guide. Checked November 21, 2026.
Ahrefs, Claude Code and MCP: dates that matter
| Date | What happened |
|---|---|
| November 25, 2024 | Anthropic open-sourced the Model Context Protocol. |
| June 18, 2025 | Claude Code 1.0.27 added streamable HTTP servers and OAuth for remote servers, the transport and sign-in this guide uses. |
| February 18, 2026 | Claude Code 2.1.46 began to load claude.ai connectors. |
| June 22, 2026 | Claude Code 2.1.186 added claude mcp login and claude mcp logout. |
| August 2026 | The month the Ryze AI listing in Claude's Connectors Directory gives as its Added date. |
| September 28, 2026 | Claude Code 2.1.284 made interactive sessions start in auto mode on every plan and provider when no permission mode is set. |
| November 13, 2026 | Claude Code 2.1.325, the newest on its changelog when the Claude Code facts were read, came out. |
| November 21, 2026 | Ahrefs's MCP documentation describes a hosted server at https://api.ahrefs.com/mcp/mcp for Lite plans and higher, with a Claude Code setup page. |
Sources: Anthropic MCP announcement, Claude Code changelog, Ahrefs MCP introduction, Ahrefs MCP: Claude Code. Checked November 21, 2026.
How this guide was tested
No call was run for this guide. Everything here comes from the Ryze AI help center and facts file, and from Ahrefs's and Anthropic's pages, read on November 21, 2026 (Ahrefs) and November 14, 2026 (Anthropic).
| What was run | What came back |
|---|---|
| Calls to Ahrefs | None. No Ahrefs key was connected, so no Ahrefs call was run. |
| The Ahrefs tool name | Taken from the Ryze AI app source. It was not seen in a live tool list. |
| The steps inside Claude Code | None run. No server was added with claude mcp add and no sign-in was made from /mcp. |
| Ahrefs's own server | Read from Ahrefs's docs. Not connected. |
Not run for this page: any step in Claude Code, and any call to Ahrefs. With no Ahrefs key connected, this guide has no table of tested calls and no error messages copied from a test. The errors section below describes documented behavior instead.
Errors and fixes
- claude mcp list shows ryze as Needs authentication
- No sign-in has been stored for it yet, or the stored one was cleared. Open /mcp in Claude Code and pick Authenticate on ryze, or run claude mcp login ryze.
- Claude Code says the server failed to connect with an API key
- If a configured Authorization header is rejected, Claude Code reports the connection as failed and does not fall back to OAuth. Check that the key is a current Ryze AI rk_live_ key and that the URL ends in /mcp, or remove the server and add it again without --header.
- claude -p or an Agent SDK run cannot sign in
- Those runs cannot run the OAuth flow. Sign in first with /mcp or claude mcp login ryze in an interactive shell, or use the Ryze AI API key method.
- The server does not load from .mcp.json
- Project-scoped servers wait for approval in an interactive session before they connect. Approve it when Claude Code asks.
- No Ahrefs tool appears
- If the connector was added before Ahrefs was connected, run claude mcp remove ryze, add it again, then start a new session. Tool search is on by default, so tools load on demand and may not be listed up front.
- Ahrefs rejects the key
- A plan without API access is rejected. Check the plan, and that the key is still active under Account settings, API keys. A key also stops working if its creator 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 Code for your API limits and usage, or open Account settings, Limits and usage in Ahrefs.
- The Ahrefs tool needs a subscription
- An active Ryze AI plan or trial is required for the tool. With neither, the connector only lists workspaces and connects platforms.
- The one-time connection link is refused
- Such a link works once and for 24 hours, and Ryze AI refuses it when the workspace already has Ahrefs connected. Switch keys in the Ryze AI app: View, disconnect, connect again.
- The result is very large
- Claude Code warns above 10,000 tokens and caps MCP output at 25,000 by default. Ask for fewer rows or fewer fields, which also costs fewer API units, or raise MAX_MCP_OUTPUT_TOKENS.
- Ahrefs reports an invalid tool category on its own server
- Ahrefs says a tools group name that does not exist in the URL query makes the connection be rejected. Check the spelling against Ahrefs's tool category table.
Terms on this page
- MCP
- The Model Context Protocol, which Anthropic open-sourced in November 2024. Claude Code uses it to reach outside tools.
- Server scope
- In Claude Code, where a server entry lives: local, user or project.
- 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.
- Keywords Explorer
- The Ahrefs tool for keyword research, with overview data per keyword and country.
Sources: Anthropic on MCP, Ahrefs API keys, Ahrefs MCP introduction, Ahrefs MCP: Claude Code. Checked November 21, 2026.
Frequently asked questions
How do I connect Claude Code to Ahrefs?
Generate an Ahrefs API key under Account settings, API keys, paste it on the Ahrefs card under Integrations in Ryze AI, then run claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp, run /mcp inside Claude Code, select ryze, sign in on the Ryze AI page, choose the workspace and click Allow connection.
Is there an Ahrefs MCP server for Claude Code?
Yes. Ahrefs hosts its own server at https://api.ahrefs.com/mcp/mcp and documents claude mcp add ahrefs https://api.ahrefs.com/mcp/mcp -t http followed by /mcp and a sign-in. The Ryze AI connector is a separate route with 1 read-only Ahrefs tool.
What is the Ahrefs MCP URL for Claude Code?
For Ahrefs's own server it is https://api.ahrefs.com/mcp/mcp, a Streamable HTTP address. For the Ryze AI connector the address is https://connector.get-ryze.ai/mcp, the same for every user.
Can Claude Code use the Ryze AI connector and Ahrefs's server at the same time?
Yes. Add each under its own name, for example ryze and ahrefs. They have different addresses, so Claude Code keeps both, and its MCP page names no limit on the number of servers. Each tool name carries its server name, in the pattern mcp__<server>__<tool>, so you can tell which one ran. Both draw on the same Ahrefs API units.
Can Claude Code change anything in my Ahrefs account?
Not through Ryze AI. Its one Ahrefs tool only sends GET requests, so it reads data and cannot edit projects, keyword lists or settings. Ahrefs's own server lists a management group.
What can Claude Code 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 for Claude Code?
Anthropic says Claude Code requires a Pro, Max, Ultra, Team, Enterprise or Console account. The free claude.ai plan does not include it. Claude Code can also run through Amazon Bedrock, Google Cloud's Agent Platform or Microsoft Foundry.
Should I use OAuth or an API key to sign in to Ryze AI?
OAuth through /mcp is the simplest on a personal machine. A Ryze AI API key from Workspace Settings, Profile, API keys suits scripts, because claude -p and Agent SDK runs cannot run the OAuth flow. That key works on the /mcp endpoint only and is separate from your Ahrefs API key.
Do I need an Ahrefs API subscription?
Yes for the Ryze AI route: the tool uses your own Ahrefs API key and units, and a plan without API access is rejected. Ahrefs says its own 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?
Not within a single workspace. Ahrefs holds one connection per Ryze AI workspace, so changing keys means disconnecting on the Ahrefs card and connecting again, or keeping the second key in a different workspace.
What does the claude mcp add scope change?
Local scope, the default, keeps the server to the current project. User scope loads it in all your projects. Project scope writes .mcp.json so the team shares it, and each person approves it in an interactive session.
Why does the Ahrefs tool not show up in Claude Code?
Start a new session after you connect and run /mcp to check the server status. If the connector was added before Ahrefs was connected, remove and re-add it. If a claude.ai connector is missing, you must be logged in with a claude.ai subscription account.
How much does it cost to connect Claude Code to Ahrefs?
The connector itself is free; 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 separately.