Connect an AI client with MCP
Give Claude and other compatible clients scoped access to CrawlRaven reports, with optional human-approved manual annotation management.
Product guide · Updated August 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, and linked GA4 reports you authorize. A paid connection may also request permission to propose manual 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
Open MCP connections
From the account menu, choose MCP connections, or open the MCP page. - 2
Copy the endpoint
Use Copy endpoint in the Remote MCP server section. - 3
Add a custom connector
In Claude or another compatible client, add a remote Streamable HTTP MCP server and paste the endpoint. - 4
Sign in in the browser
The client opens CrawlRaven’s authorization screen. - 5
Review and approve
Check the client name, account, website when required, and every requested permission. View analytics and Manage annotations are separate paid permissions. - 6
Return to the client
Let the redirect and token exchange finish. The CrawlRaven tools should then appear.
Understand free preview and paid access
| Access | Behavior |
|---|---|
| Free MCP preview | When enabled for the account: one pinned activated website, fixed 28-day Search performance, up to 50 Query, Page, Opportunity, or Target Keyword rows, no pagination, custom periods, or annotations, and 20 tool calls per account each UTC day. |
| Paid MCP access | Eight core read tools, paid Search Console windows, and bounded pagination. View analytics adds two tools; Manage annotations adds three, for up to 13 tools when every permission is approved. |
| Role restriction | An 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 newly available Analytics or annotation permissions.
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
Find the client
Open Connected clients and verify its name, account, and identity host. - 2
Select Revoke
A confirmation control appears beside the client. - 3
Confirm
The grant is invalidated for future requests and moves into Previous connections.