Connect opencode to Google Search Console

How to connect Google Search Console to opencode

1. 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, then pick which sites to grant. The connect page shows your bearer token once, so copy it now. If you lose it, create a new one at app.gscpap.com/account/tokens; existing tokens keep working.

2. 2

   Put the token in your shell environment

   Keep the token out of the config file itself. opencode can read it from the environment at load time, which also means the same config works on another machine without editing.

   shellCopy

   # macOS, Linux
   echo 'export GSC_PAP_TOKEN="paste-your-token-here"' >> ~/.zshrc
   source ~/.zshrc
   
   # Windows (PowerShell, persistent)
   [Environment]::SetEnvironmentVariable("GSC_PAP_TOKEN", "paste-your-token-here", "User")

3. 3

   Add the server to opencode.json

   Open your opencode config, opencode.json or opencode.jsonc, and add the block below under the mcp key. Note that the key is mcp, not mcpServers: opencode uses its own shape rather than the one Claude Desktop and Cursor share. If the file already lists servers, add the gsc-pap entry inside the existing mcp object.

   jsonCopy

   {
     "$schema": "https://opencode.ai/config.json",
     "mcp": {
       "gsc-pap": {
         "type": "remote",
         "url": "https://mcp.gscpap.com/mcp",
         "enabled": true,
         "oauth": false,
         "headers": {
           "Authorization": "Bearer {env:GSC_PAP_TOKEN}"
         }
       }
     }
   }

4. 4

   Check that opencode sees it

   List the servers opencode knows about. gsc-pap should appear as a remote server. If a connection looks wrong, the debug command prints what happened during the handshake, which is the fastest way to tell a bad token from a bad URL.

   shellCopy

   opencode mcp list
   opencode mcp debug gsc-pap

5. 5

   Ask a Search Console question

   Start opencode in a project and ask: "Using gsc-pap, what are my top queries by clicks over the last 28 days?" The agent calls list_sites first to find your property, then search_analytics_query. From there you can ask for quick wins, decaying pages or a period comparison without leaving the terminal.

opencode MCP setup: common issues

• ·The config key is mcp, and the server needs "type": "remote". Under mcpServers, or without the type, opencode will not load it.
• ·Set "oauth": false when you authenticate with a header. Otherwise opencode can try to negotiate OAuth with the server and the bearer token never gets used.
• ·If opencode.json lives in a repo, use the {env:GSC_PAP_TOKEN} form rather than pasting the token. A bearer token in a committed config is a token you have to rotate.
• ·"Missing or invalid bearer token" means the environment variable was empty when opencode started, not that the token is wrong. Check it with echo $GSC_PAP_TOKEN in the same shell you launch opencode from.
• ·Nothing here needs a Google Cloud project. If a guide tells you to download a credentials JSON, it is describing a self-hosted server, not this one.

Frequently asked questions