@kristasoft/mcp-proxy

Connect any MCP client (Claude Desktop, Cursor, VS Code Copilot, Windsurf, ChatGPT, and more) to your Krista workspace.

Quick Start

Add this to your MCP client's config:

{
  "mcpServers": {
    "krista": {
      "command": "npx",
      "args": ["-y", "@kristasoft/mcp-proxy"],
      "env": {
        "KRISTA_MCP_ENDPOINT": "https://your-krista-host/extension/api/.../rest/mcp/mcp",
        "KRISTA_AUTH_TOKEN": "krista_mcp_..."
      }
    }
  }
}

Get your Endpoint URL and API Key from Krista Studio > MCP Server > Setup Guide tab.

Client-Specific Config Locations

| Client | Config File | |--------|-------------| | Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) | | Claude Code | .mcp.json (project) or ~/.claude.json (global) | | Cursor | ~/.cursor/mcp.json | | VS Code Copilot | .vscode/mcp.json | | Windsurf | ~/.codeium/windsurf/mcp_config.json | | ChatGPT Desktop | Settings > MCP Servers | | OpenAI Codex | ~/.codex/config.json | | JetBrains IDEs | Settings > AI Assistant > MCP | | Amazon Q | ~/.aws/amazonq/mcp.json | | Cline | Same as Claude Desktop format | | Continue | .continue/mcpServers/ |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | KRISTA_MCP_ENDPOINT | Yes | — | Full URL to the Krista MCP endpoint | | KRISTA_AUTH_TOKEN | Yes | — | API key (starts with krista_mcp_) | | KRISTA_TIMEOUT | No | 120 | Request timeout in seconds (30-600) | | KRISTA_LOG_LEVEL | No | info | Log level: debug, info, warn, error |

How It Works

MCP Client → stdio → @kristasoft/mcp-proxy → HTTPS POST → Krista MCP Server

The proxy reads JSON-RPC 2.0 messages from stdin, forwards them to your Krista MCP Server endpoint over HTTPS, and writes responses back to stdout.

Logs

Log files are written to:

• macOS/Linux: /tmp/krista-mcp/proxy.log
• Windows: %TEMP%\krista-mcp\proxy.log

Set KRISTA_LOG_LEVEL=debug for verbose logging.

What You Can Do

Once connected, your AI assistant can:

• Start workflows — trigger leave requests, approvals, tickets
• Complete tasks — fill forms, approve/reject, answer questions
• Query data — fetch emails, check statuses, list records
• Check pending items — see what needs your attention

Requirements

• Node.js 18+
• A Krista workspace with the MCP Server extension installed
• An API key from the Setup Guide tab

Links

• Krista Software
• MCP Protocol