dsh-recued
Connects DeepSeek Harness (dsh) to your own
Recued server.
Recued is a server you run on a computer you control. It keeps your notes, tasks, mail, calendar
and the things you own, and it stands between your data and any AI: it checks every request
against what you granted, asks you before a change, and keeps a record of what was done.
This plugin adds one row of DeepSeek Harness's own MCP client (@deepseek-ai/dsh-mcp-client),
pointed at your Recued server. It ships no code of its own; the whole plugin is
cordis.patch.yml.
What you need
- DeepSeek Harness 0.2 (tested with 0.2.1-rc.2), with
pnpm on your PATH for dsh plugin.
- A Recued server: install it on a computer you
control.
- A contract for DeepSeek Harness. In the Recued web app, open Contracts, make a contract, choose
the tools DeepSeek Harness may use, and copy the key Recued shows.
Install
dsh plugin --profile web add github:recued/dsh-recued
That installs it into the Web UI's profile. For a headless run, use --profile headless; for
another profile, its name.
Then put the contract's key in ~/.dsh/.env (or $DSH_HOME/.env if you set DSH_HOME):
RECUED_MCP_TOKEN=<the contract's key>
If Recued runs on another computer, add the address the contract's Connect tab shows:
RECUED_MCP_URL=https://<your server>/mcp
Without RECUED_MCP_URL, the plugin connects to http://127.0.0.1:7717/mcp, the Recued server on
this computer. Without RECUED_MCP_TOKEN, the plugin stays off.
Restart DeepSeek Harness (dsh web). Recued's tools appear as mcp__recued__<tool>; DeepSeek
Harness may add a short suffix to a name, as in mcp__recued__work_search_71e96de3b41a. To check,
ask: "Which notes do I have in Recued?"
How it works
- The tools you see are the ones the contract grants. To give DeepSeek Harness another tool,
change the contract in the Recued web app.
- Reading runs at once.
- A change waits for you. Recued answers
awaiting_approval and tells the agent to have you
approve it in the Recued app, from the bell at the top of the page. When you have answered, tell
the agent, and it can ask Recued for the result.
- DeepSeek Harness does not ask before it calls a Recued tool. What a tool may do is decided in
Recued, by the contract and your approvals.
Privacy
Your data stays on your Recued server. The model sees only what a tool returns, and Recued
returns only what the contract grants. The key stays in your .env file; it is not written into
the plugin or your profile.
Remove
dsh plugin --profile web remove dsh-recued
License
MIT
