Knowledge Base
Knowledge Base
MCP
Getting Started

Getting Started

Connecting the Semrush MCP to your AI tools takes just a few minutes. Follow the setup instructions for your specific platform below.

ChatGPT

  1. In ChatGPT, navigate to Account → Settings → Apps
  2. Find and select Semrush
  3. Click Connect to enable the app
  4. In the modal, click Continue
  5. Review the access details on the permission screen, then click Approve

To use the Semrush app within ChatGPT chats, tag it directly as @Semrush in your prompts.

Getting Started image 1

Claude

  1. Open Claude and navigate to Settings → Connectors → Add custom connector
  2. Name the connector and add the Semrush MCP server URL: https://mcp.semrush.com/v1/mcp
  3. Save the changes

Getting Started image 2

Claude Code

  1. Open your terminal and run this command: claude mcp add semrush https://mcp.semrush.com/v1/mcp -t http
  2. Open Claude Code and run the /mcp command
  3. Select Semrush MCP from the list of MCP integrations
  4. Select Authenticate

Cursor

  1. Open Cursor and go to Settings → Cursor Settings → Tools & MCP
  2. Add the following Semrush MCP configuration to your Cursor MCP settings: 
    {
  "mcpServers": {
    "semrush": {
      "url": "https://mcp.semrush.com/v1/mcp"
    }
  }
}

     

  3. Save the changes

VS Code

  1. Create a .vscode/mcp.json file in your VS Code workspace
  2. Add the following MCP configuration to the file: 
    {
  "servers": {
    "semrush": {
      "url": "https://mcp.semrush.com/v1/mcp",
      "type": "http"
    }
  }
}

     

  3. Save the changes

Gemini

The Semrush MCP server authenticates with Gemini (Gemini CLI) using your Semrush API key.

1. Add the Semrush MCP server to Gemini. Open your terminal and run:

gemini mcp add --transport http \
  --header "Authorization: Apikey YOUR_API_KEY" \
  semrush https://mcp.semrush.com/v1/mcp

Replace YOUR_API_KEY with your actual Semrush API key.

2. Verify the server was added. Run:

gemini mcp list

You should see Semrush listed among your configured MCP servers.

Once added, the Semrush MCP server is available in Gemini CLI and can be used in your workflows.

 

Recently viewed