Skip to main content
Claude Code connects to Gcore MCP Server in dynamic mode. Leave GCORE_TOOLS unset. The client receives six tools and can reach every operation. Pattern rules for a narrower set are in Tool filtering.

Step 1. Install Claude Code

After installation, restart PowerShell to update the PATH.
Verify the installation:

Step 2. Authenticate Claude Code

  1. Start Claude Code in any directory:
  1. On first launch, select a color theme and press Enter.
  2. Enter the login command:
  1. A browser window opens for authentication. Sign in with a Claude Pro, Max, Team, or Enterprise account.
  2. If the browser displays an authentication code instead of redirecting automatically, copy the code and paste it into the terminal prompt.
Claude Code requires a paid subscription (Pro, Max, Team, or Enterprise). Free accounts cannot use Claude Code.

Step 3. Configure Gcore MCP Server

The configuration file defines MCP server connections. Add Gcore MCP Server to enable Gcore API access.
Open the configuration file:
Add the Gcore MCP Server entry to the mcpServers section:
Replace API_TOKEN with the Gcore API token. Save the file.
If the configuration file already contains other settings, merge the mcpServers section without overwriting existing content. JSON syntax errors cause Claude Code to fail silently.

Step 4. Verify the connection

Claude Code waits 30 seconds for the tool list. The Gcore server can take longer to send it. Set MCP_TIMEOUT to 120000 in the same terminal before starting Claude Code.
The output shows gcore-mcp-server with status Connected:
Start Claude Code in the same terminal and test with a resource query:
A successful response lists CDN resources with the resource id, CNAME, and status:
tools fetch failed - Request timed out means the wait ended before the tool list arrived. Raise MCP_TIMEOUT and run the check again in the same terminal. Failed to connect means the process did not start. Verify that uv is installed and the API key is valid. Test the API key independently:
A 200 response confirms valid credentials. A 401 response indicates an invalid or expired key.

Tools the server exposes

The configuration above leaves GCORE_TOOLS unset, so Claude Code receives search_tools, get_tool_schema, call_read_tool, call_write_tool, call_destructive_tool, and execute_code. Setting GCORE_TOOLS without GCORE_MCP_MODE selects direct mode. GCORE_TOOLS=* in that mode registers 818 tools, one per operation. A value that matches nothing exits with status 2. Limit the set with Tool filtering.