@dotzero.ai/auth-mcp

MCP server for centralized DotZero authentication.

Overview

This MCP server provides authentication tools for DotZero services. Use it to obtain JWT tokens that can be passed to other DotZero MCP servers.

Installation

npm install @dotzero.ai/auth-mcp

Tools

| Tool | Description | |------|-------------| | auth_login | Authenticate with email, password, and tenant_id | | auth_refresh | Refresh an expired token using a refresh token | | auth_status | Check authentication configuration status |

Usage

Quick Setup (Recommended)

npx @dotzero.ai/setup

Claude Code Integration (Manual)

claude mcp add -e USER_API_URL=https://user-api.dotzero.app \
  dotzero-auth -- npx -y @dotzero.ai/auth-mcp

Authentication Flow

1. Login: Call auth_login with email, password, and tenant_id
2. Use Token: Pass the returned token to other DotZero services
3. Refresh: When token expires, call auth_refresh with the refresh token
4. Re-login: If refresh fails, call auth_login again

Example

# Login
auth_login(
  email: "[email protected]",
  password: "password123",
  tenant_id: "your-tenant-id"
)

# Returns:
# - token: JWT token for API calls
# - refresh_token: Token for refreshing the session
# - user info (name, email)

# When token expires:
auth_refresh(
  refresh_token: "your-refresh-token",
  tenant_id: "your-tenant-id"
)

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | USER_API_URL | No | https://dotzerotech-user-api.dotzero.app | DotZero User API URL |

API Endpoint

This server uses the DotZero User API:

• Login: POST /v2/auth/login?tenantID={tenant_id}
• Refresh: POST /v2/auth/token?tenantID={tenant_id} (with grant_type: "refresh_token")

License

MIT