Tuqo in OpenCode
OpenCode connects remote MCP servers with an mcp block in opencode.json (in the project root, or globally in ~/.config/opencode/opencode.json) and handles OAuth itself: opencode mcp auth opens the browser and you approve access to a Tuqo project. A tqk_ key in a header is the alternative for CI.
Open the config
opencode.json in the project root, or the global ~/.config/opencode/opencode.json.
Add the server
In the mcp block create a tuqo entry: type remote and the MCP address (example below). The entry name is how you refer to the server in commands.
Authorize
opencode mcp auth tuqo opens the browser: sign in to Tuqo, choose the project, the scope and the lifetime. The status is shown by opencode mcp list.
Deploy
Ask the agent to create a site and publish it: it calls create_site and deploy_files and returns the live link.
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"tuqo": {
"type": "remote",
"url": "https://mcp.tuqo.ru/mcp",
"enabled": true
}
}
}The Tuqo panel is in English, and the labels here are the ones it shows.
OpenCode + Tuqo: frequently asked
How do I connect with a key instead of OAuth? +
In the tuqo entry set oauth to false and add a headers object with Authorization: Bearer tqk_… Create the key in the panel at app.tuqo.dev → project → API keys; it is shown once.
Does the entry go in mcp or in mcp.servers? +
Straight into mcp: the server name is a key of the mcp object (mcp → tuqo → type and url). OpenCode has no separate servers level, a common mistake when a config is copied from VS Code.
How do I revoke access? +
opencode mcp logout tuqo deletes the tokens stored on the machine; the access itself is revoked in one click in the Tuqo panel → project → AI connections.
What is available, and aren't there too many tools? +
All 52 Tuqo tools: sites, deploy_files and deploy_site, domains, deploy rollbacks, gated access, form submissions. If the model's context is small, connect with read-only access and switch to full access for deploys.
Config changes were not picked up +
Restart opencode: the config is read when a session starts. The server list and auth status: opencode mcp list.