Give other tools this project's knowledge #
maple-harness mcp serve lets any tool that speaks MCP (Claude Code, OpenCode, another Maple Harness) read
this project's notes and code map, the same ones the agent uses.
Build the index once from the project directory:
maple-harness graph reindex
Then connect a tool. A client normally launches the server itself.
In plain words #
- What it is. Other tools (Claude Code, OpenCode, another Maple) can read this project's memory notes and code map, the ones Maple builds as it works.
- Why you want it. Each tool starts already knowing your project's structure, instead of reading it again.
- What to do.
maple-harness graph reindexonce in the project, then add the server to your tool with the line below. There is no setup page step.
Claude Code #
claude mcp add maple-knowledge -- maple-harness mcp serve
or in the project's .mcp.json:
{
"mcpServers": {
"maple-knowledge": {
"command": "maple-harness",
"args": ["mcp", "serve"]
}
}
}
Add "--read-only" to the arguments to withhold the tools that write notes.
OpenCode #
In opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"maple-knowledge": {
"type": "local",
"command": ["maple-harness", "mcp", "serve"],
"enabled": true
}
}
}
Another Maple Harness #
In config.yaml:
harness:
mcp_servers:
- name: knowledge
command: maple-harness
args: ["mcp", "serve", "--project", "/path/to/other/project"]
Using MCP servers from the agent #
The agent can use MCP servers too, from the harness.mcp_servers list or a project's .mcp.json. Their
tools ask for approval like any other tool. A server that runs as a program on your machine runs with your
permissions, so add only servers you trust. A server reached over the network needs https unless it is on
this machine.
A project's own .mcp.json is not something you configured yourself, so the first time one is found for a
project you have not seen before, Maple Harness asks before starting the server it names (or, without a
terminal to ask on, skips it and says so). Once approved, it starts normally; editing the file afterwards
asks again. harness.mcp_servers in your own config.yaml is unaffected — it always runs. See
maple-harness trust --help.
The project is the directory the server is launched in, or --project DIR.
Related: the settings for the MCP servers the agent uses are in Harness settings; for scripts and editor plugins that drive a whole session, see Drive it from another program.