Skip to main content
Use this guide only when you need a custom or local MCP server that is not available through OpenWork Connect. For Gmail, Google Calendar, Google Drive, Slack, Notion, Linear, and other managed services, follow Connect your services. Connecting a custom MCP server with OpenWork takes four clicks.
  • Inside your workspace, click in Extensions > Advanced Settings > Add MCP server
Extensions page with Advanced Settings link
You can add the MCP server to this workspace or to your global OpenCode configuration for all workspaces.
Add MCP Server dialog with name, URL, and OAuth toggleIndicate whether the server requires OAuth.
This setup is intended for servers that support dynamic OAuth client registration.
OAuth approval page for MCP server
Complete the provider’s OAuth approval flow in your browser. It should redirect back to OpenWork. If a custom MCP needs behavior OpenWork does not support, open an issue.

​
Troubleshooting

Some MCP servers do not support dynamic client registration. If the server gives you a pre-registered OAuth client ID and client secret, add it through Add Custom App > Advanced OAuth. For an advanced local Slack setup, follow Connect Slack as a custom MCP.
Error when MCP server does not support dynamic client registration