How to connect Claude Code to Ahrefs

Paste an Ahrefs API key into Ryze AI once, add one MCP URL with claude mcp add, then ask your terminal for Domain Rating, backlinks, referring domains and organic keywords.

Your MCP URL
https://connector.get-ryze.ai/mcp

Paste it into claude mcp add --transport http ryze. See the steps

See pricing

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.

  1. In Ahrefs open Account settings, then API keys, and generate a key (owners and admins only)
  2. In Ryze AI open Integrations, click Connect on the Ahrefs card and paste the key
  3. In your terminal run the claude mcp add command, then /mcp in Claude Code to sign in
  4. Allow the workspace on the Ryze AI page and ask about backlinks, referring domains or keywords

Claude Code to Ahrefs at a glance

QuestionAnswer
Main way to connectThe Ryze AI connector, a hosted MCP server added with one claude mcp add command
Server addresshttps://connector.get-ryze.ai/mcp
Sign-in to Ryze AIOAuth in the browser from /mcp or claude mcp login ryze. A Ryze AI API key with --header suits scripts
What Ahrefs needsAn 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 tools1: ahrefs__read, a read-only call to the Ahrefs API v3
Can Claude Code change AhrefsNo. The tool only sends GET requests
Cost in AhrefsEvery call spends your own Ahrefs API units, at least 50 per request. Ryze AI credits are not used
Claude Code planPro, Max, Ultra, Team, Enterprise or Console. The free claude.ai plan has no Claude Code
Ryze AI priceSEO 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 routeIts 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 checkedAhrefs 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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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 user

This 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

TopicWhat Anthropic's Claude Code docs say
Where the server entry is storedLocal and user scope: ~/.claude.json. Project scope: .mcp.json in the project root
TransportsHTTP, which Anthropic recommends for remote servers such as this one; SSE, now deprecated; stdio for local processes
Sign-inOAuth 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 approvalFrom 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 managedclaude mcp list, get and remove in the shell, /mcp in a session, and Customize, then Connectors, in the desktop app
Tool loadingTool search is on by default, so MCP tools are deferred and loaded on demand
PlanA 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 DirectoryA Community listing with the connector address, added August 2026. Community means screened, without an in-depth review

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.

ItemWhat it decidesSource
API keyWhich Ahrefs workspace is read. Sent as a bearer tokenAhrefs API keys page
Ahrefs planWhether the API accepts the call at all. A plan without API access is rejectedRyze AI Ahrefs guide
API unitsHow many calls fit in the month. Each call uses your own unit balanceAhrefs limits consumption page
Per-key unit limitA cap on one key's monthly use, set in Account settings, API keysAhrefs API keys page
Ryze AI plan or trialWhether the Ahrefs tool runs. Without one the connector lists workspaces and connects platforms onlyRyze 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.

ToolTypeWhat it does
ahrefs__readReadRuns 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.

LimitWhat the docs say
Cost of one requestmax(base cost, per-row cost x rows). The base cost is 50 units
Per-row costThe 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 exampleDomain 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 resultsRequests served from cache do not use units
Monthly allowanceSet by your Ahrefs plan. Track use in Account settings, Limits and usage
Ahrefs's own MCP serverOAuth 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 outputA warning above 10,000 tokens and a cap of 25,000 by default, changed with MAX_MCP_OUTPUT_TOKENS
Claude Code idle timeoutFive minutes for an HTTP server that sends no response or progress
Ryze AI connectionOne Ahrefs connection per workspace, and up to 20 workspaces per Claude or ChatGPT connection

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.

JobWhat to type in Claude CodeToolWorks on the default connection
Authority checkWhat is the Domain Rating of this domain?ahrefs__readYes
Link profile summaryShow the backlink and referring-domain counts for this domain.ahrefs__readYes
Referring domainsList the referring domains for this site, five rows only.ahrefs__readYes
Backlinks to one pageList backlinks to this exact URL, five rows only.ahrefs__readYes
Broken backlinksWhich broken backlinks point at my domain?ahrefs__readYes
Anchor textShow the anchor texts used for links to my domain.ahrefs__readYes
Organic keywordsList the organic keywords this site ranks for.ahrefs__readYes
Keyword overviewGive me the Keywords Explorer overview for these keywords in this country.ahrefs__readYes
Budget checkCheck my Ahrefs API limits and units used.ahrefs__readYes
Create a Rank Tracker project or run a site auditAdd this keyword list to Rank Tracker.noneNo. 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.

WayWhere it runsHow you add it in Claude CodeWhat it can reach in AhrefsCost
Ryze AI connector (the main way)Hosted by Ryze AI, one address for everyoneclaude 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 worksOne read tool for Ahrefs API v3: Domain Rating, site metrics, backlinks, broken backlinks, referring domains, anchors, organic keywords, Keywords Explorer overview, API limits and usageSEO 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/mcpclaude mcp add ahrefs https://api.ahrefs.com/mcp/mcp -t http, then /mcp, Authenticate, sign in to Ahrefs, pick the workspace and click AllowTool 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 infoNeeds an Ahrefs plan from Lite. Calls use your plan's monthly API units
Ahrefs MCP server with an MCP keyHosted by AhrefsAhrefs says you can generate an MCP key in your account and use it in your agent's configuration. Claude Code accepts a header through --headerSame groups as aboveSame 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

DateWhat happened
November 25, 2024Anthropic open-sourced the Model Context Protocol.
June 18, 2025Claude Code 1.0.27 added streamable HTTP servers and OAuth for remote servers, the transport and sign-in this guide uses.
February 18, 2026Claude Code 2.1.46 began to load claude.ai connectors.
June 22, 2026Claude Code 2.1.186 added claude mcp login and claude mcp logout.
August 2026The month the Ryze AI listing in Claude's Connectors Directory gives as its Added date.
September 28, 2026Claude Code 2.1.284 made interactive sessions start in auto mode on every plan and provider when no permission mode is set.
November 13, 2026Claude Code 2.1.325, the newest on its changelog when the Claude Code facts were read, came out.
November 21, 2026Ahrefs'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.

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 runWhat came back
Calls to AhrefsNone. No Ahrefs key was connected, so no Ahrefs call was run.
The Ahrefs tool nameTaken from the Ryze AI app source. It was not seen in a live tool list.
The steps inside Claude CodeNone run. No server was added with claude mcp add and no sign-in was made from /mcp.
Ahrefs's own serverRead 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.

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.

Connect Ahrefs to Claude Code

Connect Ahrefs once and use the same URL in other MCP clients. SEO Starter is $129 per month with a 3-day free trial; annual billing takes 30% off the first year.

Ahrefs MCP server

Need help? Read the Ryze AI Ahrefs guide or email Ryze AI support.