Connect Claude to the EdgeComet MCP server
You connect Claude to EdgeComet by adding https://cloud.edgecomet.com/mcp as a custom connector in claude.ai or Claude Desktop, or as an HTTP MCP server in Claude Code. You then sign in to EdgeComet in your browser and approve the connection.
A connector you add on claude.ai also works in Claude Desktop and the Claude mobile apps. The steps follow Anthropic's documentation. For the shared steps and revoking access, see Connect an AI client to the EdgeComet MCP server.
Before you start
- An EdgeComet account, or create one while you connect: the sign-in window has Start a free trial and Continue with Google. A new account can add its website from the chat, see Add your website from Claude.
- A Claude plan that allows custom connectors. Anthropic's help center says: "Free users are limited to one custom connector."
- On Team and Enterprise plans, an Owner adds the connector for the organization. On Enterprise, people with a custom role that includes Manage access to Libraries can add it too. See Team and Enterprise.
Add the connector in claude.ai or Claude Desktop
- Open Customize in the sidebar, then Connectors. On the web, the page is
claude.ai/customize/connectors. - Press + Add, then Add custom connector.
- Enter the name
EdgeCometand the server URLhttps://cloud.edgecomet.com/mcp, then press Continue. - Review the authentication settings Claude detected and press Continue.
- Under Authentication, choose Sign in now.
- Under OAuth client, choose Register automatically. EdgeComet registers each client on request, with no client ID to enter.
- Press Add.
- Your browser opens EdgeComet. If you are not signed in, sign in, or press Start a free trial to create an account. The browser then shows the screen Authorize Claude.
- Check the account under Signed in as and the address under After you authorize, you return to, then press Authorize.
To use EdgeComet in a conversation, press + in the message box, open Connectors and turn on EdgeComet. Then ask, for example, "List my EdgeComet websites."
Team and Enterprise
- An Owner opens Organization settings > Connectors and presses Add.
- The Owner hovers over Custom and selects Web.
- The Owner enters the name
EdgeCometand the URLhttps://cloud.edgecomet.com/mcp, presses Continue, reviews the detected settings and presses Continue again. - Under OAuth client, the Owner chooses Register automatically and presses Add.
- Each member opens Customize > Connectors, finds EdgeComet marked Custom, presses Connect and approves the EdgeComet sign-in screen.
Each member signs in with their own EdgeComet account and sees only the websites that account can open. The tools run with that member's role on each website. See Who can run each tool.
Add the server to Claude Code
In your project folder, run:
bashclaude mcp add --transport http edgecomet https://cloud.edgecomet.com/mcpThe server is saved for you in this project. Add
--scope userto use it in every project.Start Claude Code, run
/mcp, select edgecomet and choose Authenticate.Approve the EdgeComet sign-in screen in your browser. It reads Authorize Claude Code (edgecomet).
Before you sign in, claude mcp get edgecomet shows Status: ! Needs authentication. After you sign in, claude mcp list shows the server as connected.
To share the server with your team, commit a .mcp.json file at the root of the repository. Claude Code asks each teammate to approve it, and each one signs in with their own EdgeComet account:
{
"mcpServers": {
"edgecomet": {
"type": "http",
"url": "https://cloud.edgecomet.com/mcp"
}
}
}A connector you added on claude.ai also appears in Claude Code for the same Claude account, as claude.ai edgecomet. You do not need both.
Add your website from Claude
A new account can add its website without leaving the conversation:
- Ask Claude to add your website to EdgeComet, for example "Add example.com to EdgeComet."
- Claude calls
add_websitewith your domain. This call analyzes the site and creates nothing. It compares the raw HTML of your homepage with the page after JavaScript ran. - Claude tells you what the analysis found and which serving mode it recommends: Cache-only for sites whose server sends complete HTML, Cache + Render for sites whose content needs JavaScript. Confirm the mode or pick the other one. See Choose a serving mode.
- Claude calls
add_websiteagain with the mode you chose. This call creates the website in your account. - Open the link Claude gives you. If EdgeComet detected Cloudflare in front of your site, the link opens the Cloudflare install, where you connect your Cloudflare account. Otherwise, it opens the website's integration page, and Claude can also give you a link to book a setup call.
Claude asks you to approve both add_website calls. You can add 3 websites and run 20 analyses in 24 hours this way. For more, use the dashboard: see Add your first website.
After the install, the first verified bot visit usually arrives within 24 hours, and the first Evergreen Crawl report 3 days after that. Bot reports read zero until the first visit. Ask Claude to list your websites to see the setup phase: live means bot data has arrived. Connect Search Console in the dashboard, see Connect Search Console. See What happens in your first days.
Every account also sees EdgeComet's demo website in its list. It holds sample data for a look at the reports while you wait. See The demo website.
Set tool permissions
- claude.ai and Claude Desktop: open the connector under Customize > Connectors and set each tool to Always allow, Needs approval or Blocked. Anthropic's connector docs say: "Read-only tools can run without per-call confirmation, and destructive tools always prompt."
- Claude Code: add permission rules to
.claude/settings.json, such asmcp__edgecomet__queryfor one tool ormcp__edgecomet__get_*for a group. A claude.ai connector's tools are namedmcp__claude_ai_edgecomet__<tool>.
Claude can run the EdgeComet tools marked read-only without asking each time. The others carry MCP's destructive hint, and Claude asks before each call: add_website, export, read_page, the keyword research tools, the tools that save, change or discard Edge SEO drafts, draft_scoped_rule and map_redirects. See Read-only tools and approvals.
Remove the connector
- claude.ai and Claude Desktop: open Customize > Connectors and press Remove, or open the three dots next to EdgeComet and remove it there. On Team and Enterprise, Owners remove it under Organization settings > Connectors.
- Claude Code: run
claude mcp remove edgecomet. Claude Code also deletes the sign-in it stored for the server.
Then revoke the connection in EdgeComet. See Manage and revoke connections.