MCP server

No token needed — on the first request, a browser opens with the WorkZeal sign-in page:

claude mcp add --transport http workzeal https://mcp.workzeal.com/mcp

The tools appear in a new Claude Code session. You can check the connection and complete authorization with the /mcp command inside the session.

By default, the server is added only for the current project. To make it available in all projects, add the --scope user flag.

Token option (if signing in via browser is not suitable, for example on a server):

claude mcp add --transport http workzeal https://mcp.workzeal.com/mcp \
  --header "Authorization: Bearer <token>"

Save the token to an environment variable and add the server to the ~/.codex/config.toml configuration file:

export WORKZEAL_MCP_TOKEN="<token>"

[mcp_servers.workzeal]
url = "https://mcp.workzeal.com/mcp"
bearer_token_env_var = "WORKZEAL_MCP_TOKEN"
enabled = true

Or with a CLI command:

codex mcp add workzeal --url https://mcp.workzeal.com/mcp

Then restart Codex. The server will appear in the codex mcp list output.

Open Settings → MCP → Add new MCP Server or create a .cursor/mcp.json file in the project root (for all projects, ~/.cursor/mcp.json):

{
  "mcpServers": {
    "workzeal": {
      "url": "https://mcp.workzeal.com/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

After saving, the server appears in the Settings → MCP list. The toggle should turn green.

In recent versions of Cursor, you can omit headers. In that case, the WorkZeal sign-in page (OAuth) opens when connecting.

Create a .vscode/mcp.json file in the workspace folder:

{
  "servers": {
    "workzeal": {
      "type": "http",
      "url": "https://mcp.workzeal.com/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

Then start the server from the MCP panel (the MCP: List Servers command in the command palette).

In recent versions of VS Code, you can omit headers. In that case, the WorkZeal sign-in page (OAuth) opens when the server starts.

Any MCP client that supports the Streamable HTTP transport will work. If the client supports MCP OAuth authorization, just enter the address https://mcp.workzeal.com/mcp, and sign-in will go through the browser. Otherwise, specify in the settings:

• URL: https://mcp.workzeal.com/mcp
• Header: Authorization: Bearer <token>

Example of a direct call to check the connection:

curl -X POST https://mcp.workzeal.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer <token>" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

The response contains information about the server and its instructions, which means the connection works. Subsequent requests (for example, tools/list) are sent with the Mcp-Session-Id header taken from the headers of this response. MCP clients do this automatically.

For platforms that do not yet support Streamable HTTP (for example, Yandex AI Studio agents), specify the legacy HTTP+SSE transport address instead: https://mcp.workzeal.com/mcp/sse, with the same authorization header.