Connect an AI client with MCP

Give Claude and other compatible clients scoped access to CrawlRaven reports, with optional write permissions you approve separately.

Product guide · Updated October 2026

What an MCP connection does

CrawlRaven’s remote Model Context Protocol server lets a compatible AI client use the account, websites, Search Console performance, opportunities, target keywords, active annotations, linked GA4 reports, stored Technical SEO audits, and imported Generative AI snapshots you authorize.

A paid connection may also request separate permissions to change opportunity status, target keywords, or manual notes, or to propose note changes for your review. The client signs in through OAuth; you do not create or paste a Google token, browser cookie, or personal secret.

The endpoint shown in the app is https://mcp.crawlraven.com/mcp.

Connect a compatible client

  1. 1

    Open MCP connections

    From the account menu, choose MCP connections, or open the MCP page.
  2. 2

    Copy the endpoint

    Use Copy endpoint in the Remote MCP server section.
  3. 3

    Add a custom connector

    In Claude or another compatible client, add a remote Streamable HTTP MCP server and paste the endpoint.
  4. 4

    Sign in in the browser

    The client opens CrawlRaven’s authorization screen.
  5. 5

    Review and approve

    Check the client name, account, website when required, and every requested permission. Analytics, Technical SEO audits, and each write permission are separate paid permissions.
  6. 6

    Return to the client

    Let the redirect and token exchange finish. The CrawlRaven tools should then appear.

Understand free preview and paid access

AccessBehavior
Free MCP previewWhen enabled for the account: 9 tools for one pinned activated website, fixed 28-day Search performance, up to 50 rows per result, no pagination, custom periods, annotations, Analytics, Technical SEO, Generative AI, or writes, and 20 tool calls per account each UTC day.
Paid MCP accessRead tools for Search Console, Generative AI imports, opportunities, the prioritized plan, target keywords, and alignment, with paid windows and bounded pagination. View analytics, View Technical SEO audits, and each write permission add their own tools, for up to 30 when every permission is approved.
Role restrictionAn account owner or member must approve a connection. A user without that permission can see that the account is eligible but cannot connect it.

The account’s first free grant pins the preview website; another free grant cannot switch it. A connection approved under free preview also does not silently expand later. Reconnect the client after upgrading so you can review and approve broader access. Existing paid connections also retain their original scopes; reconnect to add any newly available permission.

Continue with Use the free MCP preview or Use MCP with full access. Exact tool and OAuth details remain in the MCP server reference.

Try prompts and manage connected clients

Replace [your site] with the exact CrawlRaven site name or domain before pasting a prompt.

  • “How did [your site] do in search over the last 28 days?”
  • “Show the highest-priority active opportunities and explain the evidence behind the top three.”
  • “Which target keywords have no planned target page yet?”
  • “Find the pages that lost the most clicks and summarize what changed.”
  • “Use linked GA4 to compare landing-page sessions and key events over the last 28 complete days.”
  • “Plan a manual note for [your site] on [date], show me the exact proposal, and wait for my approval.”

Name the site in your prompt so the client can select the right website quickly. The MCP connections page lists active clients, when each was last used, and when access expires. Connections expire after 90 days.

  1. 1

    Find the client

    Open Connected clients and verify its name, account, and identity host.
  2. 2

    Select Revoke

    A confirmation control appears beside the client.
  3. 3

    Confirm

    The grant is invalidated for future requests and moves into Previous connections.