Connect the OpenWork MCP Gateway
Server URL: https://api.openworklabs.com/mcp/agent
Transport: Streamable HTTP. Auth: OAuth (PKCE, dynamic client registration); the client opens a browser for sign-in. No API key is needed.
The user needs an OpenWork Cloud account. If they don't have one, send them to https://app.openworklabs.com?mode=sign-up first.
1. Add the server
Use the command for the client you are running in. If an openwork entry already exists, don't add a duplicate; sign in with the existing one.
Claude Code:
claude mcp add --transport http openwork https://api.openworklabs.com/mcp/agent
# add `-s user` to make it available in every project
Codex:
codex mcp add openwork --url https://api.openworklabs.com/mcp/agent
codex mcp login openwork
Gemini CLI:
gemini mcp add --transport http openwork https://api.openworklabs.com/mcp/agent
OpenCode:
opencode mcp add openwork --url https://api.openworklabs.com/mcp/agent
opencode mcp auth openwork
Cursor, VS Code, Claude Desktop, ChatGPT, Windsurf, Zed: add https://api.openworklabs.com/mcp/agent as a remote MCP server. Per-client steps: https://openworklabs.com/docs/start-here/connect-openwork-mcp
2. Sign in
- Claude Code: run
/mcp, select openwork, and authenticate.
- Codex:
codex mcp login openwork opens the browser.
- Gemini CLI: run
/mcp auth openwork.
- OpenCode:
opencode mcp auth openwork opens the browser.
The user signs in and picks their organization. The organization is pinned to the token; to switch, log out of the openwork server and sign in again.
3. Verify
claude mcp list (or the client's equivalent) shows openwork.
- Restart the agent session so the new tools load.
- The agent has the
search_capabilities and execute_capability tools.
- Ask: "Which OpenWork organization am I connected to?"
Don't claim the connection works until step 3 passes.
If it fails