Jedify MCP Auth Proxy

OAuth authentication proxy for Jedify MCP servers. This package allows you to use Jedify's MCP servers with Claude Desktop, handling OAuth authentication automatically.

Installation

npx @jedify/mcp-auth

Or install globally:

npm install -g @jedify/mcp-auth

Usage

With npx (recommended)

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "jedify": {
      "command": "npx",
      "args": ["@jedify/mcp-auth"],
      "env": {
        "REMOTE_MCP_URL": "https://your-server.jedify.com/mcp/sse",
        "DESCOPE_PROJECT_ID": "YOUR_PROJECT_ID"
      }
    }
  }
}

With global installation

{
  "mcpServers": {
    "jedify": {
      "command": "jedify-mcp-auth",
      "env": {
        "REMOTE_MCP_URL": "https://your-server.jedify.com/mcp/sse",
        "DESCOPE_PROJECT_ID": "YOUR_PROJECT_ID"
      }
    }
  }
}

Command line usage

jedify-mcp-auth <REMOTE_MCP_URL> <DESCOPE_PROJECT_ID>

Or with environment variables:

export REMOTE_MCP_URL=https://your-server.jedify.com/mcp/sse
export DESCOPE_PROJECT_ID=YOUR_PROJECT_ID
jedify-mcp-auth

How it works

1. The proxy intercepts MCP messages between Claude Desktop and your remote Jedify server
2. When it detects "default" values for tenant_id or user_id, it initiates OAuth authentication
3. A browser window opens for you to authenticate with Descope
4. After successful authentication, the proxy forwards all requests with the bearer token
5. All subsequent requests are authenticated automatically

Requirements

• Node.js 18 or higher
• A Jedify MCP server with OAuth enabled
• A Descope project ID

Publishing to npm

To publish this package to npm:

1. Create an npm account at https://www.npmjs.com/signup

2. Login to npm:

   npm login

3. Build the package:

   cd src/mcp_interface/jedify-mcp-auth
   npm install
   npm run build

4. Test locally:

   npm link
   # In another terminal, test with:
   npx jedify-mcp-auth

5. Publish to npm:

   npm publish --access public

   Note: The first time you publish a scoped package (@jedify/mcp-auth), you need to use --access public to make it publicly available.

6. After publishing, users can immediately use it with:

   npx @jedify/mcp-auth

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

License

MIT