Ahrefs is the SEO platform many growth teams build their organic strategy on. Connecting Ahrefs to clariBI surfaces backlink growth, keyword ranking changes, traffic estimates, and competitor movement inside your AI analyses.
Why connect Ahrefs
SEO data usually lives in Ahrefs dashboards and requires manual exports for trend or comparison questions. Direct MCP access removes that step.
You can ask "Which keywords moved up in ranking this month?", "How does our backlink growth compare to Competitor X?", or "What pages are losing traffic this quarter?" and the AI engine pulls the answer against fresh Ahrefs data.
How the connection works
clariBI talks to Ahrefs through its hosted MCP server at https://api.ahrefs.com/mcp/mcp. Authentication uses an API key you generate in your vendor account. Tokens stay encrypted server-side and never leave clariBI in clear form.
sequenceDiagram
actor U as You
participant C as clariBI
participant V as Ahrefs
U->>V: Generate an API key in Ahrefs dashboard
U->>C: Paste the key into the connect wizard
C->>V: list_tools (verify the key)
V-->>C: Tools available
C->>C: Encrypt and store credentials
C-->>U: Connection ready
Available tools
clariBI exposes the read-only Ahrefs tools that the vendor's MCP server publishes at connection time. Write operations (create, update, delete, send, refund) are filtered out by a name-pattern blocklist before any tool reaches the analysis engine, so connecting Ahrefs cannot modify data on the vendor side.
The exact tool inventory depends on the Ahrefs features your account has access to. After connecting, try a few natural-language questions to see what Ahrefs data clariBI can pull.
Data flow during analysis
When you ask a question that maps to Ahrefs, the AI engine routes to the right tool, reads the result, and pairs the answer with a chart you can pin to a dashboard.
sequenceDiagram
actor U as You
participant C as clariBI
participant AI as AI engine
participant V as Ahrefs
U->>C: Ask a question about SEO and search-intelligence data
C->>AI: Plan the analysis
AI->>V: Call the right tool
V-->>AI: Tool result
AI->>AI: Summarize and chart
C-->>U: Answer plus visual
Setting up the connection
- Open Data Sources in the clariBI sidebar.
- Click Add data source.
- Open the MCP Servers tab.
- Click the Ahrefs card.
- In a new tab, sign in to Ahrefs and generate a read-only API key.
- Paste the key into clariBI and click Connect.
- Give your data source a name.
- Click Finish.
Permissions and data access
clariBI requests read access via your Ahrefs MCP-scoped API key. No data can be modified — Ahrefs MCP is read-only by design. The key is revokable from your Ahrefs API panel.
Troubleshooting
| Error | Cause | Fix |
|---|---|---|
| "401 Unauthorized" | The Ahrefs MCP key is missing, revoked, or not scoped for MCP. | Generate a new MCP-scoped key in your Ahrefs API panel, then update the key in clariBI Settings → Integrations. |
| "Plan does not include MCP access" | Ahrefs MCP requires a Lite plan or higher. | Upgrade your Ahrefs subscription to Lite or higher. |