Use Hutch from
OpenCode.
Self-hosted and MCP-native. Hutch fits right in.
OpenCode runs on whatever model you point it at, with MCP servers as first-class extensions. Adding Hutch gives every agent session the same durable scratchpad, no matter which model you're testing today.
Configure once in opencode.json, authenticate with OAuth, and Hutch shows up alongside your other tools.
Install
Fastest: paste this into OpenCode and it sets itself up. You approve the sign-in in your browser.
Connect Hutch (hutchdb.com) to OpenCode as an MCP server.
- URL: https://app.hutchdb.com/api/mcp
- Transport: remote streamable HTTP
- Auth: OAuth (no API key). I'll approve in the browser.
How to do it in OpenCode:
- In ~/.config/opencode/opencode.json, add under "mcp": "hutch": {"type": "remote", "url": "https://app.hutchdb.com/api/mcp"}
- Then run opencode mcp auth hutch.
1. Add the server for my user account, not just this project, so it works everywhere.
2. Start the OAuth login, or tell me exactly what to click if you can't start it yourself.
3. Tell me if I need to restart or reload you. Then call hutch_list_collections to confirm it works.Or set it up by hand:
01Step 1. Configure
Add this to opencode.json (project root or ~/.config/opencode/opencode.json):
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"hutch": {
"type": "remote",
"url": "https://app.hutchdb.com/api/mcp"
}
}
}02Step 2. Authenticate
Run:
opencode mcp auth hutchOptional: OpenCode also prompts on first use. Either way, sign in through the browser and approve.
03Step 3. Try it
In an OpenCode session:
- >"Store this article in my Hutch reading-list collection."
- >"Save the bugs we just discussed to a "tickets" collection in Hutch."
- >"What collections do I have in Hutch?"
- >"Find my notes about caching in Hutch."