How to use WebPros Dashboard MCP?

Question

How to use WebPros Dashboard MCP?

Answer

WebPros Dashboard MCP can be used like any other MCP which can be integrated in different ways, for example:

  • Using your preferred Code Editor or IDE
  • From the Claude Desktop app
  • Directly via CLI in Claude, Copilot, Codex or Gemini

Below are instructions to the most popular setups:

Visual Studio Code PHPStorm Claude Desktop Codex Claude Code CLI Gemini CLI GitHub Copilot CLI

It is possible to configure MCP at Global or Workspace levels.

Global:

  1. In VS Code go to File > Open...
  2. Choose the file based on your operating system:

    • macOS: ~/Library/Application Support/Code/User/mcp.json
    • Windows: %APPDATA%\Code\User\mcp.json
    • Linux: ~/.config/Code/User/mcp.json

    Note: If the file doesn't exist yet, create it at the same location as above.

  3. Paste the following content into the file and save it:

    { "servers": { "webpros-dashboard": { "type": "http", "url": "https://mcp.webpros.com/api/mcp", "headers": { "Authorization": "Bearer WEBPROS_MCP_KEY" } } } } 

  4. A small Start link appears just above "webpros-dashboard" - click it to connect.

 

Note: replace WEBPROS_MCP_KEY with a real key you created using How to create WebPros Dashboard MCP key?

 

Workspace:

  1. Open your project folder in VS Code at File > Open Folder...
  2. In the Explorer sidebar hover over the project root and click the New Folder icon. Name it exactly: .vscode

    Note: If a .vscode folder already exists, skip this step.

  3. Select the .vscode folder, click the New File icon, and name it exactly: mcp.json
  4. Paste the following content into the file and save it:

    { "servers": { "webpros-dashboard": { "type": "http", "url": "https://mcp.webpros.com/api/mcp", "headers": { "Authorization": "Bearer WEBPROS_MCP_KEY" } } } } 

  5. A small Start link appears just above "webpros-dashboard" - click it to connect.

 

Note: replace WEBPROS_MCP_KEY with a real key you created using How to create WebPros Dashboard MCP key?

  1. Open Settings and go to Tools > AI Assistant > Model Context Protocol (MCP) page.
  2. Click + Add (or New MCP Server) button.
  3. Paste the JSON below:

    { "mcpServers": { "webpros-dashboard": { "url": "https://mcp.webpros.com/api/mcp", "headers": { "Authorization": "Bearer WEBPROS_MCP_KEY" } } } } 

  4. Click OK or Apply. The server should show a green "connected" indicator once it loads its tools:

 

Note: replace WEBPROS_MCP_KEY with a real key you created using How to create WebPros Dashboard MCP key?

Claude Desktop connects to the WebPros Dashboard MCP through the mcp-remote bridge, which requires Node.js to be installed.

  1. In Claude Desktop go to Settings > Developer and click Edit Config. This opens claude_desktop_config.json:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Paste the following content into the file and save it. If the file already has content, add only the webpros-dashboard entry inside mcpServers:

    { "mcpServers": { "webpros-dashboard": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.webpros.com/api/mcp", "--header", "Authorization:${AUTH_HEADER}"], "env": { "AUTH_HEADER": "Bearer WEBPROS_MCP_KEY" } } } }

  3. Fully quit Claude Desktop and open it again. The webpros-dashboard tools appear in the tools menu of the chat input.

 

Note: replace WEBPROS_MCP_KEY with a real key you created using How to create WebPros Dashboard MCP key? The header is passed through AUTH_HEADER because Claude Desktop on Windows can break arguments that contain spaces.

Codex CLI, the Codex IDE extension and the ChatGPT desktop app share the same MCP configuration, so it only needs to be added once.

Option 1: CLI

  1. Store the key in an environment variable (add the line to ~/.zshrc or ~/.bashrc so it persists):

    export WEBPROS_MCP_KEY="your_key_here"

  2. Run the next CLI command in the terminal:

    codex mcp add webpros-dashboard --url https://mcp.webpros.com/api/mcp --bearer-token-env-var WEBPROS_MCP_KEY

  3. Run codex mcp list or type /mcp inside Codex to confirm the server is listed.

Option 2: config.toml

  1. Open ~/.codex/config.toml (on Windows %USERPROFILE%\.codex\config.toml). If the file doesn't exist yet, create it.
  2. Add the following content and save it:

    [mcp_servers.webpros-dashboard]
    url = "https://mcp.webpros.com/api/mcp"
    http_headers = { "Authorization" = "Bearer WEBPROS_MCP_KEY" }
  3. Restart Codex and type /mcp to confirm the server is connected.

 

Note: replace WEBPROS_MCP_KEY with a real key you created using How to create WebPros Dashboard MCP key? In Option 1, WEBPROS_MCP_KEY is the name of the environment variable that holds the key, so only the export line contains the real key.

Run the next CLI command in the terminal:

claude mcp add --transport http webpros-dashboard https://mcp.webpros.com/api/mcp --header "Authorization: Bearer WEBPROS_MCP_KEY"

 

Note: replace WEBPROS_MCP_KEY with a real key you created using How to create WebPros Dashboard MCP key?

Option 1: CLI

Run the next CLI command in the terminal:

gemini mcp add --scope user --transport http --header "Authorization: Bearer WEBPROS_MCP_KEY" webpros-dashboard https://mcp.webpros.com/api/mcp

Note: --scope user makes the server available in all projects. Without it, the server is added only to the current project.

Option 2: settings.json

  1. Open the file based on your operating system:

    • macOS and Linux: ~/.gemini/settings.json
    • Windows: %USERPROFILE%\.gemini\settings.json

    Note: If the file doesn't exist yet, create it at the same location as above.

  2. Add the following content and save it. If the file already has content, add only the mcpServers block:

    { "mcpServers": { "webpros-dashboard": { "httpUrl": "https://mcp.webpros.com/api/mcp", "headers": { "Authorization": "Bearer WEBPROS_MCP_KEY" } } } }

  3. Restart Gemini CLI and type /mcp to confirm the server is connected and its tools are listed.

 

Note: replace WEBPROS_MCP_KEY with a real key you created using How to create WebPros Dashboard MCP key?

Run the next CLI command in the terminal:

copilot mcp add --transport http --header "Authorization: Bearer WEBPROS_MCP_KEY" webpros-dashboard https://mcp.webpros.com/api/mcp 

 

Note: replace WEBPROS_MCP_KEY with a real key you created using How to create WebPros Dashboard MCP key?

Was this article helpful?
2 out of 2 found this helpful

Comments

0 comments

Please sign in to leave a comment.