humwork

Humwork MCP Plugin

Connect AI agents with verified domain experts in real-time. When your AI agent needs human expertise — for debugging, architecture decisions, or unfamiliar domains — Humwork matches it with a specialist who diagnoses the problem and provides solutions, all within the agent's context.

Installation

Claude Code

Plugin

Inside Claude Code, run:

/plugin marketplace add humworkai/humwork-mcp

Then run /mcp, select humwork, click Re-authenticate, and sign in at humwork.ai. Auth lasts 30 days.

MCP

claude mcp add --transport http humwork https://api.humwork.ai/api/v1

Or add manually to your project's .mcp.json:

{
  "mcpServers": {
    "humwork": {
      "type": "http",
      "url": "https://api.humwork.ai/api/v1"
    }
  }
}

Authentication: Run /mcp, select humwork, click Re-authenticate, and sign in at humwork.ai. Auth lasts 30 days.

---

Claude.ai (Web)

1. Go to claude.ai/customize/connectors
2. Click the + button to add a custom connector
3. Fill in:
   • Name: Humwork
   • Remote MCP server URL: https://api.humwork.ai/api/v1
4. Click Add — a browser window will open to authenticate with your Humwork account
5. Once connected, set tool permissions to Always allow or Needs approval as preferred

All 6 tools will be available: consult_expert, send_chat_message, get_chat_messages, extend_session, close_chat, and rate_chat.

---

Cursor

Add to your project's .cursor/mcp.json (or global ~/.cursor/mcp.json):

{
  "mcpServers": {
    "humwork": {
      "url": "https://api.humwork.ai/api/v1",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Or: Settings (Cmd+Shift+J) → MCP → Add new MCP Server → paste the config above.

Get your API key from your Humwork dashboard.

---

OpenAI Codex CLI

Requires Node.js 18+ (the bridge runs via npx). Check with node --version, install with brew install node if needed.

Add to ~/.codex/config.toml (or .codex/config.toml in your project):

[mcp_servers.humwork]
command = "npx"
args = [
  "-y",
  "mcp-remote@latest",
  "https://api.humwork.ai/api/v1",
  "--header",
  "X-API-Key:${HUMWORK_API_KEY}"
]

[mcp_servers.humwork.env]
HUMWORK_API_KEY = "YOUR_API_KEY"

Get your API key from your Humwork dashboard.

---

ChatGPT

Requires ChatGPT Plus, Pro, Business, or Enterprise — custom apps are not available on the free tier.

1. Go to Settings → Apps → Advanced and toggle Developer mode on. Accept the "Elevated Risk" warning.
2. Back on the Apps page, click Create app (top right).
3. Fill in:
   • Name: Humwork
   • MCP Server URL: https://api.humwork.ai/api/v1
   • Authentication: OAuth
   • Check "I understand and want to continue" and click Create.
4. A browser window will open — sign in with your Humwork account to authorize.

---

Windsurf

Add the MCP server in Windsurf settings:

{
  "mcpServers": {
    "humwork": {
      "url": "https://api.humwork.ai/api/v1",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Or: Settings → MCP / Plugins → Add MCP Server → paste the config above.

Get your API key from your Humwork dashboard.

---

Lovable

1. Open Settings → Connectors → Personal connectors
2. Click New MCP server
3. Name: humwork, Server URL: https://api.humwork.ai/api/v1
4. Authenticate with your Humwork account when prompted

---

OpenClaw

Requires OpenClaw 2026.4+ and Node.js 22+. Install with npm install -g openclaw@latest if needed.

1. Add Humwork as an MCP server:

openclaw mcp set humwork '{"url":"https://api.humwork.ai/api/v1","transport":"streamable-http","headers":{"X-API-Key":"YOUR_API_KEY"}}'

2. Restart the gateway to pick up the config:

openclaw gateway stop && openclaw gateway

3. Verify and open the dashboard:

openclaw mcp list
openclaw dashboard

Get your API key from your Humwork dashboard.

Note: OpenClaw requires a model provider API key configured separately. Run openclaw models auth paste-token --provider anthropic to add your Anthropic key.

Available Tools