Integration · JetBrains IDEs
Connect JetBrains AI Assistant to Google Search Console
5 steps · about 5 minutes
By the GSC PAP team · Updated
JetBrains AI Assistant can use Model Context Protocol (MCP) servers over STDIO, Streamable HTTP and SSE. You add them under Settings > Tools > AI Assistant > Model Context Protocol (MCP), the same page in IntelliJ IDEA, PyCharm, WebStorm, GoLand, RubyMine, PhpStorm and the other JetBrains IDEs that run AI Assistant.
GSC PAP is a remote Streamable HTTP server that authenticates with a bearer token in the Authorization header.
How to connect Google Search Console to JetBrains AI Assistant
- 1
Sign in to GSC PAP and copy your token
Go to gscpap.com and click "Sign in with Google." Approve the read-only access it asks for. The connect page then shows your bearer token once, so copy it now. If you lose it, create a new one at app.gscpap.com/account/tokens; your other tokens keep working.
- 2
Open the MCP settings
Go to Settings > Tools > AI Assistant > Model Context Protocol (MCP) and click Add. You can also get there by typing / in the AI Assistant chat and choosing Add Command.
- 3
Paste the gsc-pap configuration
In the New MCP Server dialog, choose the URL-based (remote) connection and paste the JSON below with your token in place of YOUR_TOKEN. Set the server level to Global so it is available in every project, then click OK and Apply. Apply starts the server.
json{ "mcpServers": { "gsc-pap": { "url": "https://mcp.gscpap.com/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } } - 4
Check the status and ask a question
The Status column shows whether AI Assistant connected. Click the icon in that column to see the tools gsc-pap provides. Then open the AI Assistant chat and ask: "What sites are in my Search Console? Give me the top 5 queries by clicks last week." AI Assistant calls the tools when they fit, or you can type / to run one directly.
- 5
If authentication fails, use a local bridge
Only needed if step 4 shows "Missing or invalid bearer token" even with a fresh token. JetBrains documents remote servers with a url only and does not mention headers, so if your build does not send the header, replace the entry with this STDIO configuration. It runs the open-source mcp-remote package through npx (Node.js required), which forwards requests to GSC PAP and adds the header. Keep Authorization:${AUTH_HEADER} without spaces; the value with the space goes in env.
json{ "mcpServers": { "gsc-pap": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.gscpap.com/mcp", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "Bearer YOUR_TOKEN" } } } }
JetBrains MCP setup: common issues
- ·"Missing or invalid bearer token" means the server did not receive a valid token. Create a new one at app.gscpap.com/account/tokens; if a fresh token still fails, use the bridge in step 5.
- ·After you change a server's configuration, click Apply. To have new and changed servers start on their own, turn on Automatically enable new and changed MCP servers on the same settings page.
- ·To reconnect, select gsc-pap and click Reconnect. To stop it, clear its checkbox and click Apply.
- ·For logs, choose Help > Show Log in Finder (macOS) or Show Log in Explorer (Windows) and open the mcp folder. It holds one log per configured server.
- ·If your organization manages AI Assistant centrally, an administrator may have preconfigured MCP servers and turned off adding your own.
Frequently asked questions
Which JetBrains IDEs can connect to Google Search Console?
Any JetBrains IDE that runs AI Assistant, including IntelliJ IDEA, PyCharm, WebStorm, GoLand, RubyMine and PhpStorm. The Model Context Protocol (MCP) settings page is the same across them, so these steps apply to all of them.
Do I need a Google Cloud project to use Search Console in IntelliJ or PyCharm?
No. You skip the Google Cloud Console entirely: no project, no API to enable, no OAuth credentials to create. Sign in with Google at gscpap.com and paste the bearer token into the gsc-pap entry in AI Assistant's MCP settings.
Can I reuse my Claude Desktop MCP setup?
Yes. The MCP settings page has an Import from Claude button that adds the servers from your Claude Desktop configuration to the list, including a gsc-pap entry if you already set one up there.
Other integrations
All integrationsClaude Desktop
Connect Claude Desktop to Google Search Console without creating a Google Cloud project. Sign in with Google, paste one config block, restart Claude.
Cursor
Connect Google Search Console to Cursor through a hosted MCP server. Sign in with Google, paste one token into mcp.json, and skip the Google Cloud project.
Claude Code
Add Google Search Console to Claude Code with one claude mcp add command. Hosted and read-only: no Google Cloud project, no OAuth credentials, no Python.
Codex CLI (OpenAI)
Add Google Search Console, GA4 and PageSpeed data to OpenAI's Codex CLI with one TOML block and a bearer token. You never create a Google Cloud project.
VS Code (GitHub Copilot)
Connect Google Search Console to GitHub Copilot in VS Code with one .vscode/mcp.json entry, then ask agent mode about GSC. You skip Google Cloud setup.
Gemini CLI (Google)
Query Google Search Console (GSC) from your terminal with Gemini CLI. Register GSC PAP as an MCP server in settings.json, with no Google Cloud project.
Windsurf (Devin Desktop)
Give Windsurf, now Devin Desktop, your Google Search Console data. Add GSC PAP as a remote MCP server with one bearer token and no Google Cloud project.
Zed Editor
Bring Google Search Console into Zed's AI assistant as an MCP context server. You add one settings.json block and a token, with no Google Cloud setup.
Continue (extension)
Continue MCP setup for Google Search Console: add one mcpServers entry with a bearer token in VS Code or JetBrains. You do not need a Google Cloud project.
Claude.ai (browser)
Add Google Search Console to Claude.ai as a custom connector. Paste one URL and approve access. No token to copy, no config file, no Google Cloud project.
Direct HTTP (curl, custom agents)
Call the GSC PAP MCP server from curl or your own agent. It is JSON-RPC over HTTP with a bearer token, so you need no MCP client or Google Cloud project.
opencode
Add Google Search Console to opencode as a remote MCP server. One config block with your token, no Google Cloud project, no local server to run.
Cline
Add Google Search Console to Cline in VS Code or the Cline CLI as a remote MCP server. One token, no Google Cloud project, read-only access.
Warp
Add Google Search Console to Warp's agent as a remote MCP server. Paste one JSON block with your token, press Start, and ask about your traffic in the terminal.
LM Studio
Give a local model your Search Console data. Add GSC PAP to LM Studio's mcp.json as a remote server, with one token and no Google Cloud project.
ChatGPT
Add Google Search Console to ChatGPT as a custom MCP server. What the setup looks like, and the plan requirement that decides whether you can do it at all.
Goose
Add Google Search Console to Goose as a streamable_http extension. One block in config.yaml with your token, no Google Cloud project, read-only access.
Google Antigravity
Add Search Console to Google Antigravity as a custom MCP server. It handles dynamic client registration, so the setup is a URL and a sign-in, with no token.
Roo Code
Add Google Search Console to Roo Code in VS Code as a streamable-http MCP server. One block with your token, no Google Cloud project, read-only.
Kilo Code
Add Google Search Console to Kilo Code as a remote MCP server. It can negotiate OAuth for you, or take a bearer token. No Google Cloud project either way.
Amp
Add Google Search Console to Amp as a remote MCP server, in settings or with one CLI command. No Google Cloud project, read-only scopes.
Kiro
Add Google Search Console to Kiro as a remote MCP server. One entry in mcp.json, the token read from an approved environment variable, read-only access.
Raycast
Add Google Search Console to Raycast AI as an HTTP MCP server. Dynamic OAuth means no token to paste, and HTTP servers work on Raycast for iOS too.
GitHub Copilot CLI
Add Google Search Console to GitHub Copilot CLI with one command or one JSON entry. Remote HTTP transport, your token in a header, read-only access.
n8n
Give an n8n AI Agent your Search Console data through the MCP Client Tool node, and schedule the SEO report you keep meaning to write.
LibreChat
Add GSC PAP to librechat.yaml as a streamable-http MCP server, and give every user on your install their own Search Console access rather than a shared one.