Workato local MCP Proxy Server

A fallback proxy server for LLM clients that can't connect directly to remote MCP servers.

Overview

The latest MCP protocol versions (2024-11-05 specification) support direct connections to remote MCP servers for modern LLM clients (Claude Desktop, Cursor, etc.). However, not all clients support the latest protocol specifications yet.

Use this proxy only as a fallback if your LLM client doesn't support remote MCP connections. This server acts as a local compatibility bridge, proxying calls to Workato's remote MCP services when direct connection isn't possible due to protocol version limitations.

Supported Workato MCP Services

The proxy currently supports connections to both of Workato's MCP services:

• DevAPI MCP Service - Provides recipe management capabilities
• APIM MCP Service - Exposes API collections as MCP tool sets, enabling you to interact with published API endpoints as if they were native MCP functions

How to use it

Prerequisites

• Node.js (v18.0.0 or higher)
• npm (v8.0.0 or higher)
• LLM client (Claude Desktop, Cursor or VS Code)

MCP config file location for different LLM clients

• Cursor: ~/.cursor/mcp.json
• Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

For remote APIM MCP server

1. Get your REMOTE_MCP_URL: Copy your APIM collection URL from the Workato UI. For more details, see our documentation

2. Add the following configuration to your LLM client's config file. Note: Replace the example URL with your actual APIM collection URL and token.

{
  "mcpServers": {
    "workato-apim": {
      "command": "npx",
      "args": ["@workato/mcp-server"],
      "env": {
        "TYPE": "apim",
        "REMOTE_MCP_URL": "https://mcp.workato.com/your-username/your-collection-id?wkt_token={YOUR_API_TOKEN}"
      }
    }
  }
}

Alternatively, you can provide the auth token as a separate environment variable:

{
  "mcpServers": {
    "workato-apim": {
      "command": "npx",
      "args": ["@workato/mcp-server"],
      "env": {
        "TYPE": "apim",
        "REMOTE_MCP_URL": "https://mcp.workato.com/your-username/your-collection-id",
        "AUTH_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

For remote DevAPI MCP server

1. Generate your AUTH_TOKEN. For more details, see our documentation

2. Add the following configuration to your LLM client's config file. Note: Replace YOUR_AUTH_TOKEN with your actual auth token.

{
  "mcpServers": {
    "workato-apim": {
      "command": "npx",
      "args": ["@workato/mcp-server"],
      "env": {
        "env": {
          "TYPE": "devapi",
          "REMOTE_MCP_URL": "https://app.workato.com/sse",
          "AUTH_TOKEN": "YOUR_AUTH_TOKEN"
        }
      }
    }
  }
}